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, handelsmerkidentiteitsdata en teruggestuurde verslae privaat.
Bestel 'n nuwe eksterne kontrole
Gebruik POST wanneer 'n keuringsverskaffer 'n nuwe kontrole vir hierdie handelsmerk moet uitvoer. As jy reeds 'n verskafferresultaat het, gebruik invoer eerder. Dit is afsonderlik van herverifikasie van handelsmerkidentiteit.
Lees eers die huidige handelsmerkdata en bevestig die identiteitsinligting daarvan. Kies 'n ondersteunde verskaffer/klas uit die huidige katalogusse en gaan daardie verskaffer se vereistes na. Nie elke verskaffer ondersteun elke klas nie. Bykomende besonderhede vir politieke keuring moet die werklike organisasie of veldtog beskryf en mag nie voorbeelddata wees nie.
Berei die verskafferversoek voor
| Veld | Waarde |
|---|---|
| evpId | Verpligte verskaffer-ID uit die huidige katalogus van verskaffers van eksterne keuring, 1–10 karakters. |
| vettingClass | Die ondersteunde klas wat jy wil koop; kies dit uitdruklik en bevestig die prys daarvan. |
| additionalRequestPayload | 'n JSON-gekodeerde string met verskafferspesifieke besonderhede, wat vir politieke keuring vereis word. Dit is 'n string binne die buitenste JSON-objek, nie 'n geneste objek nie. Bevestig al die vereiste besonderhede by die gekose verskaffer. |
Bevestig heffings vir sukses en mislukking
Huidige kleinhandelfooie in Amerikaanse dollar, geraadpleeg op 24 Oktober 2026. Bevestig die huidige bedrag voordat jy 'n werklike bestelling plaas. Vooruitbetaalde fondse word teen die prys vir 'n suksesvolle uitkoms gekontroleer; aankope moet geaktiveer wees.
| Klas | Aktiewe resultaat | Mislukte resultaat |
|---|---|---|
| STANDARD | $46.12 | $5.56 |
| ENHANCED | $112.78 | $6.67 |
| POLITICAL | $73.34 | $24.45 |
| POLITICAL met 'n Express-versoek | $106.67 | $24.45 |
| AUTHPLUS | $13.89 | $13.89 |
| RCS | $83.34 | $83.34 |
Hangende bestellings behou hul bedrae vir sukses/mislukking en word vereffen wanneer 'n ACTIVE- of FAILED-resultaat gesinchroniseer word. Die laaste twee klasse gebruik dieselfde ingestelde fooi vir albei finale uitkomste. 'n Onmiddellike finale resultaat kan tydens die bestelantwoord gehef word. Latere statussinchronisasie kan 'n hangende heffing vereffen.
Moenie mock:true as 'n belofte van gratis eksterne keuring beskou nie. Die huidige vereffeningsproses vir eksterne keuring kan steeds daardie bestelling aanteken en die fooi daarvoor hef. Hierdie instruksies vereis nie 'n werklike aankoop vir toetsing nie; gebruik vanlyn toetsdatastelle totdat jy van plan is om 'n betaalde kontrole te magtig.
Dien een nagegane bestelling in
Berei vetting-order.json voor met die verskaffer-ID, klas en enige vereiste bykomende inligting. Die lêer bevat die werklike versoek wat jy wil stuur. Hou dit privaat.
curl --silent --show-error --fail-with-body --user "$API_USER:$API_PASSWORD" \
--request POST \
--header 'Content-Type: application/json' \
--header "Idempotency-Key: $IDEMPOTENCY_KEY" \
--data-binary @vetting-order.json \
"https://api.multitel.net/tcr/v2/brand/$BRAND_ID/externalVetting"Volg die werklike uitkoms
'n Suksesvolle HTTP-antwoord kan 'n hangende keuringsrekord bevat. Bewaar die vettingId daarvan en ondersoek vettingStatus, redes, telling en ingangs-/vervaldatums waar beskikbaar. PENDING en UNSCORE vereis verdere opvolging; ACTIVE, FAILED en EXPIRED beskryf verskillende uitkomste. HTTP-aanvaarding alleen bewys nie 'n gunstige telling of geskiktheid vir 'n veldtog nie.
Gebruik eksterne keuringsstatus om die rekord 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 inhoudgrepe. Sleutels ondersteun 1–128 drukbare ASCII-karakters sonder spasies. 'n Duplikaat van 'n bewerking wat nog aan die gang is, kan 409 met Retry-After terugstuur. Voltooide versoeke stuur hul gestoorde antwoord weer terug, insluitend foute. Hou by die versoekfrekwensieperke.
'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 enige verskille met ondersteuning uit voordat jy 'n nuwe sleutel gebruik. Moenie aanvaar dat die fout beteken dat geen bestelling bestaan nie.