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č

  1. Račun s planom Plus (za klijenta ili vlastiti) → Račun → API ključevi → Izradi ključ. Ključ se prikazuje samo jednom.
  2. Šaljite ga u zaglavlju Authorization: Bearer dc_… (ili X-API-Key: dc_…).
  3. 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

MetodaAdresaŠto radi
GET/api/v1/locationsObjekti računa (id, adresa, oznaka, format cjenika)
GET/api/v1/locations/{id}/itemsStavke objekta s cijenom i cijenom na 10.9.2026.
POST/api/v1/locations/{id}/itemsNova stavka (naziv, cijena, sidrena cijena…)
PATCH/api/v1/items/{id}Izmjena naziva, kategorije, opisa…
PUT/api/v1/items/{id}/priceNova cijena (povijest cijena i 30-dnevni minimum vode se sami)
PUT/api/v1/items/{id}/anchorSidrena cijena; nakon prvog zapisa uz obavezan razlog
DELETE/api/v1/items/{id}Uklanjanje stavke iz ponude
POST/api/v1/locations/{id}/importUvoz 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-listsIzradi i objavi novu verziju cjenika
GET/api/v1/locations/{id}/price-listsPopis verzija
GET/api/v1/locations/{id}/price-lists/latestZadnja objavljena datoteka cjenika (?type=service|product)
GET/api/v1/price-lists/{id}/downloadDatoteka određene verzije
GET/api/v1/locations/{id}/menuPDF jelovnika / cjenika za ispis
GET/api/v1/locations/{id}/exportIzvoz 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/latest

White 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.