REVO · Dezvoltatori

API pentru dezvoltatori

Conectează la REVO site-ul restaurantului, aplicația lui de comenzi, contabilitatea sau un tablou de bord. Citești meniul, locațiile, vânzările și stocurile și trimiți comenzi care sună pe POS, cu o cheie creată de restaurant, care vede doar datele lui.

Începe în 5 minute Referința interactivă
REST + JSONOpenAPI 3.1Chei pe restaurantFără date despre clienți
Prima cerere
# Ce vede cheia ta?
curl https://api.revoapp.ro/api/public/v1/me \
  -H "Authorization: Bearer rvo_live_…"

Ce poți face

Fiecare cheie primește doar accesul de care are nevoie. Restaurantul bifează ce vede cheia, iar cheia nu poate face nimic în afara bifelor.

Meniu și produse menu:read

Toate produsele locațiilor, cu prețul de la casă și prețurile pe canale (online, Glovo, Wolt), disponibilitatea (86), alergenii, variantele și extra. Pentru site, meniuri digitale sau alt sistem pe care vrei să-l ții la zi.

  • GET /products · /products/{id}
  • GET /categories · /allergens

Locații locations:read

Adresa, telefonul, programul și dacă locația primește acum comenzi online.

  • GET /locations · /locations/{id}

Vânzări sales:read

Comenzile plătite și totalurile pe zi și pe produs, după aceleași reguli ca Panoul de bord din REVO. Fără nume, telefoane sau e-mailuri ale clienților și fără observații.

  • GET /sales/daily · /sales/products
  • GET /sales/orders · /sales/orders/{id}

Stocuri stock:read

Ingredientele fiecărei locații, cu stocul de acum și minimul setat. Fără prețuri de achiziție.

  • GET /ingredients · /ingredients/{id}

Comenzi online orders:write

Meniul de comandă, comenzi din site-ul sau aplicația ta care sună pe POS și se acceptă dintr-o atingere, statusuri prin webhook, mod de test.

  • POST /orders · GET /orders/{id}
  • webhook: order.accepted … order.completed
Ghidul de comenzi

Sincronizare

Listele merg pe pagini cu cursor și primesc doar ce s-a schimbat de la ultima ta citire (updated_since). Ce s-a șters în REVO vine marcat ca șters, ca să-l ștergi și tu.

  • ?updated_since=2026-10-05T12:00:00Z
  • ?cursor=… · has_more

Cum obții o cheie

Cheile le creează restaurantul, din contul lui REVO. Dacă ești dezvoltatorul, cere-i proprietarului sau managerului să facă acești pași.

  1. Setări → Chei APIÎn REVO, pe calculator sau pe telefon, apasă „Creează o cheie” și dă-i un nume (de exemplu „Site” sau „Contabilitate”).
  2. Ce vede și undeBifează ce poate citi cheia (meniu, locații, vânzări, stocuri, comenzi online) și pentru ce locații: toate sau doar unele.
  3. Se afișează o singură dată„Copiază tot pentru dezvoltator” pune în clipboard adresa API, cheia și linkul spre documentație. Trimite-le pe un canal privat.
  4. Sub controlRestaurantul vede când a fost folosită cheia și cererile ei. O poate regenera (cea veche mai merge 24 de ore, dacă vrea), o poate opri sau șterge oricând.
REVO, Setări → Chei API pe calculator: trei chei (Site-ul restaurantului, Contabilitate, Aplicația de comenzi), fiecare cu ce poate vedea și cât e folosită, iar alături detaliile unei chei: acces, locații, utilizarea pe 14 zile și butoanele Regenerează, Dezactivează și Șterge. Setări → Chei API pe telefon: butonul Creează o cheie și cheile, una sub alta, fiecare cu ce poate vedea.
Setări → Chei API în REVO (date de exemplu).
Doar datele restaurantuluiO cheie aparține unui singur cont REVO și vede doar locațiile alese pentru ea.
Fără date personaleVânzările nu conțin numele, telefonul sau e-mailul clienților, datele de facturare sau observațiile.
Păstrată pe serverCheia stă pe serverul tău, nu în pagina web sau în aplicația din telefon. API-ul se apelează de pe server.

Documentație

Ghid de pornire

Prima cerere, citirea meniului, sincronizarea, vânzările pe zi, stocurile, erorile și limitele, cu exemple în curl, JavaScript, PHP și Python. În engleză.

Deschide ghidul

Referința interactivă

Toate endpoint-urile, parametrii, schemele și erorile. Încerci fiecare cerere direct din pagină, cu cheia ta.

Deschide referința

Comenzi online

Ghidul complet pentru o aplicație de comenzi: meniul, comanda, statusurile, webhook-urile semnate și modul de test.

Deschide ghidul

Specificația OpenAPI 3.1

Pentru Postman, Insomnia sau un generator de cod. Există și în format JSON: /developers/openapi.json.

Descarcă openapi.yaml

Noutăți în API

Ce s-a schimbat și când. Versiunea 1 doar adaugă: câmpuri, parametri și endpoint-uri noi, niciodată ceva care să-ți strice integrarea.

Vezi noutățile

Ai o întrebare?

Scrie-ne la contact@revoapp.ro cu ce construiești. Spune-ne și ce date îți lipsesc; v1 crește după cererile integratorilor.

Scrie-ne

Limite și reguli

120 de cereri pe minutpentru fiecare cheie și 600 pe minut pentru toate cheile unui restaurant. Peste limită primești 429 cu Retry-After.
Sume în RON, ca textSume cu două zecimale ("24.50"), ore în UTC și zile calendaristice în ora României.
Versiuni stabilev1 doar adaugă. O schimbare incompatibilă ar veni ca /v2, cu cel puțin 6 luni în care merg amândouă.