Складайте HTTP-запит крок за кроком — змінні шляху на кшталт
{userId}, параметри запиту, заголовки, тіла JSON / форми та автентифікацію, — і генеруйте готовий до запуску код для
cURL,
Node.js fetch,
Python requests або
PowerShell. Цей інструмент призначений для
проєктування і генерації; щоб справді надіслати запит і переглянути живу відповідь, передайте запит кнопкою
Тестовий запит → (відкриває
Клієнт / тестувальник REST API), або перетворіть вставлену команду cURL за допомогою
Конвертера команд cURL.
Усе складається локально у вашому браузері. Жоден запит ніколи не надсилається з цієї сторінки.
Поради: обгорніть сегмент URL у фігурні дужки (
{userId}), щоб керувати ним як параметром шляху; згенерований код оновлюється після кожної зміни. Запити GET/HEAD ігнорують тіло. Завантаження файлів у згенерованому коді використовують стиль
@file у cURL або заповнювачі в інших мовах — додавайте реальні файли у власному коді. Надсилання між джерелами описано в
Клієнті REST API (дотримуйтеся політики CORS сервера); щоб обернути наявну команду, використовуйте
Конвертер команд cURL.
Методи HTTP пояснено
Коли ви обираєте метод, згенерований код cURL / Node / Python / PowerShell змінюється відповідно. Ось що означає кожне дієслово для запиту, який ви складаєте:
GET — отримати представлення ресурсу. Він не має змінювати стан сервера, і згенерований запит зазвичай не має тіла. Використовуйте GET для читання, пошуку та endpoint-ів списків.
POST — надіслати дані для створення нового ресурсу або запуску дії. Тіло стає корисним навантаженням у згенерованому коді (--data-raw у cURL, аргумент body у Node/Python тощо). POST не ідемпотентний: надіслання двічі може створити два ресурси.
PUT — повністю замінити наявний ресурс. Надішліть повний об'єкт у тілі; пропущені поля можуть трактуватися як порожні. Згенерований код надсилає все тіло на точний URL.
PATCH — оновлює лише включені поля. Тіло містить частковий набір змін, тож згенеровані запити менші, ніж PUT, коли ви редагуєте одне-два значення.
DELETE — видалити ресурс за URL. Він ідемпотентний і зазвичай не має тіла, тож згенерований код є простим викликом delete лише із заголовками.
HEAD — запитати лише заголовки, без тіла відповіді. Згенерований код схожий на GET, але повертає метадані, як-от Content-Length, Last-Modified або Content-Type, економлячи трафік.
OPTIONS — дізнатися, що сервер дозволяє для URL, або змоделювати попередній запит CORS (preflight). Заголовки відповіді (наприклад, Access-Control-Allow-Methods) показують дозволені дієслова. OPTIONS зазвичай не має тіла запиту.
Легко переплутати: HEAD і GET — згенеровані запити схожі, але HEAD не повертає тіла. PUT і PATCH — PUT переписує весь ресурс; PATCH змінює лише надані вами поля.
