Használjon a fiókhoz tartozó üzenetküldési márkát
Használjon engedélyezett API-fiókot HTTPS-kapcsolaton, engedélyezett forrás-IP-címről. A Basic és a Bearer hitelesítés támogatott. A márkaazonosítónak ehhez a fiókhoz kell tartoznia. Kezelje bizalmasan a szolgáltatói tokeneket, a márka azonosító adatait és a visszakapott jelentéseket.
Használjon meglévő szolgáltatói eredményt
A PUT metódussal társítsa egy támogatott szolgáltató meglévő átvilágítási eredményét a márkájához. Ez nem rendel meg új ellenőrzést. A megfelelő szolgáltatói tranzakcióazonosítót és az esetleges megerősítő tokent közvetlenül az adott szolgáltatótól szerezze be, és győződjön meg arról, hogy a jelentés ugyanahhoz a vállalkozáshoz tartozik.
Az AUTHPLUS nem támogatja ezt az importálási folyamatot. A szolgáltatóspecifikus egyeztetési szabályok továbbra is érvényesek; az importálási kérés nem mentesít ezek alól, és nem garantál jogosultságot minden kampányfelhasználási esetre.
Készítse elő az importálást
| Mező | Érték |
|---|---|
| evpId | Támogatott szolgáltató azonosítója, 1–10 karakter. |
| vettingId | A szolgáltató tényleges átvilágítási tranzakcióazonosítója, legfeljebb 255 karakter. Ne helyettesítse a márkaazonosítóval, és ne találjon ki azonosítót. |
| vettingToken | Megerősítő token, ha a szolgáltató megköveteli, legfeljebb 65535 karakter. Kezelje titokként, és hagyja ki, ha a szolgáltató nem követeli meg. |
Hozza létre a vetting-import.json fájlt a tényleges szolgáltatói értékekkel. Ne küldje el a kizárólag a válaszban szereplő pontszám-, állapot- vagy időbélyegmezőket úgy, mintha azok megváltoztathatnák az eredményt.
Importálja egyszer az eredményt
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"Ismerje meg a meglévő díjterhelések működését
Ez a proxy az újonnan importált eredményt nem rögzíti új díjköteles rendelésként. Ez nem töröl egy korábban megrendelt ellenőrzést: ha ugyanahhoz a vettingId értékhez már tartozik eredményre vagy díjterhelésre váró rendelés, egy ACTIVE vagy FAILED állapotú eredmény importálása elszámolhatja a rendeléshez tárolt díjat. Ez a szinkronizációs ág nem terheli meg újra azt a rekordot, amelynek díját már felszámították.
Kövesse nyomon a tényleges eredményt
Egy sikeres HTTP-válasz függőben lévő átvilágítási rekordot is tartalmazhat. Őrizze meg a rekord vettingId értékét, és ellenőrizze a vettingStatus mezőt, az indokokat, a pontszámot, valamint a rendelkezésre álló hatálybalépési és lejárati dátumokat. A PENDING és az UNSCORE további nyomon követést igényel; az ACTIVE, a FAILED és az EXPIRED eltérő kimeneteleket jelöl. A HTTP szintű elfogadás önmagában nem bizonyít kedvező pontszámot vagy kampányjogosultságot.
Használja a külső átvilágítás állapota oldalt a rekord nyomon követéséhez. Egy végállapotú eredmény lekérdezése vagy importálása elszámolhat egy korábbi díjköteles rendelést; a művelet nem feltétlenül mentes egy már fennálló, rendezetlen díj terhelésétől.
Ismételje meg ugyanazt a szándékolt kérést
Minden szándékolt művelethez egy Idempotency-Key kulcsot használjon, és őrizze meg a metódust, az útvonalat, a lekérdezést és a törzs pontos bájtsorozatát. A kulcsok 1–128 nyomtatható ASCII-karaktert tartalmazhatnak, szóköz nélkül. Egy még folyamatban lévő kérés ismétlése 409 választ adhat Retry-After fejléccel. A befejezett kérések megismétlésekor a tárolt válasz érkezik vissza, a hibákat is beleértve. Tartsa be a kérésgyakorisági korlátokat.
Átviteli hiba után gyorsítótárazott 502 válasz érkezhet. A requestId mezőt tartalmazó gyorsítótárazott 500 válasz azt jelentheti, hogy a nyilvántartó elfogadta a műveletet, de a helyi adatmentés vagy a számlázás sikertelen volt. Őrizze meg a kérésazonosítót, ellenőrizze az aktuális rekordokat, és új kulcs használata előtt egyeztessen az ügyfélszolgálattal. Ne feltételezze, hogy a hiba azt jelenti, hogy nem létezik rendelés.