Requiply
SDK TypeScript

Opcje żądań

Anuluj żądania i dodawaj nagłówki z metadanymi do wywołań SDK.

Każda metoda SDK przyjmuje jako ostatni argument opcjonalny obiekt 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',
    },
  },
);

Nagłówki dla całego klienta

Ustaw nagłówki dla każdego żądania podczas tworzenia klienta:

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

Nagłówki metody nadpisują nagłówki klienta o tej samej nazwie. Po scaleniu własnych nagłówków SDK zawsze ustawia Accept, Authorization oraz, w przypadku żądań z treścią, Content-Type.

Przeglądarki blokują żądania między różnymi źródłami z nagłówkami, na które API nie pozwala. Własne nagłówki dodawaj tylko w kodzie serwera.

Ponawianie żądań

API nie usuwa duplikatów żądań, a wersja 0.2.0 usunęła opcję idempotencyKey, którą wcześniejsze wersje wysyłały bez żadnego efektu. Odczyty i wyceny można bezpiecznie ponawiać. Zanim ponowisz bookings.create() lub sales.create() po przekroczeniu czasu albo błędzie sieci, sprawdź, czy pierwsza próba się powiodła, na przykład za pomocą bookings.list({ createdFrom }) lub sales.list({ soldFrom }), inaczej możesz utworzyć drugą rezerwację lub sprzedaż.

Copyright © 2026