HTTP та REST

Найпоширеніший тип запиту: усе, що спілкується через HTTP, починаючи з API REST.

Клацніть правою кнопкою в дереві ▸ Додати ▸ Запит HTTP.

Методи

GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS і QUERY.

URL

URL приймає {{variables}} будь-де — у схемі, хості, порту, шляху, рядку запиту. Обчислене значення показується під полем.

URL доповнюють три списки:

• параметри запиту (?ключ=значення);
• параметри шляху, які підставляються замість іменованих сегментів шляху;
• заголовки.

Кожен рядок має прапорець увімкнення, тип значення та опис.

Тіло

Чотири родини:

Тип	Призначення
Текст	JSON, XML, звичайний текст — із підсвічуванням синтаксису та переформатуванням
Файл	Надсилає вміст файлу з диска
Форма (multipart/form-data)	Іменовані поля, зокрема файли
x-www-form-urlencoded	Іменовані поля, закодовані в тілі

Налаштування

• Час очікування: у мілісекундах, властивий саме цьому запиту; якщо його не задано, застосовується глобальне значення.
• Слідувати за перенаправленнями: типово увімкнено. Вимкніть, щоб побачити сам 3xx і його заголовок Location.

Відповідь

Статус, час, розмір, заголовки й тіло, показане відповідно до свого типу вмісту: згортний переглядач JSON, XML із відступами, попередній перегляд зображення, звичайний текст. Вкладка історії дає доступ до попередніх виконань.

Автентифікація

Приєднайте до запиту маршрут автентифікації, щоб заголовки додавалися автоматично, а токен поновлювався сам. Див. Автентифікація.

Режим сервера

Restorm також може розмістити сервер HTTP, щоб перевірити, як клієнт його споживає, — зазвичай це код вашого застосунку, який ви на час спроби спрямовуєте на localhost.

Додайте сервер через Додати ▸ Сервер HTTP: він слухає за адресою localhost:<порт><шлях> для пари «метод + шлях» і відповідає статусом, заголовками й тілом, які ви йому налаштували. Інші протоколи розміщуються так само — див. Режим сервера та Імітація API HTTP.

Фрагменти коду

У вкладці Code Snippets пропонується двадцять чотири мови й бібліотеки: cURL, JavaScript (Fetch, Axios), TypeScript, Python (Requests, http.client, aiohttp), нативний Node.js, Go, Rust (reqwest), Java (HttpClient, OkHttp), C# (HttpClient), PHP (cURL, Guzzle), Ruby (Net::HTTP, Faraday), Swift (URLSession), Kotlin (OkHttp), Dart, R (httr), PowerShell, Elixir (HTTPoison), Clojure (clj-http).

Імпортувати замість вводити вручну

У вас є специфікація OpenAPI, колекція Postman, файл HAR чи проста команда curl? Файл ▸ Імпортувати відтворить дерево за вас. Див. Імпорт і експорт.