Разработчици

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

Проверете повторно бранд за съобщения

След като коригирате съществуващ бизнес профил, подайте една заявка за проверка на самоличността, която се таксува отделно, и проследете резултата.

На тази страница
  1. Проверете отново коригираните идентификационни данни на фирмата
  2. Прегледайте бранда преди подаване на заявката
  3. Потвърдете отделната такса
  4. Подайте заявка за един планиран опит
  5. Прочетете резултата и проследете статуса му
  6. Изяснете несигурен резултат
  7. Използване на клиентския портал

Проверете отново коригираните идентификационни данни на фирмата

Използвайте тази операция, когато коригираните идентификационни данни на съществуващ бранд на организация трябва да бъдат проверени отново. Първо актуализирайте съществуващия бранд, след което прочетете текущия статус на проверката на самоличността му. Обикновеното актуализиране на профила не подава заявка за този отделен платен опит. Повторната проверка не създава друг бранд и не регистрира кампания.

Използвайте собствения си активиран API акаунт през HTTPS от разрешен изходен IP адрес. Брандът трябва да принадлежи на този акаунт. Пазете записите за бранда поверителни: те съдържат фирмени данни и информация за контакт.

Прегледайте бранда преди подаване на заявката

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

Проверете дали върнатият бранд е за желаната фирма и дали корекцията е отразена. Ако първоначалната регистрация е в изчакване, повторна проверка все още не е възможна. Регистърът може да отхвърли заявка, когато фирмените данни не са променени. Липсващите специални атрибути може да изискват обжалване вместо нова проверка на самоличността. Брандовете на еднолични търговци използват съответния процес за самоличност/PIN; не приемайте тази крайна точка като негов заместител.

Потвърдете отделната такса

Текущо зададената такса за повторна проверка в продукционната среда е US$5.00 за всеки приет опит, проверена на 24 октомври 2026 г. Прилага се стандартната такса за бранд, включително когато първоначалният субект има различна цена за регистрация. Покупките трябва да са разрешени; предплатените акаунти трябва да имат достатъчна наличност преди подаване на заявката.

Отговор 202 означава, че заявката е приета за по-нататъшна обработка, а начисляването на таксата се задейства при приемането. Това не означава, че самоличността на фирмата е потвърдена. По-късен нов опит може да доведе до още една такса. Не създавайте нов опит само защото проверката все още е в изчакване.

Подайте заявка за един планиран опит

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"

Не се изисква тяло на заявката с профила: проверяват се вече съхранените данни за бранда. Използвайте уникален ключ за идемпотентност за планирания опит и при повторно изпращане запазете напълно непроменени метода, пътя, параметрите на заявката и тялото. Ключовете поддържат 1–128 печатаеми ASCII знака без интервали. Дубликат на опит, който се обработва, може да върне 409 с Retry-After; завършен опит може да върне отново запазения си резултат, включително грешка.

Публичният API приема и удостоверяване с Bearer за активиран акаунт с токен. Проверките за собственост на акаунта и разрешен изходен IP адрес продължават да се прилагат. Съхранените симулирани брандове пропускат този процес за таксуване в продукционната среда, но резултатът от тестовата среда не представлява проверка на самоличността в продукционната среда.

Прочетете резултата и проследете статуса му

Отговори при повторна проверка
ОтговорЗначение и следващо действие
200Заявката е успешна. Прегледайте върнатия бранд и прочетете отново текущия запис за него, за да потвърдите статуса на проверката на самоличността.
202Прието, очаква се допълнителна проверка. Запазете идентификатора на бранда и проверете текущия му статус по-късно, без да подавате заявка за друг платен опит.
400Прегледайте върнатите грешки от регистъра. Първоначалната регистрация може да е в изчакване, профилът може да не е променен или да се прилага друго правило за валидация.
401 / 404Проверете данните за удостоверяване и разрешения IP адрес или идентификатора на бранда, който принадлежи на акаунта.
402 / 503Прегледайте локалната грешка, свързана с покупката или средствата, или с ценообразуването или услугата. Не приемайте, че всеки отговор 503 доказва, че не е изпратена заявка към услугата нагоре по веригата.
429Спазвайте Retry-After и запазете същите данни за опита.

Прокси сървърът обновява локалния си запис за бранда след приета промяна; само по себе си това обновяване не доказва окончателния резултат от проверката. Фирмата може да остане непроверена или в изчакване. Преди да продължите с настройването на кампанията, използвайте текущия статус на бранда, вместо да разчитате единствено на приемането по HTTP.

Изяснете несигурен резултат

Грешка при преноса може да доведе до кеширан отговор 502. Заявка, приета от услугата нагоре по веригата, последвана от грешка при локалното трайно съхраняване или таксуването, може да доведе до кеширан отговор 500 с requestId. Запазете този идентификатор и с помощта на поддръжката съгласувайте текущото състояние на бранда и таксуването. Генерирането на друг ключ може да създаде отделно таксуван опит; не повтаряйте заявката с нов ключ на сляпо.

Използване на клиентския портал

Порталът предлага повторна проверка за организация в продукционната среда със статус UNVERIFIED след преглед на текущия профил и таксата. Той проверява дали профилът и цената не са променени и отхвърля друго прието подаване за същите текущи данни. Брандовете в тестовата среда и брандовете на еднолични търговци са изключени от това действие в портала.

Тези предпазни механизми на портала са допълнителни проверки в работния процес. Директните API клиенти трябва да извършват собствен преглед и не бива да приемат, че API изисква полетата на портала за версия или потвърждение на цената. Запазването на обикновена корекция на бранда е отделно действие и не подава автоматично заявка за повторна проверка.