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!
MENIU API
INTEROGARE TIPURI CARDURI CREARE/ GENERARE CARD FIDELITATE ADAUGARE PUNCTE PE CARD / INREGISTRARE PLATA UTILIZARE/ CHELTUIRE PUNCTE DE PE CARD ANULARE COMANDA (unde NU s-au folosit puncte bonus) RETURNARE PUNCTE PE CARD (anulare/ retur comanda la care S-AU UTILIZAT puncte) INTEROGARE NUMAR PUNCTE SI VALOAREA IN LEI ACUMULATA PE CARD INTEROGARE PUNCTE DE LUCRU ACTUALIZARE DATE PERSONALE CLIENT SUSPENDARE/ ANULARE CARD DE FIDELIZARE EXEMPLU COD PHP METODA CURL POST
ACTUALIZARE/ SINCRONIZARE DATE PERSONALE CLIENT

Exemplu de request GET:

https://Subdomeniu.Domeniu_Dvs.ro/api/response.php?apikey=TEST-123121313132fsdfdsfdsf4546464645&username=emailul_dvs@Domeniu_Dvs.ro&action=actualizare_date&nr_card={NUMARUL CARDULUI}&first_name={NUME_CLIENT}&last_name={PRENUME_CLIENT}&phone={TELEFON}&city={CITY}&data_nasterii={DATA_NASTERII}&newsletter={DA sau NU}&tip_response={json sau xml}

Se pot actualiza doar partial datele clientului, exemplu actualizare first_name fara modificarea celorlalte date:

https://Subdomeniu.Domeniu_Dvs.ro/api/response.php?apikey=TEST-123121313132fsdfdsfdsf4546464645&username=emailul_dvs@Domeniu_Dvs.ro&action=actualizare_date&nr_card={NUMARUL CARDULUI}&first_name={NUME_CLIENT}&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 actualizare_date
nr_card DA Se introduce numarul de card al clientului
first_name NU Se introduce prenumele clientului
last_name NU Se introduce numele clientului
phone NU Se introduce numarul de telefon al clientului format 07xxxxxxxx
city NU Se introduce localitatea clientului
data_nasterii NU Se introduce data de nastere a clientului in format YYYY-MM-DD
newsletter NU Se introduce optiunea clientului privind primirea de newsletter (DA sau NU)
tip_response NU Se introduce xml in cazul in care doriti raspunsul in format XML sau json pentru format JSON
{
"status":"success",
"nr_card":XXXX_0000000000",
"first_name":"GEORGE",
"last_name":"POPESCU",
"Tel":"0700000000",
"localitate":"BUCURESTI",
"data_nasterii":"1990-10-25",
"newsletter":"DA"

}
<actualizare_date_response>

<status>success</status>
<nr_card>XXXX_0000000000</nr_card>
<first_name>GEORGE</first_name>
<last_name>POPESCU</last_name>
<Tel>0700000000</Tel>
<localitate>BUCURESTI</localitate>
<data_nasterii>1990-10-25</data_nasterii>
<newsletter>DA</newsletter>

</actualizare_date_response>
ACTUALIZARE/ SINCRONIZARE DATE PERSONALE CLIENT

Exemplu de request GET:

https://Subdomeniu.Domeniu_Dvs.ro/api/response.php?apikey=TEST-123121313132fsdfdsfdsf4546464645&username=emailul_dvs@Domeniu_Dvs.ro&action=actualizare_date&nr_card={NUMARUL CARDULUI}&first_name={NUME_CLIENT}&last_name={PRENUME_CLIENT}&phone={TELEFON}&city={CITY}&data_nasterii={DATA_NASTERII}&newsletter={DA sau NU}&tip_response={json sau xml}

Se pot actualiza doar partial datele clientului, exemplu actualizare first_name fara modificarea celorlalte date:

https://Subdomeniu.Domeniu_Dvs.ro/api/response.php?apikey=TEST-123121313132fsdfdsfdsf4546464645&username=emailul_dvs@Domeniu_Dvs.ro&action=actualizare_date&nr_card={NUMARUL CARDULUI}&first_name={NUME_CLIENT}&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 actualizare_date
nr_card DA Se introduce numarul de card al clientului
first_name NU Se introduce prenumele clientului
last_name NU Se introduce numele clientului
phone NU Se introduce numarul de telefon al clientului format 07xxxxxxxx
city NU Se introduce localitatea clientului
data_nasterii NU Se introduce data de nastere a clientului in format YYYY-MM-DD
newsletter NU Se introduce optiunea clientului privind primirea de newsletter (DA sau NU)
tip_response NU Se introduce xml in cazul in care doriti raspunsul in format XML sau json pentru format JSON
{
"status":"success",
"nr_card":XXXX_0000000000",
"first_name":"GEORGE",
"last_name":"POPESCU",
"Tel":"0700000000",
"localitate":"BUCURESTI",
"data_nasterii":"1990-10-25",
"newsletter":"DA"

}
<actualizare_date_response>

<status>success</status>
<nr_card>XXXX_0000000000</nr_card>
<first_name>GEORGE</first_name>
<last_name>POPESCU</last_name>
<Tel>0700000000</Tel>
<localitate>BUCURESTI</localitate>
<data_nasterii>1990-10-25</data_nasterii>
<newsletter>DA</newsletter>

</actualizare_date_response>