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!
CREARE/ GENERARE CARD FIDELITATE

Exemplu de request GET:

https://Subdomeniu.Domeniu_Dvs.ro/api/response.php?apikey=TEST-123121313132fsdfdsfdsf4546464645&username=emailul_dvs@Domeniu_Dvs.ro&action=creare&telefon={TELEFON_CLIENT}&email={EMAIL_CLIENT}&prenume={PRENUME_CLIENT}&nume={NUME_CLIENT}&data_nastere={DATA_NASTERE_CLIENT}&localitate={LOCALITATE}&referrer={REFERRER}&card_type_id={CARD TYPE ID}&store_id={STORE ID}&send_card={FARA, EMAIL sau SMS}&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 creare
telefon DA Telefonul clientului dvs (valid, 10 numere, format 07xxxxxxxx - RECOMANDAT).
Se poate introduce si alt tip de numar international dar SMS-ul NU se va trimite. Daca nu are telefon, introduceti 0
email NU Adresa de Email a clientului dvs (daca nu are, se genereaza automat,se poate lasa necompletat)
nume NU Numele clientului dvs. (se poate lasa necompletat)
prenume NU Prenumele clientului dvs. (se poate lasa necompletat)
data_nastere NU Data de nastere a clientului dvs. - Format yyyy-mm-dd (se poate lasa necompletat)
localitate NU Localitatea clientului (se poate lasa necompletat)
referrer NU Clientul care l-a recomandat (se poate lasa necompletat)
card_type_id NU Id-ul unic al tipului de card (se poate lasa necompletat pentru default)
store_id NU Id-ul unic al punctului de lucru/ magazinului (se poate lasa necompletat)
send_card NU Variante posibile:
SMS - sistemul Cardapp va trimite prin SMS cardul clientului;
EMAIL - sistemul va trimite prin EMAIL cardul clientului
FARA sau necompletat - NU se va trimite cardul clientului.
tip_response NU Se introduce xml in cazul in care doriti raspunsul in format XML sau json pentru format JSON
{
"status":"success",
"prenume":"PRENUME_CLIENT",
"nr_card":"TEST_0000005889",
"uniqueid":"ds4a645sda5dsa6d5465das4das54d6448789ddfggghfbnnnqw"

}
<creare_card_response>

<status>success</status>
<prenume>ION</prenume>
<nr_card>FIA_123456789</nr_card>
<uniqueid>ds4a645sda5dsa6d5465das4das54d6448789ddfggghfbnnnqw</nr_card>

</creare_card_response>


DETALII PARAMETRII RESPONSE

- prenume - Prenumele clientului
- nr_card - Numarul cardului generat de sistem
- uniqueid - Id-ul unic al clientului (optional)