GET чи POST для API-запусків
Використовуйте GET для швидких URL-запусків і POST для запитів із заголовками, cookie, кроками, мітками або налаштуванням зберігання.
На цій сторінці
Коли це корисно
- Використовуйте GET для швидкого URL-запуску у знімок, PDF, HTML або Markdown.
- Використовуйте POST для файлів cookie, заголовків, кроків, файлового виводу, зберігання або довших даних.
- Якщо чутливі значення все ж ідуть через URL, беріть вузький і короткоживучий API-ключ.
Коли достатньо GET і коли краще POST
API для знімків сторінок часто починається з URL у рядку запиту. GET добре працює для першої перевірки: цільова сторінка, формат результату, розмір екрана і повторне використання результату в одному посиланні.
POST краще підходить, коли запуск стає частиною автоматизації. Заголовки, файли cookie, HTML-вхід, Markdown-вихід, мітки, зберігання й багатокрокові сценарії читабельніші в тілі запиту. Чутливі значення також не потрапляють в історію браузера, журнали сервера чи спільні посилання.
Де метод запиту змінює шлях продукту
GET зручний для швидкого API-запуску. POST безпечніший, коли ту саму сторінку треба перевіряти знову, позначати мітками, надсилати у сховище, переглядати пізніше або прив'язувати до випуску.
RenderLog тримає обидва методи в одній історії запусків. Розробник може почати з одного API-виклику, а команда згодом перенесе ту саму ціль у ручний перегляд, перевірки сайту, еталони й сповіщення без переходу на інший продукт.
- CI-завдання можуть лишатися короткими для URL-запусків.
- Серверні сервіси можуть надсилати структуровані запити без кодування всіх параметрів в URL.
- Команда все одно отримує готові файли, журнали, мітки й історію перегляду після завершення API-виклику.