Kūrėjams

PUT/tcr/v2/brand/{brandId}/revet

Pakartotinai patikrinkite pranešimų siuntėjo prekės ženklą

Pataisę esamą įmonės profilį, pateikite vieną atskirai apmokestinamą tapatybės patikros užklausą ir stebėkite rezultatą.

Šiame puslapyje
  1. Pakartotinai patikrinkite pataisytus įmonės tapatybės duomenis
  2. Prieš pateikdami užklausą peržiūrėkite prekės ženklą
  3. Patvirtinkite atskirą mokestį
  4. Pateikite vieną numatytą bandymą
  5. Peržiūrėkite rezultatą ir stebėkite jo būseną
  6. Išsiaiškinkite neaiškų rezultatą
  7. Klientų portalo naudojimas

Pakartotinai patikrinkite pataisytus įmonės tapatybės duomenis

Naudokite šią operaciją, kai reikia dar kartą patikrinti pataisytus esamo organizacijos prekės ženklo tapatybės duomenis. Pirmiausia atnaujinkite esamą prekės ženklą, tada peržiūrėkite dabartinę jo tapatybės patikros būseną. Įprastas profilio atnaujinimas nepateikia šio atskiro mokamo bandymo. Pakartotinė patikra nesukuria kito prekės ženklo ir neužregistruoja kampanijos.

Naudokite savo įgalintą API paskyrą ir junkitės per HTTPS iš leidžiamo šaltinio IP adreso. Prekės ženklas turi priklausyti tai paskyrai. Saugokite prekės ženklo įrašų konfidencialumą: juose yra įmonės ir kontaktinių duomenų.

Prieš pateikdami užklausą peržiūrėkite prekės ženklą

curl --silent --show-error --fail-with-body --user "$API_USER:$API_PASSWORD" \
  "https://api.multitel.net/tcr/v2/brand/$BRAND_ID" \
  --output current-brand.json

Patikrinkite, ar grąžintas prekės ženklas atitinka numatytą įmonę ir ar duomenys pataisyti. Kol pirminė registracija laukia užbaigimo, pakartotinė patikra negalima. Registras gali atmesti užklausą, jei įmonės informacija nepasikeitė. Jei trūksta specialiųjų atributų, gali reikėti pateikti apeliaciją, o ne atlikti dar vieną tapatybės patikrą. Individualių verslininkų prekės ženklams taikoma atitinkama tapatybės / PIN patikros eiga; nelaikykite šio galinio taško jos pakaitalu.

Patvirtinkite atskirą mokestį

Šiuo metu nustatytas pakartotinės patikros mokestis produkcinėje aplinkoje yra US$5.00 už kiekvieną priimtą bandymą, patikrinta spalio 24 d., 2026 m. Taikomas standartinis prekės ženklo mokestis, taip pat ir tada, kai pradinio subjekto registracijos kaina skiriasi. Pirkimai turi būti įgalinti; išankstinio mokėjimo paskyrose prieš pateikiant užklausą turi pakakti lėšų.

Atsakymas 202 reiškia, kad užklausa priimta toliau apdoroti, o jos priėmimo metu inicijuojamas mokesčio taikymas. Tai nereiškia, kad įmonės tapatybė patvirtinta. Už vėlesnį naują bandymą gali būti taikomas dar vienas mokestis. Nekurkite naujo bandymo vien todėl, kad patikra vis dar nebaigta.

Pateikite vieną numatytą bandymą

curl --silent --show-error --fail-with-body --user "$API_USER:$API_PASSWORD" \
  --request PUT \
  --header "Idempotency-Key: $IDEMPOTENCY_KEY" \
  "https://api.multitel.net/tcr/v2/brand/$BRAND_ID/revet"

Užklausos turinio su profilio duomenimis nereikia: tikrinami jau išsaugoti prekės ženklo duomenys. Numatytam bandymui naudokite unikalų idempotentiškumo raktą, o kartodami užklausą nekeiskite metodo, kelio, užklausos parametrų ir turinio. Raktą gali sudaryti 1–128 spausdinami ASCII simboliai be tarpų. Dar vykdomo bandymo dublikatas gali grąžinti 409 su Retry-After; užbaigto bandymo atveju gali būti pakartotinai grąžintas išsaugotas rezultatas, įskaitant klaidą.

