INFORMATII INTEGRARI API
RO | EN
Cardapp Cloud API este o interfata flexibila, compatibila cu cele mai des intalnite limbaje de programare. Aceasta interfata API permite integrarea platformei Cardapp Cloud cu alte aplicatii online.

Toate comunicatiile Cardapp Cloud API sunt criptate prin utilizarea protocolului HTTPS sau via SSL. Orice apelare nesecurizata este respinsa (nu este permis doar HTTP) in mod automat.

Facilitatile care pot fi accesate prin metodele API

Interogare tipuri de card;
Emiterea de noi carduri de fidelitate;
Adaugarea de puncte bonus si inregistrare plati;
Anularea sau returul unei comenzi;
Utilizare/ interogare/ cheltuire puncte de pe card;
Interogare numar de puncte acumulate pe card;
DATE DE CONECTARE API
Username
emailul_dvs@Domeniu_Dvs.ro

Parola API
TEST-123121313132fsdfdsfdsf4546464645

Link acces interogare platforma Cardapp cURL POST / GET
https://Subdomeniu.Domeniu_Dvs.ro/api/response.php

Interogarile se pot efectua folosind CURLOPT_POST (recomandat) sau GET.

ATENTIE! Introduceti corect datele dvs. API, in caz contrar, se va bloca automat accesul la aplicatia API dupa 3 interogari consecutive gresite!
INTEROGARE TIPURI CARDURI
Acesta va returna tipurile de card create pe contul dvs. si id-urile unice ale acestora (optional).
Se foloseste in cazul in care doriti sa creati un card de fidelitate de un anumit tip, de obicei diferit de cel DEFAULT precum PREMIUM, GOLD, VIP ETC., inainte de a folosi CREARE/ GENERARE CARD FIDELITATE NOU

Exemplu de request GET:

https://Subdomeniu.Domeniu_Dvs.ro/api/response.php?apikey=TEST-123121313132fsdfdsfdsf4546464645&username=emailul_dvs@Domeniu_Dvs.ro&action=tip_card&tip_response={json sau xml}

Nu folositi { }. Sunt doar pentru evidentiere. Corect: key=value Gresit: key={value}

Parametrii necesari

Nume Camp
obligatoriu
Descriere
apikey DA Parola API
username DA Adresa de Email cu care va conectati la Cardapp
action DA Se introduce tip_card
tip_response NU Se introduce xml in cazul in care doriti raspunsul in format XML sau json pentru format JSON
{
"status":"success",
     "tipuri_card":[
{
"id_grup":"GR_11111111",
"denumire":"PREMIUM",
"valoare_bonus":"1",
"procent_discount":5
},
{
"id_grup":"GR_22222222",
"denumire":"VIP",
"valoare_bonus":"1",
"procent_discount":10
}
     ]
}


DETALII PARAMETRII RESPONSE

- id_grup - Numarul de identificare unic al tipului de card
- denumire - Denumirea tipului de card
- valoare_bonus - Valoare in LEI a 1 punct bonus
- procent_discount - Procentul din vanzare care se acumuleaza pe cardul clientului sub forma de puncte bonus.
<tipuri_card_response>

<status>success</status>
<tipuri_card>
     <id_grup>GR_11111111</id_grup>
     <denumire>PREMIUM</denumire>
     <valoare_bonus>1</valoare_bonus>
     <procent_discount>5</procent_discount>
</tipuri_card>
<tipuri_card>
     <id_grup>GR_22222222</id_grup>
     <denumire>VIP</denumire>
     <valoare_bonus>1</valoare_bonus>
     <procent_discount>10</procent_discount>
</tipuri_card>

</tipuri_card_response>