Kontrolloni rezultatet e vlerësimit të një marke

Zgjidhni markën që po kontrolloni

Përdorni identifikuesin e markës nga llogaria juaj. Ruajeni së bashku me regjistrimet e vlerësimit të marra, në mënyrë që vlerësimi i një biznesi të mos ngatërrohet me vlerësimin e një biznesi tjetër. Mos përdorni identifikuesit e një llogarie tjetër.

Ndiqni një vlerësim ekzistues

Ruani vettingId, evpId, vettingClass dhe vettingStatus kur janë të pranishme. Sinkronizimi aktual i trajton PENDING dhe UNSCORE si rezultate që ende presin kontrolle të mëtejshme, ndërsa ACTIVE dhe FAILED si rezultate përfundimtare për shlyerjen e tarifës. Lexoni hollësitë e kthyera përpara se të vendosni nëse nevojiten veprime të mëtejshme. Një listë bosh, në vetvete, nuk provon se një kërkesë e dërguar më parë nuk ka mbërritur në regjistër.

Kuptoni tarifat për një porosi të mëparshme

Kontrolli i statusit nuk porosit një vlerësim tjetër. Megjithatë, ai mund të rakordojë një rezultat të përfunduar dhe të shlyejë tarifën e lidhur me një kërkesë të mëparshme për vlerësim të faturueshëm. Kjo përfshin një tarifë të zbatueshme në rast dështimi. Përdorni çmimin dhe kushtet e shqyrtuara në kohën e porositjes; mos e nxirrni çmimin e sotëm nga një shembull i vjetër ose nga një përgjigje për statusin.

Riprovoni leximin pa dërguar një porosi tjetër

Në rast të një dështimi të përkohshëm, ruani identifikuesin e markës dhe identifikuesit e njohur të vlerësimit, respektoni Retry-After dhe riprovoni këtë lexim me intervale pritjeje gjithnjë e më të gjata. Mos dërgoni një porosi të re vlerësimi vetëm sepse kërkimi i statusit dështoi ose ktheu një trup përgjigjeje të papritur. Nëse mospërputhja vazhdon, kontaktoni MultiTEL përmes një kanali mbështetjeje me autentikim, duke dhënë identifikuesit përkatës të referencës.

Mbajini të ndarë hapat e regjistrimit

Vlerësimi përcakton një rezultat shqyrtimi për markën. Kualifikimi i fushatës, regjistrimi i fushatës dhe caktimi i numrave mbeten hapa të veçantë. Kontrolloni statusin dhe kërkesat e tyre aktuale përpara se të dërgoni mesazhe.

Kërkesa

Përdorni një llogari API të aktivizuar, përmes HTTPS, nga një adresë IP burimore e lejuar. Përdorni kredencialet e llogarisë suaj, jo kredencialet e regjistrit. Marka duhet të jetë e lidhur me llogarinë e autentikuar.

GET me identifikuesin e markës në shteg dhe me filtrin e detyrueshëm të pyetjes vettingStatus. Skema e shqyrtuar përcakton një varg statusesh; ky shembull kërkon një vlerë të vetme ACTIVE. Ky udhëzues nuk përcakton kodimin e vlerave të shumëfishta ose pranimin nga ofruesi të kërkesave pa filtër. Nuk kërkohet trup kërkese.

curl --fail-with-body --silent --show-error \
  --user "$API_USER:$API_PASSWORD" \
  "https://api.multitel.net/tcr/v2/brand/$BRAND_ID/externalVetting?vettingStatus=ACTIVE"

Përgjigjja

Rruga aktuale ruan statusin HTTP dhe trupin e përgjigjes së regjistrit, në vend që të përdorë strukturën mbështjellëse të përgjigjes së versionit të vjetër v3. Vargu imagjinar i shkurtuar ilustron fushat e përdorura nga rrjedha lokale e sinkronizimit; ai nuk është një përgjigje e regjistruar nga regjistri ose një skemë e garantuar si e plotë. Kontrolloni statusin HTTP dhe përmbajtjen JSON përpara se të lexoni regjistrimet. Ruani çdo vettingId së bashku me markën e zgjedhur.

Strukturë ilustruese e përgjigjes; nuk përfaqëson të dhëna reale të llogarisë ose një ofertë aktuale çmimi.

[
  {
    "vettingId": "example-vetting-id",
    "evpId": "example-review-provider",
    "vettingClass": "STANDARD",
    "vettingStatus": "ACTIVE"
  }
]

Gabimet

• 401: Autentikimi i llogarisë dështoi. Kontrolloni kredencialet, nëse qasja API është e aktivizuar dhe kufizimet e zbatueshme për adresën IP burimore.
• 404: Marka nuk është e lidhur me këtë llogari ose regjistri nuk mundi ta gjente. Refuzimi për shkak të kontrollit të përkatësisë së markës në llogari ndodh përpara dërgimit të kërkesës te regjistri.
• 429: Është arritur kufiri i kërkesave të llogarisë ose të regjistrit. Respektoni Retry-After dhe përdorni intervale pritjeje gjithnjë e më të gjata ndërmjet riprovimeve.
• 502/503: Transporti, regjistri, kufizuesi i kërkesave ose përpunimi lokal nuk është i disponueshëm. Një gabim nuk provon se një kërkesë e mëparshme vlerësimi ka dështuar.

Disponueshmëria dhe efektet anësore

• Kjo kërkesë GET nuk bën një porosi të re vlerësimi. Ajo merr rezultatet nga regjistri, shkruan regjistrime auditimi për kërkesën dhe sinkronizon rezultatet e ruajtura.
• Leximi i një rezultati të përfunduar mund të shlyejë tarifën për një porosi të faturueshme vlerësimi të bërë më parë. Një vlerësim i dështuar mund të ketë një tarifë të zbatueshme në rast dështimi. Shqyrtoni çmimin dhe kushtet kur bëni porosinë; ky lexim nuk është një ofertë çmimi.
• Një regjistrim i sapozbuluar, i importuar nga kjo kërkesë GET, nuk klasifikohet automatikisht si një porosi e re e faturueshme.
• Një rezultat vlerësimi i suksesshëm ose ACTIVE nuk përbën miratim të fushatës, caktim të një numri telefoni ose leje për të dërguar mesazhe.