Tarkista korjatut yrityksen tunnistetiedot uudelleen
Käytä tätä toimintoa, kun olemassa olevan organisaatiobrändin korjatut tunnistetiedot on tarkistettava uudelleen. Aloita näin: päivitä olemassa oleva brändi, ja lue sitten sen nykyinen varmennustila. Tavallinen profiilin päivitys ei lähetä tätä erillistä maksullista varmennusyritystä. Uudelleenvarmennus ei luo toista brändiä eikä rekisteröi kampanjaa.
Käytä omaa käytössä olevaa API-tiliäsi HTTPS-yhteydellä sallitusta lähde-IP-osoitteesta. Brändin on kuuluttava kyseiselle tilille. Pidä bränditietueet yksityisinä: ne sisältävät yritys- ja yhteystietoja.
Tarkista brändi ennen pyynnön lähettämistä
curl --silent --show-error --fail-with-body --user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/tcr/v2/brand/$BRAND_ID" \
--output current-brand.jsonTarkista, että palautettu brändi vastaa tarkoitettua yritystä ja että korjaus on mukana. Jos alkuperäinen rekisteröinti odottaa käsittelyä, uudelleenvarmennusta ei voi vielä tehdä. Rekisteri voi hylätä pyynnön, jos yritystiedot eivät ole muuttuneet. Puuttuvat erityisattribuutit voivat edellyttää muutoksenhakua uuden tunnistetietojen tarkistuksen sijaan. Yksityisten elinkeinonharjoittajien brändeissä käytetään asianmukaista henkilöllisyyden ja PIN-koodin tarkistusprosessia; älä käytä tätä päätepistettä sen korvikkeena.
Vahvista erillinen maksu
Tuotantoympäristön uudelleenvarmennukselle tällä hetkellä määritetty maksu on US$5.00 hyväksyttyä varmennusyritystä kohden, tarkistettu 24. lokakuuta 2026. Maksuna käytetään brändin vakiomaksua myös silloin, kun alkuperäisellä toimijalla on eri rekisteröintihinta. Ostojen on oltava käytössä; ennakkomaksutileillä on oltava riittävästi saldoa ennen lähettämistä.
202-vastaus tarkoittaa, että pyyntö on hyväksytty jatkokäsittelyyn, ja maksu lähetetään veloitettavaksi hyväksymisen yhteydessä. Se ei tarkoita, että yritys olisi varmennettu. Myöhempi uusi varmennusyritys voi aiheuttaa uuden maksun. Älä aloita uutta varmennusyritystä vain siksi, että varmennus odottaa edelleen käsittelyä.
Lähetä yksi suunniteltu varmennusyritys
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"Profiilia ei tarvitse lähettää pyynnön rungossa: toiminto tarkistaa jo tallennetut bränditiedot. Käytä suunnitellulle varmennusyritykselle yksilöllistä idempotenssiavainta ja säilytä menetelmä, polku, kysely ja runko täsmälleen samoina uusintapyynnöissä. Avaimet voivat sisältää 1–128 tulostettavaa ASCII-merkkiä ilman välilyöntejä. Käynnissä olevan varmennusyrityksen kaksoiskappale voi palauttaa 409-vastauksen ja Retry-After-otsakkeen; valmistunut varmennusyritys voi palauttaa uudelleen tallennetun tuloksensa, myös virheen.
Julkinen API hyväksyy myös Bearer-todennuksen käytössä olevalle tunnistepohjaiselle tilille. Tilin omistajuuden ja sallitun lähde-IP-osoitteen tarkistukset ovat edelleen voimassa. Tallennetut testibrändit ohittavat tämän tuotantoympäristön maksunkäsittelyn, mutta testiympäristön tulos ei ole tuotantoympäristössä tehty tunnistetietojen varmennus.
Lue tulos ja seuraa tilaa
| Vastaus | Merkitys ja seuraava toimenpide |
|---|---|
| 200 | Pyyntö onnistui. Tarkista palautettu brändi ja lue nykyinen bränditietue uudelleen varmistaaksesi varmennustilan. |
| 202 | Hyväksytty, odottaa lisävarmennusta. Säilytä brändin tunniste ja tarkista sen nykyinen tila myöhemmin lähettämättä uutta maksullista varmennusyritystä. |
| 400 | Tarkista rekisterin palauttamat virheet. Alkuperäinen rekisteröinti voi odottaa käsittelyä, profiili voi olla muuttumaton tai jokin muu validointisääntö voi olla sovellettavissa. |
| 401 / 404 | Tarkista tunnistetiedot ja sallittu IP-osoite tai tilille kuuluvan brändin tunniste. |
| 402 / 503 | Tarkista paikallinen ostoon, tilin rahoitukseen, hinnoitteluun tai palveluun liittyvä virhe. Älä oleta, että jokainen 503-vastaus todistaa, ettei taustapalveluun tehty pyyntöä. |
| 429 | Noudata Retry-After-otsaketta ja säilytä varmennusyrityksen tiedot samoina. |
Välityspalvelin päivittää paikallisen bränditietueensa hyväksytyn muutoksen jälkeen; tämä päivitys ei itsessään todista varmennuksen lopullista tulosta. Yritys voi jäädä varmentamatta tai odottamaan käsittelyä. Tarkista brändin nykyinen tila ennen kampanjan määrityksen jatkamista sen sijaan, että luottaisit pelkkään HTTP-hyväksyntään.
Selvitä epävarma tulos
Tiedonsiirtovirhe voi tuottaa välimuistiin tallennetun 502-vastauksen. Taustapalvelussa hyväksytty pyyntö, jota seuraa paikallinen tallennus- tai laskutusvirhe, voi tuottaa välimuistiin tallennetun 500-vastauksen, jossa on requestId. Säilytä tämä tunniste ja selvitä brändin ja laskutuksen nykyinen tila tuen kanssa. Toisen avaimen luominen voi synnyttää erikseen laskutettavan varmennusyrityksen; älä yritä uudelleen uudella avaimella selvittämättä ensin tilannetta.
Asiakasportaalin käyttäminen
Portaali tarjoaa uudelleenvarmennuksen tuotantoympäristön organisaatiolle, jonka tila on UNVERIFIED, kun nykyinen profiili ja maksu on tarkistettu. Se tarkistaa, etteivät profiili ja hinta ole muuttuneet, ja hylkää uuden samoilla nykyisillä tiedoilla tehdyn lähetyksen, joka muuten hyväksyttäisiin. Tämä portaalitoiminto ei koske testiympäristön brändejä eikä yksityisten elinkeinonharjoittajien brändejä.
Nämä portaalin suojaukset ovat työnkulun lisätarkistuksia. Suorien API-asiakasohjelmien on tehtävä oma tarkistuksensa, eivätkä ne saa olettaa, että API edellyttää portaalin versio- tai hinnanvahvistuskenttiä. Tavallisen brändikorjauksen tallentaminen on erillinen toimenpide, eikä se lähetä uudelleenvarmennusta automaattisesti.