Exemple JavaScript, Python și Postman
Descarcă exemplele din secțiunea Resurse. Rulează-le pe serverul tău, cu MEREU_API_URL=https://mereu.md/api/v1 și cheia în MEREU_API_KEY.
| Fișier | Rol |
|---|---|
| mereu-client.mjs / mereu-client.py | Autentificare, cereri și codificarea parametrilor GET. |
| crm-sync.mjs / crm-sync.py | O pagină de export sau modificări, cu un cursor salvat durabil. |
| pos-checkout.mjs | Rezervare, confirmarea vânzării, import și retur. |
| mereu-postman.json | Cereri manuale cu referințe, UUID-uri și sume de completat. |
Pentru importuri Python, redenumește modulele în mereu_client.py și crm_sync.py. În numele modulelor Python nu se folosesc cratime.
- CRM: citește starea salvată și apelează
syncMereuPage(api, resource, state, commitPage)sausync_mereu_page(api.request, resource, state, commit_page). state=null/Noneîncepe exportul. Funcția procesează O SINGURĂ pagină și returneazăphaseșicursor.- În callback, resetează setul intermediar la
reset=true, adaugă rândurile neșterse și înlocuiește setul activ numai lacomplete=true. În modul changes, aplică inserările/actualizările/ștergerile. - Salvează cursorul împreună cu datele, într-o singură tranzacție. Lasă erorile de salvare să se propage. Planifică pagina următoare în coada ta de lucrări, în limita de cereri.
- POS:
prepareCheckouttrimite doar preview, rezervare și payment-started, prin callbackul tău durabilpersist. - Furnizează UUID-urile din comanda salvată. Începe plata în sistemul tău numai după succesul funcției și salvarea jurnalului.
- După verificarea plății, apelează
commitVerifiedPayment. Pentru importuri achitate foloseșterecordVerifiedPurchase; pentru retururi verificate,recordVerifiedReturn. - Un eșec al jurnalului după răspuns poate însemna că operația s-a aplicat deja. Recuperează cererea salvată și verifică starea înainte să o repeți.
În Postman completează variabilele goale și sumele numerice întregi. La commit, copiază expected_paid_total din ofertă și revizia din payment-started. La retur, folosește alocarea eligibilă inițială și banii real restituiți.