📄 Заголовки та параметри

Налаштовуйте власні HTTP заголовки та URL параметри для синхронізації API.

Користувацькі заголовки

Додавайте заголовки до HTTP-запитів для автентифікації, типів вмісту чи інших вимог.

Headers Configuration Налаштування користувацьких HTTP заголовків

Поширені приклади заголовків

Назва заголовка Значення Призначення
Content-Type application/json Вказує JSON-вміст
Accept application/json Запитує JSON-відповідь
X-API-Key your-api-key Користувацька автентифікація
X-Request-ID unique-id Відстеження запиту

Додавання заголовків

  1. Перейдіть на вкладку Headers у вашій конфігурації
  2. Натисніть Add a line
  3. Вкажіть Key (назву заголовка)
  4. Введіть Value (значення заголовка)
  5. Збережіть конфігурацію

URL параметри

Налаштовуйте URL параметри для GET-запитів і рядків запиту.

Parameters Configuration Налаштування URL параметрів

Типи параметрів

  • Query Parameters: додаються до URL як ?key=value
  • Path Parameters: вбудовуються безпосередньо в шлях URL
  • Filter Parameters: використовуються для фільтрації даних

Поширені параметри

Параметр Приклад значення Опис
page 1 Номер сторінки пагінації
limit 100 Кількість записів на сторінку
sort name Поле сортування
order asc Напрям сортування
filter active=true Критерій фільтрації

Додавання параметрів

  1. Відкрийте вкладку Parameters
  2. Натисніть Add a line
  3. Заповніть поле Field (назва параметра)
  4. За потреби оберіть Domain Operator
  5. Вкажіть Value

Динамічні параметри

Використовуйте Python-скрипти для формування параметрів на льоту:

# Приклад: Додати параметр з міткою часу
import time
params['timestamp'] = str(int(time.time()))

# Приклад: Обмежити розмір сторінки
params['page_size'] = min(records_count, 100)

Найкращі практики

  1. Безпека: не передавайте чутливі дані через URL
  2. Кодування: кодуйте спеціальні символи
  3. Документація: фіксуйте обов'язкові заголовки та параметри
  4. Тестування: перевіряйте різні комбінації значень
  5. Валідація: перевіряйте параметри перед відправкою

Пов’язана документація