API, webhooks și mediul de test

Pagina asta e pentru cine face integrarea: tu, o agenție sau un programator. Documentația completă, cu toate câmpurile și exemplele, este la /dezvoltatori.

Cheile API

Le creezi din Setări → Email, integrare și API, secțiunea Chei API:

• Creează cheie face o cheie reală, care începe cu ck_live_;
• Creează cheie de test face o cheie care începe cu ck_test_.

Cheia se arată o singură dată, imediat după creare. Copiaz-o atunci. Lângă fiecare cheie vezi când a fost folosită ultima dată. Cu Retrage o oprești; integrarea care o folosește nu mai poate trimite date.

Prin API trimiți contacte, produse, categorii, comenzi și evenimente, și le poți șterge. Cheia se pune în antetul Authorization: Bearer ck_live_…. O cheie poate face cel mult 600 de cereri pe minut.

Mediul de test

În Setări → Mediu de test ai două unelte, ca datele de probă să nu ajungă în contacte, comenzi sau rapoarte:

• Chei API de test (ck_test_): răspund exact ca cele reale, cu aceleași validări și aceleași erori, dar nu salvează și nu șterg nimic.
• Domenii de test pentru script: adaugi domeniul site-ului de test (de exemplu staging.magazinul-tau.ro). Evenimentele venite de acolo nu se salvează și nu pornesc automatizări. Poți avea cel mult 10 domenii de test.

Jos, la Ultimele cereri de test, vezi ultimele 100 de cereri din ultimele 24 de ore, cu erorile pe fiecare obiect.

Webhooks

Din Setări → Webhooks trimiți automat date către sistemele tale: CRM, ERP, Zapier sau Make. Alegi evenimentele:

• Abonat nou
• Dezabonare (inclusiv adresele curățate)
• Formular completat
• Campanie trimisă

La fiecare eveniment trimitem o cerere POST cu JSON la adresa ta. Dacă serverul nu răspunde, reîncercăm de cel mult 5 ori. Poți avea cel mult 10 webhook-uri pe magazin. Fiecare cerere este semnată (antetul X-Conekto-Signature, HMAC-SHA256), ca să verifici că vine de la noi. Cheia de semnare o vezi oricând cu Cheia.

Cu Trimite test trimiți o cerere de probă. La Ultimele livrări vezi istoricul pe 30 de zile. Un webhook care eșuează de 50 de ori la rând se dezactivează automat; îl pornești din nou cu Activează.

Cheile API și webhook-urile le gestionează doar administratorii magazinului, nu și agențiile partenere. Domeniile de test le adaugă administratorii.