Kasutage kontole kuuluvat sõnumside kaubamärki
Kasutage lubatud lähte-IP-aadressilt aktiveeritud API kontot HTTPS kaudu. Toetatud on autentimisviisid Basic ja Bearer. Kaubamärgi tunnus peab kuuluma sellele kontole. Hoidke teenusepakkuja tõendid, kaubamärgi identiteediandmed ja tagastatud aruanded konfidentsiaalsena.
Kasutage teenusepakkuja olemasolevat tulemust
Kasutage meetodit PUT, et siduda toetatud teenusepakkuja olemasolev kontrollitulemus oma kaubamärgiga. See ei telli uut kontrolli. Hankige õige teenusepakkuja tehingutunnus ja vajaduse korral kinnitustõend otse sellelt teenusepakkujalt ning veenduge, et aruanne käib sama ettevõtte kohta.
AUTHPLUS ei toeta seda importimise töövoogu. Teenusepakkuja vastavusreeglid kehtivad endiselt; impordipäring ei vabasta nende järgimisest ega taga sobivust igaks kampaania kasutusjuhuks.
Valmistage import ette
| Väli | Väärtus |
|---|---|
| evpId | Toetatud teenusepakkuja tunnus, 1–10 märki. |
| vettingId | Teenusepakkuja tegelik kontrollitehingu tunnus, kuni 255 märki. Ärge asendage seda kaubamärgi tunnusega ega mõelge tunnust välja. |
| vettingToken | Kinnitustõend, kui teenusepakkuja seda nõuab, kuni 65535 märki. Hoidke seda saladuses ja jätke see välja, kui teenusepakkuja seda ei nõua. |
Looge vetting-import.json, kasutades teenusepakkuja tegelikke väärtusi. Ärge saatke ainult vastuse jaoks mõeldud hinde-, oleku- ega ajatemplivälju, justkui saaksid need tulemust muuta.
Importige tulemus üks kord
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"Tutvuge olemasolevate tasudega
See puhverserver ei registreeri äsja imporditud tulemust uue tasulise tellimusena. See ei tühista varem tellitud kontrolli: kui sama vettingId kohta on juba tulemust või tasu võtmist ootav tellimus, võib olekuga ACTIVE või FAILED tulemuse importimine käivitada tellimusele salvestatud tasu võtmise. Selles sünkroonimisharus ei võeta uuesti tasu kirje eest, mille eest on tasu juba võetud.
Jälgige tegelikku tulemust
Edukas HTTP vastus võib sisaldada ootel kontrollikirjet. Säilitage selle vettingId ning vaadake välja vettingStatus, põhjuseid, hinnet ja kehtivuse algus- ja lõppkuupäevi, kui need on saadaval. PENDING ja UNSCORE nõuavad edasist jälgimist; ACTIVE, FAILED ja EXPIRED tähistavad erinevaid tulemusi. Ainuüksi päringu vastuvõtmine HTTP tasandil ei tõenda soodsat hinnet ega kampaania nõuetele vastavust.
Kasutage lehte väliskontrolli olek kirje jälgimiseks. Lõpliku tulemuse lugemine või importimine võib käivitada varasema tasulise tellimuse tasu võtmise; see ei pruugi vabastada olemasoleva tasumata tasu maksmisest.
Korrake sama kavandatud päringut
Kasutage iga kavandatud toimingu jaoks ühte Idempotency-Key väärtust ning säilitage täpselt sama meetod, tee, päringuparameetrid ja keha baidid. Võtmed võivad sisaldada 1–128 prinditavat ASCII märki ilma tühikuteta. Veel töös oleva päringu duplikaat võib tagastada 409 koos päisega Retry-After. Lõpetatud päringute korral tagastatakse uuesti salvestatud vastus, sealhulgas vead. Järgige päringusageduse piiranguid.
Edastustõrkele võib järgneda vahemällu salvestatud 502 vastus. Vahemällu salvestatud 500 vastus koos väljaga requestId võib tähendada, et register võttis toimingu vastu, kuid kohalik andmete püsisalvestamine või arveldamine nurjus. Säilitage päringu tunnus, kontrollige praeguseid kirjeid ja selgitage olukord kasutajatoega välja enne uue võtme kasutamist. Ärge eeldage, et viga tähendab tellimuse puudumist.