Клієнт / тестувальник REST API

Складайте і надсилайте HTTP-запити з параметрами запиту, заголовками, тілами JSON / form і автентифікацією Basic або Bearer, а потім переглядайте статус, час і відформатовані відповіді JSON. Імпортуйте наявну команду cURL або скопіюйте поточний запит назад як cURL. Хочете будувати багаторазові запити покроково? Використовуйте Конструктор HTTP-запитів. Дивіться також родину Інструментів API.
Усе працює локально у вашому браузері. Запити між джерелами підлягають політиці CORS цільового сервера — дивіться примітку нижче, якщо запит не вдається.
Вставте команду cURL
Параметри запиту
Заголовки
Тіло
Authorization
Параметри
Якщо заповнено, URL запиту додається до цього префікса. Корисно для серверів, що блокуються CORS.
200
Тіло Заголовки

                                                                

                                                                

                                                                    

                                                                

                                                            


                                                            

                                                            
Чому запит може не вдатися: браузери блокують читання між джерелами, якщо API не повертає Access-Control-Allow-Origin. Якщо ціль не дозволяє CORS, можна запустити власний CORS-проксі і вставити його URL у поле префікса проксі вище, або використати Конвертер cURL, щоб виконати запит із терміналу. Тіла запитів для GET/HEAD ігноруються; інструмент для WebSocket окремо на Тестувальнику WebSocket.


                                                            

                                                                Методи HTTP пояснено
                                                                
Метод, який ви обираєте, повідомляє серверу, що ви хочете зробити з URL. Ось що означає кожне з семи дієслів, які може надсилати цей інструмент:

                                                                
GET — Отримати ресурс: вебсторінку, зображення, список записів. “Дай мені те, що за цим URL.” Лише читання, безпечно повторювати; зазвичай не містить тіла запиту (тіло в GET, якщо є, ігнорується).

                                                                
POST — Надіслати нові дані на сервер, зазвичай щоб створити ресурс або запустити дію — надіслати форму, завантажити файл, почати завдання. Корисне навантаження передається в тілі запиту. POST не ідемпотентний: надіслання того самого POST двічі може створити два записи.

                                                                
PUT — Замінити весь ресурс за URL на надіслане. Тіло має містити повну нову версію ресурсу. PUT ідемпотентний: повторення того самого запиту має той самий ефект, що й одноразове надсилання.

                                                                
PATCH — Змінити лише частину ресурсу. Ви надсилаєте лише поля, які хочете оновити, напр. {"email": "new@example.com"}, а не весь запис. Обирайте PATCH, коли повний PUT змусив би повторно надсилати поля, яких ви не чіпаєте.

                                                                
DELETE — Видалити ресурс за URL. DELETE ідемпотентний: видалення того, що вже зникло, дає той самий результат (зазвичай 404) і нічого не робить вдруге.

                                                                
HEAD — Так само, як GET, але відповідь містить лише заголовки — тіло взагалі не надсилається. Використовуйте HEAD, щоб перевірити, чи існує URL, який розмір файлу (Content-Length), коли його востаннє змінювали (Last-Modified) або який тип (Content-Type), не завантажуючи весь вміст.

                                                                
OPTIONS — Запитати у сервера, які методи і опції дозволені для URL, або запустити попередню перевірку CORS. Заголовки відповіді, як-от Access-Control-Allow-Methods, перелічують дозволене. OPTIONS зазвичай не містить тіла; браузери часто надсилають його автоматично перед POST/PUT/PATCH/DELETE між джерелами.

                                                                
Легко переплутати: HEAD і GET — запит однаковий, але HEAD не повертає тіла. PUT і PATCH — PUT замінює весь ресурс; PATCH застосовує часткове оновлення лише надісланих полів.