Kod
Partner API v1, kontrakt sklepu na @delieta/shop-runtime i sygnał odświeżenia — od tego zacznij integrację.
Ten dział jest dla osoby, która łączy Delietę ze sklepem, kasą albo własnym backendem. Panel firmy opisują Funkcje.
Co tu jest
Każda z trzech stron odpowiada na jedno pytanie.
| Pytanie | Strona |
|---|---|
| Jak przeczytać menu, przyjąć zamówienie ze sklepu, utworzyć zamówienie z kasy, przyjąć rezerwację albo zapytanie o catering? | Partner API |
Jak zbudować sklep na @delieta/shop-runtime, który nie ujawni sekretu? | Kontrakt witryny |
| Czy Delieta powiadomi mój serwer, gdy status się zmieni? | Webhooki — nie, status sprawdzaj przez GET. Sklep dostaje tylko podpisany sygnał odświeżenia. |
Ten sam kontrakt w formie dla maszyn: GET /api/v1/openapi (bez klucza, z limitem na adres IP). Dokumentacja na tych stronach jest sprawdzana względem tego dokumentu.
Zasady, które wracają wszędzie
Klucz wskazuje firmę. Pola tenantSlug i companyId w body są ignorowane.
Pieniądze to całkowite grosze. 3200 to 32,00 zł. W v1 nie ma innej waluty niż PLN.
Błędy to RFC 9457 application/problem+json. Rozpoznawaj błąd po polu code, nigdy po title.
Klucz publikowalny ma dokładnie catalog:read i checkout:create: czyta menu i ustawienia sklepu, przyjmuje zamówienie ze sklepu, rezerwację i zapytanie. Klucz sekretny tworzy zamówienia z kasy i wycenia ETA. Oba klucze trzymasz po stronie serwera, nigdy w przeglądarce — kontrakt witryny pomaga tego dopilnować.
Pierwsza integracja krok po kroku: Dla programistów.