Üzenetküldési márka újbóli ellenőrzése

A javított vállalkozási azonosító adatok újbóli ellenőrzése

Akkor használja ezt a műveletet, ha egy meglévő szervezeti márka javított azonosító adatait újra ellenőrizni kell. Először frissítse a meglévő márkát, majd kérdezze le az azonosítás aktuális állapotát. Egy szokásos profilfrissítés nem küldi be ezt a külön díjköteles kérelmet. Az újbóli ellenőrzés nem hoz létre újabb márkát, és nem regisztrál kampányt.

A saját, engedélyezett API-fiókját használja HTTPS kapcsolaton keresztül, engedélyezett forrás-IP-címről. A márkának ehhez a fiókhoz kell tartoznia. Kezelje bizalmasan a márkarekordokat: vállalkozási és kapcsolattartási adatokat tartalmaznak.

Beküldés előtt tekintse át a márkát

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

Ellenőrizze, hogy a válaszban kapott márka a kívánt vállalkozáshoz tartozik-e, és tartalmazza-e a javítást. Ha az eredeti regisztráció még függőben van, az újbóli ellenőrzés még nem végezhető el. A nyilvántartó elutasíthatja a kérelmet, ha a vállalkozás adatai nem változtak. Hiányzó speciális attribútumok esetén újabb azonosítási ellenőrzés helyett fellebbezésre lehet szükség. Az egyéni vállalkozói márkákhoz a megfelelő azonosítási/PIN-munkafolyamatot kell használni; ez a végpont nem helyettesíti azt.

Erősítse meg a külön felszámított díjat

Az éles környezetben jelenleg beállított újbóli ellenőrzési díj US$5.00 elfogadott kérelmenként, ellenőrizve október 24-én, 2026-ban. A szokásos márkadíj érvényes akkor is, ha az eredeti jogalany regisztrációs díja eltérő. A vásárlásoknak engedélyezve kell lenniük; az előre fizetett fiókokban a beküldés előtt elegendő egyenlegnek kell rendelkezésre állnia.

A 202 válasz azt jelenti, hogy a kérelmet további feldolgozásra elfogadták, és a díj terhelését az elfogadáskor elindítják. Ez nem jelenti azt, hogy a vállalkozás ellenőrzése sikeres volt. Egy későbbi újabb kérelem további díjjal járhat. Ne indítson újabb kérelmet pusztán azért, mert az ellenőrzés még függőben van.

Egyetlen tervezett kérelem beküldése

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"

Nincs szükség a profilt tartalmazó kéréstörzsre: a művelet a már eltárolt márkaadatokat ellenőrzi. A tervezett kérelemhez használjon egyedi idempotenciakulcsot, és újrapróbálkozáskor hagyja pontosan változatlanul a metódust, az elérési utat, a lekérdezést és a törzset. A kulcsok 1–128 nyomtatható ASCII karaktert tartalmazhatnak, szóközök nélkül. Egy folyamatban lévő kérelem ismétlése 409 választ adhat Retry-After fejléccel; egy befejezett kérelem visszaadhatja a mentett eredményét, a hibát is beleértve.

A nyilvános API engedélyezett tokenes fiók esetén Bearer hitelesítést is elfogad. A fiókhoz tartozás és az engedélyezett forrás-IP-cím ellenőrzése továbbra is érvényes. A tárolt tesztmárkák esetén ez az éles díjfelszámítási folyamat kimarad, de a tesztkörnyezetben kapott eredmény nem jelent éles azonosítási ellenőrzést.

Olvassa el az eredményt, és kövesse nyomon az állapotot

Az újbóli ellenőrzés válaszai
Válasz	Jelentés és következő teendő
200	A kérés sikeres volt. Vizsgálja meg a válaszban kapott márkát, és kérdezze le újra az aktuális márkarekordot az azonosítás állapotának megerősítéséhez.
202	Elfogadva, további ellenőrzésre vár. Őrizze meg a márka azonosítóját, és később ellenőrizze az aktuális állapotát újabb díjköteles kérelem beküldése nélkül.
400	Tekintse át a válaszban kapott nyilvántartói hibákat. Előfordulhat, hogy az eredeti regisztráció még függőben van, a profil változatlan, vagy más érvényesítési szabály vonatkozik rá.
401 / 404	Ellenőrizze a hitelesítő adatokat és az engedélyezett IP-címet, illetve a fiókhoz tartozó márka azonosítóját.
402 / 503	Tekintse át a helyi vásárlási/egyenlegfeltöltési vagy árazási/szolgáltatási hibát. Ne feltételezze, hogy minden 503 válasz bizonyítja, hogy nem történt kérésküldés a háttérszolgáltatás felé.
429	Tartsa be a Retry-After fejlécben jelzett várakozást, és hagyja változatlanul a kérelem adatait.

A proxy egy elfogadott módosítás után frissíti a helyi márkarekordját; ez a frissítés önmagában nem bizonyítja az ellenőrzés végleges eredményét. Egy vállalkozás továbbra is maradhat ellenőrizetlen vagy függőben lévő állapotban. A kampány beállításának folytatása előtt a márka aktuális állapotát vegye alapul, ne pusztán a HTTP szintű elfogadást.

Bizonytalan eredmény tisztázása

Egy átviteli hiba gyorsítótárazott 502 választ eredményezhet. Ha a háttérszolgáltatás elfogadta a kérelmet, majd a helyi tartós tárolás vagy a számlázás meghiúsult, gyorsítótárazott 500 válasz keletkezhet requestId azonosítóval. Őrizze meg ezt az azonosítót, és az ügyfélszolgálattal egyeztesse a márka és a számlázás aktuális állapotát. Egy másik kulcs létrehozása külön számlázható kérelmet eredményezhet; ne próbálkozzon vakon új kulccsal.

Az ügyfélportál használata

A portál az aktuális profil és díj áttekintése után kínál újbóli ellenőrzést egy UNVERIFIED állapotú, éles környezetben működő szervezet számára. Ellenőrzi, hogy a profil és az ár nem változott-e, és elutasítja az újabb beküldést, ha ugyanezekkel az aktuális adatokkal már elfogadott egy kérelmet. A tesztkörnyezeti és az egyéni vállalkozói márkák nem használhatják ezt a portálműveletet.

A portál ezen védelmi intézkedései kiegészítő munkafolyamat-ellenőrzések. A közvetlen API-klienseknek saját ellenőrzést kell végezniük, és nem feltételezhetik, hogy az API megköveteli a portál verzió- vagy ármegerősítési mezőit. Egy szokásos márkajavítás mentése külön művelet, és nem küld be automatikusan újbóli ellenőrzési kérelmet.