Tarkista brändin arviointitulokset

Valitse tarkistettava brändi

Käytä tililläsi olevaa brändin tunnusta. Säilytä se palautettujen arviointitietueiden yhteydessä, jotta yhden yrityksen arviointia ei sekoiteta toisen yrityksen arviointiin. Älä käytä toisen tilin tunnuksia.

Seuraa olemassa olevaa arviointia

Säilytä vettingId, evpId, vettingClass ja vettingStatus silloin, kun ne ovat mukana. Nykyinen synkronointi käsittelee tilat PENDING ja UNSCORE tuloksina, jotka odottavat vielä lisätarkistuksia, ja tilat ACTIVE ja FAILED lopullisina tuloksina maksun selvittämistä varten. Lue palautetut tiedot ennen kuin päätät jatkotoimien tarpeesta. Tyhjä luettelo ei yksin todista, ettei aiempi lähetys saapunut rekisteriin.

Tutustu aiemman tilauksen maksuihin

Tilan tarkistaminen ei tilaa uutta arviointia. Se voi kuitenkin täsmäyttää valmistuneen tuloksen ja selvittää aiempaan laskutettavaan arviointipyyntöön liittyvän maksun. Tämä sisältää mahdollisen epäonnistumismaksun. Käytä tilaushetkellä tarkistettua hintaa ja ehtoja; älä päättele nykyistä hintaa vanhasta esimerkistä tai tilavastauksesta.

Yritä lukua uudelleen tekemättä uutta tilausta

Jos virhe on tilapäinen, säilytä brändin tunnus ja tiedossa olevat arviointitunnukset, noudata otsaketta Retry-After ja yritä tätä lukua uudelleen pidentäen yritysten välistä odotusaikaa. Älä tee uutta arviointitilausta vain siksi, että tilan haku epäonnistui tai palautti odottamattoman vastausrungon. Jos ristiriita jatkuu, ota yhteyttä MultiTELiin todennetun tukikanavan kautta ja ilmoita asiaankuuluvat viitetunnukset.

Pidä rekisteröintivaiheet erillään

Arviointi määrittää brändille arviointituloksen. Kampanjan kelpoisuuden tarkistaminen, kampanjan rekisteröinti ja numeron osoittaminen ovat edelleen erillisiä vaiheita. Tarkista niiden nykyinen tila ja vaatimukset ennen viestien lähettämistä.

Pyyntö

Käytä käyttöön otettua API-tiliä HTTPS-yhteydellä sallitusta lähde-IP-osoitteesta. Käytä oman tilisi tunnistetietoja, älä rekisterin tunnistetietoja. Brändin on oltava liitetty todennettuun tiliin.

Tee GET-pyyntö, jonka polussa on brändin tunnus ja jossa on pakollinen vettingStatus-kyselysuodatin. Tarkastettu skeema määrittää tilojen taulukon; tässä esimerkissä pyydetään yhtä ACTIVE-arvoa. Tämä opas ei vahvista usean arvon koodaustapaa eikä sitä, hyväksyykö palveluntarjoaja pyynnön ilman suodatinta. Pyyntörunkoa ei tarvita.

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

Vastaus

Nykyinen reitti säilyttää rekisterin HTTP-tilan ja vastausrungon sen sijaan, että käyttäisi vanhaa v3-vastauskäärettä. Lyhennetty kuvitteellinen taulukko havainnollistaa paikallisen synkronointipolun käyttämiä kenttiä; se ei ole tallennettu rekisterivastaus eikä taatusti täydellinen skeema. Tarkista HTTP-tila ja JSON ennen tietueiden lukemista. Säilytä jokainen vettingId valitun brändin yhteydessä.

Havainnollistava vastausrakenne; ei reaaliaikaisia tilitietoja eikä ajantasaista hintatarjousta.

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

Virheet

• 401: Tilin todennus epäonnistui. Tarkista tunnistetiedot, että API on käytössä, sekä sovellettavat lähde-IP-rajoitukset.
• 404: Brändiä ei ole liitetty tähän tiliin tai rekisteri ei löytänyt sitä. Tilin omistajuuteen perustuva esto tapahtuu ennen rekisteripyynnön tekemistä.
• 429: Tilin tai rekisterin pyyntöraja on saavutettu. Noudata otsaketta Retry-After ja pidennä yritysten välistä odotusaikaa.
• 502/503: Tiedonsiirto, rekisteri, pyyntöjen rajoitin tai paikallinen käsittely ei ole käytettävissä. Virhe ei osoita, että aiempi arviointipyyntö epäonnistui.

Saatavuus ja sivuvaikutukset

• Tämä GET-pyyntö ei tee uutta arviointitilausta. Se hakee rekisterin tulokset, kirjoittaa pyynnön auditointitietueet ja synkronoi tallennetut tulokset.
• Valmistuneen tuloksen lukeminen voi selvittää aiemmin tehdyn laskutettavan arviointitilauksen maksun. Epäonnistuneesta arvioinnista voidaan periä sovellettava epäonnistumismaksu. Tarkista hinta ja ehdot tilausta tehdessäsi; tämä luku ei ole hintatarjous.
• Tämän GET-pyynnön tuomaa uutta löydettyä tietuetta ei automaattisesti luokitella uudeksi laskutettavaksi tilaukseksi.
• Hyväksytty arviointitulos tai arviointitulos, jonka tila on ACTIVE, ei tarkoita kampanjan hyväksyntää, puhelinnumeron osoittamista eikä lupaa lähettää viestejä.