Viešoji API taip pat palaiko Bearer autentifikavimą įgalintai prieigos rakto paskyrai. Paskyros nuosavybės ir leidžiamo šaltinio IP adreso patikros tebetaikomos. Išsaugotiems imitaciniams prekės ženklams šis produkcinės aplinkos apmokestinimo procesas netaikomas, tačiau bandomosios aplinkos rezultatas nėra tapatybės patikra produkcinėje aplinkoje.

Peržiūrėkite rezultatą ir stebėkite jo būseną

Pakartotinės patikros atsakymai
AtsakymasReikšmė ir tolesnis veiksmas
200Užklausa įvykdyta sėkmingai. Peržiūrėkite grąžintą prekės ženklą ir dar kartą nuskaitykite dabartinį jo įrašą, kad patvirtintumėte tapatybės patikros būseną.
202Priimta, laukiama tolesnės patikros. Išsaugokite prekės ženklo identifikatorių ir vėliau patikrinkite jo dabartinę būseną nepateikdami kito mokamo bandymo.
400Peržiūrėkite grąžintas registro klaidas. Pirminė registracija gali būti dar nebaigta, profilis gali būti nepakeistas arba gali būti taikoma kita duomenų tikrinimo taisyklė.
401 / 404Patikrinkite prisijungimo duomenis ir leidžiamą IP adresą arba paskyrai priklausančio prekės ženklo identifikatorių.
402 / 503Peržiūrėkite vietinę pirkimo / lėšų papildymo arba kainodaros / paslaugos klaidą. Nemanykite, kad kiekvienas 503 įrodo, jog užklausa nebuvo išsiųsta aukštesnio lygio paslaugai.
429Laikykitės Retry-After nurodymo ir nekeiskite bandymo duomenų.

Tarpinis serveris atnaujina vietinį prekės ženklo įrašą po priimto pakeitimo; pats šis atnaujinimas nepatvirtina galutinio patikros rezultato. Įmonė gali likti nepatvirtinta arba laukti patikros. Prieš tęsdami kampanijos nustatymą remkitės dabartine prekės ženklo būsena, o ne vien priėmimu pagal HTTP.

Išsiaiškinkite neaiškų rezultatą

Dėl ryšio sutrikimo gali būti išsaugotas atsakymas 502 podėlyje. Jei aukštesnio lygio paslauga priima užklausą, o po to įvyksta vietinio duomenų išsaugojimo arba atsiskaitymo klaida, podėlyje gali būti išsaugotas atsakymas 500 su requestId. Išsaugokite šį identifikatorių ir su pagalbos tarnyba suderinkite dabartinę prekės ženklo bei atsiskaitymo būseną. Sugeneravus kitą raktą gali būti sukurtas atskirai apmokestinamas bandymas; nekartokite užklausos su nauju raktu aklai.

Klientų portalo naudojimas

Portale galima pakartotinai patikrinti produkcinės aplinkos organizaciją, kurios būsena yra UNVERIFIED, peržiūrėjus dabartinį profilį ir mokestį. Portalas patikrina, ar profilis ir kaina nepasikeitė, ir neleidžia dar kartą priimti pateikimo su tais pačiais dabartiniais duomenimis. Šis portalo veiksmas netaikomas bandomosios aplinkos ir individualių verslininkų prekės ženklams.

Šios portalo apsaugos priemonės yra papildomos darbo eigos patikros. Tiesioginiai API klientai turi atlikti savo peržiūrą ir neturi manyti, kad API reikalauja portalo versijos arba kainos patvirtinimo laukų. Įprasto prekės ženklo duomenų pataisymo išsaugojimas yra atskiras veiksmas, kuris automatiškai nepateikia pakartotinės patikros užklausos.