Параметри запитів

Кожен метод SDK приймає необовʼязковий обʼєкт RequiplyRequestOptions останнім аргументом:

interface RequiplyRequestOptions {
  signal?: AbortSignal;
  headers?: HeadersInit;
}

const abortController = new AbortController();

await requiply.pricing.quote(
  {
    startDate: '2026-07-01T10:00:00',
    endDate: '2026-07-03T18:00:00',
    items: [{ groupId: cameraKitId, quantity: 1 }],
  },
  {
    signal: abortController.signal,
    headers: {
      'X-Request-Source': 'nightly-sync',
    },
  },
);

Заголовки для всього клієнта

Задайте заголовки для кожного запиту під час створення клієнта:

const requiply = new RequiplyClient({
  apiKey: process.env.REQUIPLY_SECRET_KEY!,
  headers: { 'X-Integration-Name': 'example-backend' },
});

Заголовки методу перевизначають однойменні заголовки клієнта. Після обʼєднання власних заголовків SDK завжди задає Accept, Authorization, а для запитів із тілом також Content-Type.

Повторні спроби

API не усуває дублікати запитів, а у версії 0.2.0 прибрано параметр idempotencyKey, який попередні версії надсилали без жодного ефекту. Читання та розрахунки ціни можна безпечно повторювати. Перш ніж повторити bookings.create() чи sales.create() після тайм-ауту чи мережевої помилки, перевірте, чи пройшла перша спроба, наприклад через bookings.list({ createdFrom }) або sales.list({ soldFrom }). Інакше можна створити друге бронювання чи продаж.