SDK TypeScript
Szybki start
Wykonaj pierwsze żądania z serwera i ze sklepu internetowego za pomocą @requiply/api-sdk.
Przykład dla serwera
Klucza tajnego używaj tylko w zaufanym środowisku serwerowym.
import { RequiplyClient } from '@requiply/api-sdk';
const requiply = new RequiplyClient({
apiKey: process.env.REQUIPLY_SECRET_KEY!,
});
const { bookings, nextCursor } = await requiply.bookings.list({
dateFrom: '2026-07-01',
dateTo: '2026-07-31',
limit: 25,
});
console.log(bookings, nextCursor);
Przykład dla sklepu internetowego
W publicznych wywołaniach ze sklepu internetowego używaj klucza publicznego o ograniczonym zakresie.
import { RequiplyClient } from '@requiply/api-sdk';
const requiply = new RequiplyClient({
apiKey: 'rq_pk_live_...',
});
const inventory = await requiply.inventory.list({
startDate: '2026-07-01T10:00:00',
endDate: '2026-07-03T18:00:00',
});
const firstItem = inventory.items[0];
if (!firstItem) throw new Error('No inventory is available');
const quote = await requiply.pricing.quote({
startDate: '2026-07-01T10:00:00',
endDate: '2026-07-03T18:00:00',
items: [{ groupId: firstItem.id, quantity: 1 }],
});
const request = await requiply.bookings.create({
startDate: '2026-07-01T10:00:00',
endDate: '2026-07-03T18:00:00',
items: [{ groupId: firstItem.id, quantity: 1 }],
deliveryType: 'pickup',
asRequest: true,
client: { email: 'customer@example.com' },
});
if (request.success) {
console.log(quote.total, request.reservationOrgId);
} else {
console.log('Not accepted:', request.message);
}
Do każdej daty rezerwacji dołączaj godzinę: sama data jest odczytywana jako północ i zwykle wypada poza godzinami pracy. Rezerwacja, której organizacja nie może przyjąć, kończy się wynikiem success: false zamiast zgłoszenia wyjątku.
Z kluczem publicznym
bookings.create() musi używać asRequest: true.