API za web-studije i blagajne
Održavate stranice ili blagajne za ugostitelje i obrtnike? Preko API-ja vaš sustav šalje stavke i cijene, a Dvije cijene vode cijenu na 10.9.2026., povijest cijena, objavu cjenika u CSV ili XML formatu i PDF jelovnika za ispis.
Ključ
- Račun s planom Plus (za klijenta ili vlastiti) → Račun → API ključevi → Izradi ključ. Ključ se prikazuje samo jednom.
- Šaljite ga u zaglavlju
Authorization: Bearer dc_…(iliX-API-Key: dc_…). - Ključ vrijedi samo za rute u tablici ispod; račun, plaćanje i ključevi ostaju samo u kabinetu.
Ograničenja: 60 poziva u minuti i 1200 na sat po ključu, najviše 5 ključeva po računu. Svaki poziv bilježimo (ključ, vrijeme, ruta) 90 dana. Vrijede ista pravila kao u kabinetu: npr. promjena već zapisane sidrene cijene traži razlog.
Rute
| Metoda | Adresa | Što radi |
|---|---|---|
GET | /api/v1/locations | Objekti računa (id, adresa, oznaka, format cjenika) |
GET | /api/v1/locations/{id}/items | Stavke objekta s cijenom i cijenom na 10.9.2026. |
POST | /api/v1/locations/{id}/items | Nova stavka (naziv, cijena, sidrena cijena…) |
PATCH | /api/v1/items/{id} | Izmjena naziva, kategorije, opisa… |
PUT | /api/v1/items/{id}/price | Nova cijena (povijest cijena i 30-dnevni minimum vode se sami) |
PUT | /api/v1/items/{id}/anchor | Sidrena cijena; nakon prvog zapisa uz obavezan razlog |
DELETE | /api/v1/items/{id} | Uklanjanje stavke iz ponude |
POST | /api/v1/locations/{id}/import | Uvoz tablice (CSV/XLSX/XML), s pregledom ili potvrdom (commit=true) |
GET | /api/v1/locations/{id}/issues | Što još nedostaje za ispravan cjenik |
POST | /api/v1/locations/{id}/price-lists | Izradi i objavi novu verziju cjenika |
GET | /api/v1/locations/{id}/price-lists | Popis verzija |
GET | /api/v1/locations/{id}/price-lists/latest | Zadnja objavljena datoteka cjenika (?type=service|product) |
GET | /api/v1/price-lists/{id}/download | Datoteka određene verzije |
GET | /api/v1/locations/{id}/menu | PDF jelovnika / cjenika za ispis |
GET | /api/v1/locations/{id}/export | Izvoz stavki u tablicu |
Točan opis polja: OpenAPI (JSON), otvara se u Swagger Editoru, Postmanu ili Insomniji.
Primjeri
# objekti
curl -H "Authorization: Bearer $KEY" https://dvijecijene.hr/api/v1/locations
# nova stavka
curl -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
-d '{"name":"Espresso","price":"2,00","anchor_price":"1,80"}' \
https://dvijecijene.hr/api/v1/locations/12/items
# nova cijena
curl -X PUT -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
-d '{"price":"2,20"}' https://dvijecijene.hr/api/v1/items/345/price
# objava i zadnja datoteka cjenika za web-stranicu
curl -X POST -H "Authorization: Bearer $KEY" https://dvijecijene.hr/api/v1/locations/12/price-lists
curl -H "Authorization: Bearer $KEY" -o cjenik.csv \
https://dvijecijene.hr/api/v1/locations/12/price-lists/latestWhite label
Na planu Plus jelovnik i cjenik nemaju naš potpis, pa ih možete predati klijentu pod svojim imenom. Za veći broj klijenata (veleprodajna cijena, jedan račun za sve) javite nam se.
In English
Public REST API for web studios and POS systems. Create a key in the dashboard (Plus plan) and send it as Authorization: Bearer dc_…. The routes above manage items with both prices, publish the CSV/XML price list and return the printable PDF menu. Limits: 60 calls per minute, 1200 per hour per key. Schema: OpenAPI JSON.