Gebruik ’n boodskaphandelsmerk wat aan die rekening behoort
Gebruik ’n geaktiveerde API-rekening oor HTTPS vanaf ’n toegelate bron-IP-adres. Basic- en Bearer-stawing word ondersteun. Die handelsmerk-ID moet aan daardie rekening behoort. Hou verskaffertokens, die handelsmerk se identiteitsdata en teruggestuurde verslae privaat.
Gebruik ’n bestaande verskafferresultaat
Gebruik PUT om ’n bestaande keuringsresultaat van ’n ondersteunde verskaffer aan jou handelsmerk te koppel. Dit bestel nie ’n nuwe keuring nie. Kry die korrekte verskaffertransaksie-ID en enige bevestigingstoken direk by daardie verskaffer, en maak seker dat die verslag op dieselfde besigheidsidentiteit betrekking het.
AUTHPLUS ondersteun nie hierdie invoerproses nie. Verskafferspesifieke reëls vir ooreenstemming geld steeds; ’n invoerversoek stel jou nie daarvan vry nie en waarborg ook nie dat jy vir elke veldtogtoepassing kwalifiseer nie.
Berei die invoer voor
| Veld | Waarde |
|---|---|
| evpId | Ondersteunde verskaffer-ID, 1–10 karakters. |
| vettingId | Die verskaffer se werklike keuringstransaksie-identifiseerder, hoogstens 255 karakters. Moenie die handelsmerk-ID in die plek daarvan gebruik of ’n identifiseerder versin nie. |
| vettingToken | Bevestigingstoken wanneer die verskaffer dit vereis, hoogstens 65535 karakters. Hou dit geheim en laat dit weg wanneer die verskaffer dit nie vereis nie. |
Skep vetting-import.json met die werklike waardes van die verskaffer. Moenie telling-, status- of tydstempelvelde wat slegs in antwoorde voorkom, stuur asof hulle die resultaat kan verander nie.
Voer die resultaat een keer in
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"Verstaan bestaande heffings
Hierdie instaanbediener teken ’n pas ingevoerde resultaat nie as ’n nuwe betaalde bestelling aan nie. Dit kanselleer nie ’n keuring wat vroeër bestel is nie: wanneer dieselfde vettingId reeds ’n bestelling het wat op ’n resultaat of heffing wag, kan die invoer van ’n ACTIVE- of FAILED-resultaat die vereffening van die vasgelegde fooi veroorsaak. Hierdie sinchronisasietak hef nie weer ’n fooi vir ’n rekord waarvoor dit reeds gehef is nie.
Volg die werklike uitkoms op
’n Suksesvolle HTTP-antwoord kan ’n keuringsrekord bevat waarvan die uitkoms nog uitstaande is. Bewaar die vettingId daarvan en ondersoek vettingStatus, redes, telling en datums van inwerkingtreding/verval soos beskikbaar. PENDING en UNSCORE vereis verdere opvolging; ACTIVE, FAILED en EXPIRED beskryf verskillende uitkomste. Aanvaarding op HTTP-vlak alleen bewys nie ’n gunstige telling of geskiktheid vir ’n veldtog nie.
Gebruik die status van eksterne keuring om die rekord op te volg. Die lees of invoer van ’n finale resultaat kan ’n vroeëre betaalde bestelling vereffen; dit is nie noodwendig vry van ’n bestaande uitstaande heffing nie.
Probeer dieselfde beoogde versoek weer
Gebruik een Idempotency-Key per beoogde bewerking en behou die presiese metode, pad, navraag en grepe van die versoekliggaam. Sleutels ondersteun 1–128 drukbare ASCII-karakters sonder spasies. ’n Duplikaat van ’n versoek wat nog verwerk word, kan 409 met Retry-After terugstuur. Voltooide versoeke stuur hul gestoorde antwoord weer terug, insluitend foute. Hou by die limiete op versoektempo.
’n Gekaste 502 kan op ’n vervoerfout volg. ’n Gekaste 500 met requestId kan beteken dat die register die bewerking aanvaar het, maar dat plaaslike permanente berging of fakturering misluk het. Bewaar die versoek-ID, ondersoek die huidige rekords en klaar die toestand met ondersteuning uit voordat jy ’n nuwe sleutel gebruik. Moenie aanvaar dat die fout beteken dat daar geen bestelling bestaan nie.