Käytä tilille kuuluvaa viestintäbrändiä
Käytä käyttöön otettua API-tiliä HTTPS-yhteydellä sallitusta lähde-IP-osoitteesta. Tuetut todennustavat ovat Basic ja Bearer. Brändin tunnuksen on kuuluttava kyseiselle tilille. Pidä palveluntarjoajan tunnisteet, brändin identiteettitiedot ja palautetut raportit luottamuksellisina.
Käytä palveluntarjoajan olemassa olevaa tulosta
Liitä tuetun palveluntarjoajan olemassa oleva arviointitulos brändiisi PUT-menetelmällä. Tämä ei tilaa uutta arviointia. Hanki palveluntarjoajan oikea tapahtumatunnus ja mahdollinen vahvistustunniste suoraan kyseiseltä palveluntarjoajalta ja varmista, että raportti koskee samaa yritysidentiteettiä.
AUTHPLUS ei tue tätä tuontityönkulkua. Palveluntarjoajakohtaiset vastaavuussäännöt ovat edelleen voimassa; tuontipyyntö ei poista niitä eikä takaa kelpoisuutta kaikkiin kampanjoiden käyttötapauksiin.
Valmistele tuonti
| Kenttä | Arvo |
|---|---|
| evpId | Tuetun palveluntarjoajan tunnus, 1–10 merkkiä. |
| vettingId | Palveluntarjoajan todellinen arviointitapahtuman tunnus, enintään 255 merkkiä. Älä korvaa sitä brändin tunnuksella äläkä keksi tunnusta itse. |
| vettingToken | Vahvistustunniste, jos palveluntarjoaja vaatii sen, enintään 65535 merkkiä. Käsittele sitä salaisuutena ja jätä se pois, jos palveluntarjoaja ei vaadi sitä. |
Luo vetting-import.json käyttämällä palveluntarjoajan todellisia arvoja. Älä lähetä vain vastauksissa esiintyviä pistemäärä-, tila- tai aikaleimakenttiä ikään kuin ne voisivat muuttaa tulosta.
Tuo tulos kerran
curl --silent --show-error --fail-with-body --user "$API_USER:$API_PASSWORD" \
--request PUT \
--header 'Content-Type: application/json' \
--header "Idempotency-Key: $IDEMPOTENCY_KEY" \
--data-binary @vetting-import.json \
"https://api.multitel.net/tcr/v2/brand/$BRAND_ID/externalVetting"Huomioi aiemmat veloitukset
Tämä välityspalvelu ei kirjaa juuri tuotua tulosta uutena maksullisena tilauksena. Tämä ei peru aiemmin tilattua arviointia: jos samalla vettingId-tunnuksella on jo tulosta tai veloitusta odottava tilaus, tilassa ACTIVE tai FAILED olevan tuloksen tuonti voi johtaa tilaukselle tallennetun maksun veloittamiseen. Tämä synkronointihaara ei veloita aiemmin veloitettua tietuetta uudelleen.
Seuraa todellista lopputulosta
Onnistunut HTTP-vastaus voi sisältää keskeneräisen arviointitietueen. Säilytä sen vettingId ja tarkista vettingStatus, syyt, pistemäärä sekä voimassaolon alkamis- ja päättymispäivät siltä osin kuin ne ovat saatavilla. PENDING ja UNSCORE edellyttävät jatkoseurantaa; ACTIVE, FAILED ja EXPIRED kuvaavat erilaisia lopputuloksia. Pelkkä HTTP-tason hyväksyntä ei osoita suotuisaa pistemäärää tai kelpoisuutta kampanjaan.
Käytä ulkoisen arvioinnin tilatietoja tietueen seuraamiseen. Lopullisen tuloksen lukeminen tai tuonti voi johtaa aiemman maksullisen tilauksen maksun veloittamiseen; toimenpide ei välttämättä ole vapaa aiemmasta avoimesta maksusta.
Yritä samaa tarkoitettua pyyntöä uudelleen
Käytä yhtä Idempotency-Key-avainta kutakin tarkoitettua toimintoa kohden ja säilytä menetelmä, polku, kysely ja rungon tavut täsmälleen samoina. Avaimet tukevat 1–128 tulostettavaa ASCII-merkkiä ilman välilyöntejä. Keskeneräisen pyynnön kaksoiskappale voi palauttaa vastauksen 409 ja Retry-After-otsakkeen. Valmiista pyynnöistä palautetaan uudelleen tallennettu vastaus virheineen. Noudata pyyntötiheyden rajoituksia.
Tiedonsiirtovirhettä voi seurata välimuistiin tallennettu 502-vastaus. Välimuistiin tallennettu 500-vastaus, joka sisältää requestId-tunnuksen, voi tarkoittaa, että rekisteri hyväksyi toiminnon mutta paikallinen pysyvä tallennus tai laskutus epäonnistui. Säilytä pyynnön tunnus, tarkista nykyiset tietueet ja selvitä tilanne tuen kanssa ennen uuden avaimen käyttöä. Älä oleta virheen tarkoittavan, ettei tilausta ole olemassa.