v1.0.0 — Stabil

Cardora Public Partner API

Integrare pentru sisteme POS, livrare si comenzi online cu platforma de loialitate Cardora.

Start Rapid

  1. Obtineti o cheie API din panoul de administrare Cardora
  2. Consultati documentatia API pentru autentificare si utilizare
  3. Verificati specificatia OpenAPI pentru detalii complete despre endpoint-uri

Fisiere Documentatie

Endpoint-uri Disponibile

Metoda Endpoint Descriere
POST /customers/identify-from-card Identificare client din token cod QR card
POST /customers/upsert Creare sau actualizare client cu mapare ID extern
GET /customers/{externalCustomerId} Obtinere informatii client si solduri carduri dupa ID extern
GET /card-templates Listare toate sabloanele active de carduri de loialitate
GET /card-templates/{id} Obtinere detalii sablon card specific
POST /customers/{id}/issue-card Emitere card de loialitate pentru client
POST /orders Procesare comanda si acordare stamp-uri/puncte

Pentru documentatie completa, consultati referinta endpoint-uri sau documentatia API.

Caracteristici

🔒

Autentificare & Securitate

Autentificare cheie API prin header X-API-Key. Suport lista de permisiuni IP pentru control granular al accesului.

⚡

Limitare Rate

Limite de rate per cheie (implicit: 60 cereri/minut). Configurabil per cheie API cu raspunsuri 429 si header-uri retry-after.

🛠

Gestionare Erori

Raspunsuri JSON consistente, coduri de eroare citibile de masina si coduri de status HTTP adecvate.

📚

Documentatie Completa

Referinta API completa, specificatie OpenAPI 3.0, si exemple de cod in Python, JavaScript si PHP.

Inceperea

1. Obtineti o Cheie API

Conectati-va la panoul de administrare Cardora si navigati la Setari → Chei API pentru a crea o cheie API noua.

2. Testati Conexiunea

Folositi token-ul de test pentru a verifica cheia API fara a procesa date reale:

curl -X POST https://app.cardora.ro/api/public/v1/customers/identify-from-card \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"cardInstanceToken": "0_0_000000000_000000000000"}'

Acest token de test returneaza date de test hardcodate si nu acceseaza baza de date.

3. Consultati Documentatia

Vedeti documentatia API pentru exemple detaliate in Python, JavaScript si PHP.

Suport