Upotrijebite brend za razmjenu poruka koji pripada računu
Upotrijebite omogućen API račun putem protokola HTTPS s dopuštene izvorne IP adrese. Podržana je autentifikacija Basic i Bearer. ID brenda mora pripadati tom računu. Tokene pružatelja usluge, podatke o identitetu brenda i vraćena izvješća čuvajte kao povjerljive.
Upotrijebite postojeći rezultat pružatelja usluge
Upotrijebite PUT za povezivanje postojećeg rezultata provjere podržanog pružatelja usluge sa svojim brendom. Time se ne naručuje nova provjera. Ispravan ID transakcije pružatelja usluge i eventualni potvrdni token pribavite izravno od tog pružatelja te provjerite odnosi li se izvješće na isti poslovni subjekt.
AUTHPLUS ne podržava ovaj postupak uvoza. Pravila podudaranja specifična za pružatelja usluge i dalje vrijede; zahtjev za uvoz ne ukida ta pravila niti jamči ispunjavanje uvjeta za svaku namjenu kampanje.
Pripremite uvoz
| Polje | Vrijednost |
|---|---|
| evpId | ID podržanog pružatelja usluge, 1–10 znakova. |
| vettingId | Stvarni identifikator transakcije provjere kod pružatelja usluge, do 255 znakova. Nemojte umjesto njega upotrijebiti ID brenda niti izmisliti identifikator. |
| vettingToken | Potvrdni token kada ga pružatelj usluge zahtijeva, do 65535 znakova. Čuvajte ga kao tajni podatak i izostavite ga kada ga pružatelj usluge ne zahtijeva. |
Izradite vetting-import.json koristeći stvarne vrijednosti pružatelja usluge. Nemojte slati polja ocjene, statusa ili vremenske oznake koja se pojavljuju samo u odgovoru kao da bi mogla promijeniti rezultat.
Uvezite rezultat jednom
curl --silent --show-error --fail-with-body --user "$API_USER:$API_PASSWORD" \
--request PUT \
--header 'Content-Type: application/json' \
--header "Idempotency-Key: $IDEMPOTENCY_KEY" \
--data-binary @vetting-import.json \
"https://api.multitel.net/tcr/v2/brand/$BRAND_ID/externalVetting"Upoznajte se s postojećim naplatama
Ovaj posrednički poslužitelj ne evidentira novouvezeni rezultat kao novu narudžbu koja se naplaćuje. Time se ne otkazuje prethodno naručena provjera: kada za isti vettingId već postoji narudžba koja čeka rezultat ili naplatu, uvoz rezultata sa statusom ACTIVE ili FAILED može dovesti do naplate naknade pohranjene uz tu narudžbu. Ova grana sinkronizacije ne naplaćuje ponovno zapis koji je već naplaćen.
Pratite stvarni ishod
Uspješan HTTP odgovor može sadržavati zapis provjere koji je još na čekanju. Sačuvajte njegov vettingId te pregledajte vettingStatus, razloge, ocjenu i datume početka i isteka valjanosti ako su dostupni. PENDING i UNSCORE zahtijevaju daljnje praćenje; ACTIVE, FAILED i EXPIRED opisuju različite ishode. Samo prihvaćanje na razini protokola HTTP ne dokazuje povoljnu ocjenu ni ispunjavanje uvjeta za kampanju.
Upotrijebite status vanjske provjere za praćenje zapisa. Čitanje ili uvoz konačnog rezultata može dovesti do podmirenja ranije narudžbe koja se naplaćuje; to ne znači nužno da neće biti naplaćen postojeći nepodmireni iznos.
Ponovno pošaljite isti namjeravani zahtjev
Upotrijebite jedan Idempotency-Key za svaku namjeravanu operaciju i sačuvajte potpuno istu metodu, putanju, upit i bajtove tijela zahtjeva. Ključevi podržavaju 1–128 ispisivih ASCII znakova bez razmaka. Duplicirani zahtjev čija je obrada u tijeku može vratiti 409 uz Retry-After. Dovršeni zahtjevi ponovno vraćaju svoj pohranjeni odgovor, uključujući pogreške. Poštujte ograničenja učestalosti zahtjeva.
Predmemorirani odgovor 502 može uslijediti nakon pogreške u prijenosu. Predmemorirani odgovor 500 s requestId može značiti da je registar prihvatio operaciju, ali lokalna trajna pohrana ili naplata nije uspjela. Sačuvajte ID zahtjeva, pregledajte trenutačne zapise i razjasnite stanje s podrškom prije upotrebe novog ključa. Nemojte pretpostaviti da pogreška znači da narudžba ne postoji.