Endpointy API
Lista dostepnych endpointow i przykladowe zapytania.
Ostatnia aktualizacja: 2026-04-01
Bazowy URL
Wszystkie endpointy API sa dostepne pod adresem: https://app.bakepilot.pl/api/v1/. Odpowiedzi sa w formacie JSON. Kodowanie: UTF-8. Wszystkie daty w formacie ISO 8601.
- Bazowy URL: https://app.bakepilot.pl/api/v1/
- Format odpowiedzi: JSON
- Kodowanie: UTF-8
- Daty: ISO 8601 (np. 2026-04-07T10:30:00Z)
Zamowienia
Endpointy zamowien pozwalaja pobierac liste zamowien, szczegoly, tworzyc nowe i aktualizowac istniejace. GET /orders -- lista zamowien z paginacja. GET /orders/:id -- szczegoly zamowienia. POST /orders -- nowe zamowienie. PATCH /orders/:id -- aktualizacja.
- GET /orders -- lista zamowien (paginacja, filtrowanie)
- GET /orders/:id -- szczegoly zamowienia
- POST /orders -- utworzenie zamowienia
- PATCH /orders/:id -- aktualizacja (np. zmiana statusu)
- DELETE /orders/:id -- anulowanie zamowienia
Klienci
Endpointy klientow: pobieranie listy, szczegolów, tworzenie i aktualizacja. GET /customers -- lista z wyszukiwaniem. POST /customers -- nowy klient. PATCH /customers/:id -- aktualizacja danych.
- GET /customers -- lista klientow
- GET /customers/:id -- profil klienta z historia
- POST /customers -- dodanie klienta
- PATCH /customers/:id -- aktualizacja danych
Produkty i faktury
Analogiczne endpointy dla produktow (/products) i faktur (/invoices). Produkty: lista, szczegoly, CRUD. Faktury: lista, szczegoly, tworzenie, wysylka do KSeF.
- GET/POST/PATCH /products -- zarzadzanie produktami
- GET/POST /invoices -- zarzadzanie fakturami
- POST /invoices/:id/send-ksef -- wysylka do KSeF
- GET /invoices/:id/pdf -- pobranie PDF
Obsluga bledow
API zwraca standardowe kody HTTP: 200 (sukces), 201 (utworzono), 400 (bledne dane), 401 (brak autoryzacji), 403 (brak uprawnien), 404 (nie znaleziono), 429 (limit zapytan). Kazdy blad zawiera pole 'error' z opisem po angielsku.
- 200 OK -- zapytanie udane
- 201 Created -- zasob utworzony
- 400 Bad Request -- bledne dane wejsciowe
- 401 Unauthorized -- brak lub bledny klucz API
- 404 Not Found -- zasob nie istnieje
- 429 Too Many Requests -- przekroczono limit