Перейти к содержимому
ГалоўнаяГайды і інструкцыіcURL і HTTP-статусы: як працаваць з API

cURL і HTTP-статусы: як працаваць з API

Час чытання: 1 хв

Як сабраць каманду cURL для тэставання API і разабрацца ў HTTP-кодах: што азначаюць 401, 403, 429 і 5xx і як выправіць памылкі інтэграцыі.

Тэставанне API — гэта пастаянныя запыты з рознымі загалоўкамі, целам і параметрамі, і ручная зборка каманды cURL у кансолі з'ядае час і правакуе памылкі друку. Гэтак жа лёгка заблытацца ў кодах адказу: 401, 403, 429 і 503 выглядаюць падобна, а азначаюць розныя рэчы.

Зборка каманды cURL

cURL Command Builder збірае гатовую каманду з метаду (GET, POST, PUT, DELETE), адраса, загалоўкаў і цела запыту: вы выбіраеце патрэбныя палі ў форме, сэрвіс фармуе каманду, якую застаецца ўставіць у тэрмінал. Гэта выключае памылкі ў двукоссях і сінтаксісе пры ручным наборы.

Коды стану

Даведнік HTTP-кодаў тлумачыць усе статусы ад 100 да 511: што азначае кожны код, калі ён з'яўляецца і як звычайна выпраўляецца. Асабліва важныя 4xx — памылкі кліента (напрыклад, 401 — не аўтарызаваны, 404 — рэсурс не знойдзены, 429 — перавышаны ліміт запытаў) і 5xx — памылкі сервера (500, 502, 503).

Тыповы сцэнарый

Інтэграцыя вярнула 401 → дэкадуеце JWT-токен, правяраеце тэрмін дзеяння, выпраўляеце загаловак Authorization у cURL Command Builder → каманда сабрана наноў і выканана ў кансолі. Калі прыйшоў 429 — адкрыйце Даведнік HTTP-кодаў і пераканайцеся, што трэба павялічыць інтэрвалы паміж запытамі.

Частыя памылкі

Важна: усе файлы апрацоўваюцца ў браўзеры і не адпраўляюцца на сервер — бяспечна для канфідэнцыйных малюнкаў.