Dezvoltatori / Developers

ROPE API-first pentru marketplace, dispatch si suport.

Pagina aceasta centralizeaza suprafata publica pentru integrare: OpenAPI, endpointuri MVP, roluri demo si conventii pentru clientii web sau mobile.

English: ROPE exposes a shared API contract for marketplace, dispatch, support, and portal clients. Start with OpenAPI and the public demo roles.

OpenAPI Demo roles

API basehttp://localhost:4000/api/v1Demo role headerx-rope-role: merchant_ownerDemo user headerx-rope-user-id: demo-user

Contracte

Ce poti integra acum

MVP-ul are rute concrete pentru lead capture, status, produse, checkout, comenzi si suport. Restul modulelor pot fi detectate prin capability routes.

OpenAPI

Contractul public este expus de backend la `/api/v1/openapi.json` pentru generare de clienti si review.

Role-aware API

Endpointurile protejate folosesc roluri ROPE precum customer, merchant_owner, courier, fleet_owner, support_agent si super_admin.

Capability discovery

Modulele MVP si cele stubbed expun `_capabilities`, astfel incat clientii pot negocia ce este activ.

Webhooks prepared

Suprafata de webhooks exista in modelul API, iar semnaturile trebuie validate inainte de provideri live.

MVP routes

Endpointuri publice si role-aware

GET /api/v1/healthGET /api/v1/statusGET /api/v1/openapi.jsonPOST /api/v1/leadsGET /api/v1/restaurantsGET /api/v1/productsPOST /api/v1/checkoutGET /api/v1/ordersPOST /api/v1/support/tickets

Demo login

Progressive enhancement pana la auth live.

Butoanele demo incearca `POST /api/v1/auth/demo-login` cu rolul selectat si `redirectTo`. Daca endpointul nu exista, linkul public ramane functional si adauga `demo=1` plus `role` in URL.

Demo RO Demo EN