Peržiūrėkite prekės ženklo patikros rezultatus

Pasirinkite tikrinamą prekės ženklą

Naudokite savo paskyroje esantį prekės ženklo identifikatorių. Saugokite jį kartu su gautais patikros įrašais, kad vienos įmonės patikra nebūtų supainiota su kitos įmonės patikra. Nenaudokite kitos paskyros identifikatorių.

Stebėkite esamą patikrą

Išsaugokite vettingId, evpId, vettingClass ir vettingStatus reikšmes, jei jos pateiktos. Dabartinis sinchronizavimo procesas būsenas PENDING ir UNSCORE laiko rezultatais, kuriuos dar reikia papildomai tikrinti, o būsenas ACTIVE ir FAILED laiko galutiniais rezultatais, pagal kuriuos atliekamas atsiskaitymas. Prieš nuspręsdami, ar reikia tolesnių veiksmų, perskaitykite grąžintą išsamią informaciją. Vien tuščias sąrašas neįrodo, kad ankstesnė pateikta užklausa nepasiekė registro.

Išsiaiškinkite ankstesnio užsakymo mokesčius

Tikrinant būseną nauja patikra neužsakoma. Tačiau taip galima suderinti užbaigtos patikros rezultatą ir atlikti atsiskaitymą už ankstesnę mokamą patikros užklausą. Tai apima ir taikomą mokestį už nesėkmingą patikrą. Vadovaukitės užsakymo metu peržiūrėta kaina ir sąlygomis; nespręskite apie dabartinę kainą pagal seną pavyzdį ar atsakymą apie būseną.

Pakartokite duomenų skaitymą nepateikdami naujo užsakymo

Įvykus laikinai klaidai, išsaugokite prekės ženklo ir žinomus patikrų identifikatorius, laikykitės Retry-After nurodymų ir pakartokite šią skaitymo užklausą palaipsniui didindami laukimo intervalus. Nepateikite naujo patikros užsakymo vien dėl to, kad būsenos paieška nepavyko arba grąžino netikėtą atsakymo turinį. Jei neatitiktis išlieka, susisiekite su MultiTEL per autentifikuotą pagalbos kanalą ir pateikite susijusius nuorodinius identifikatorius.

Atskirkite registracijos etapus

Atlikus patikrą nustatomas prekės ženklo patikros rezultatas. Kampanijos tinkamumo nustatymas, kampanijos registracija ir numerio priskyrimas lieka atskirais etapais. Prieš siųsdami pranešimus patikrinkite dabartinę jų būseną ir reikalavimus.

Užklausa

Naudokite paskyrą su įjungta API prieiga ir junkitės per HTTPS iš leidžiamo šaltinio IP adreso. Naudokite savo paskyros prisijungimo duomenis, o ne registro prisijungimo duomenis. Prekės ženklas turi būti susietas su autentifikuota paskyra.

Siųskite GET užklausą su prekės ženklo identifikatoriumi kelyje ir privalomu užklausos filtru vettingStatus. Peržiūrėtoje schemoje apibrėžtas būsenų masyvas; šiame pavyzdyje prašoma vienos ACTIVE reikšmės. Šis vadovas nepatvirtina nei kelių reikšmių kodavimo būdo, nei to, kad teikėjas priima užklausas be filtro. Užklausos turinys nereikalingas.

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

Atsakymas

Dabartinis maršrutas išlaiko registro HTTP būseną ir atsakymo turinį, užuot naudojęs senąjį v3 atsakymo apvalkalą. Sutrumpintas išgalvotas masyvas iliustruoja laukus, kuriuos naudoja vietinis sinchronizavimo procesas; tai nėra užfiksuotas registro atsakymas ar garantuotai išsami schema. Prieš skaitydami įrašus patikrinkite HTTP būseną ir JSON. Kiekvieną vettingId saugokite kartu su pasirinktu prekės ženklu.

Iliustracinė atsakymo struktūra; tai nėra tikrieji paskyros duomenys ar dabartinis kainos pasiūlymas.

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

Klaidos

• 401: Nepavyko autentifikuoti paskyros. Patikrinkite prisijungimo duomenis, ar įjungta API prieiga ir kokie taikomi šaltinio IP adreso apribojimai.
• 404: Prekės ženklas nesusietas su šia paskyra arba registras jo nerado. Jei prieiga atmetama dėl to, kad prekės ženklas nepriklauso paskyrai, tai įvyksta prieš siunčiant užklausą registrui.
• 429: Pasiektas paskyros arba registro užklausų limitas. Laikykitės Retry-After nurodymų ir palaipsniui didinkite laukimo intervalus.
• 502/503: Duomenų perdavimas, registras, užklausų ribotuvas arba vietinis apdorojimas nepasiekiamas. Klaida nepatvirtina, kad ankstesnė patikros užklausa nepavyko.

Prieinamumas ir šalutinis poveikis

• Ši GET užklausa nepateikia naujo patikros užsakymo. Ji gauna registro rezultatus, įrašo užklausos audito įrašus ir sinchronizuoja išsaugotus rezultatus.
• Nuskaičius užbaigtos patikros rezultatą gali būti atliktas atsiskaitymas už anksčiau pateiktą mokamą patikros užsakymą. Už nesėkmingą patikrą gali būti taikomas atitinkamas mokestis. Užsakydami peržiūrėkite kainą ir sąlygas; ši skaitymo užklausa nėra kainos pasiūlymas.
• Naujai aptiktas įrašas, importuotas šia GET užklausa, nėra automatiškai priskiriamas naujam mokamam užsakymui.
• Sėkmingas patikros rezultatas arba ACTIVE būsena nėra kampanijos patvirtinimas, telefono numerio priskyrimas ar leidimas siųsti pranešimus.