Користите бренд за размену порука који припада налогу
Користите омогућен API налог преко HTTPS са дозвољене изворне IP адресе. Подржане су Basic и Bearer аутентификација. Идентификатор бренда мора припадати том налогу. Чувајте токене пружаоца услуге, податке о идентитету бренда и враћене извештаје као поверљиве.
Користите постојећи резултат пружаоца услуге
Користите PUT да бисте повезали постојећи резултат провере подржаног пружаоца услуге са својим брендом. Тиме се не наручује нова провера. Прибавите исправан идентификатор трансакције пружаоца услуге и евентуални токен за потврду директно од тог пружаоца и уверите се да се извештај односи на исти пословни субјект.
AUTHPLUS не подржава овај поступак увоза. Правила подударања специфична за пружаоца услуге и даље важе; захтев за увоз их не укида нити гарантује испуњавање услова за сваку намену кампање.
Припремите увоз
| Поље | Вредност |
|---|---|
| evpId | Идентификатор подржаног пружаоца услуге, 1–10 знакова. |
| vettingId | Стварни идентификатор трансакције провере код пружаоца услуге, до 255 знакова. Немојте уместо њега користити идентификатор бренда нити измишљати идентификатор. |
| vettingToken | Токен за потврду када га пружалац услуге захтева, до 65535 знакова. Чувајте га као тајну и изоставите га када га пружалац услуге не захтева. |
Направите vetting-import.json користећи стварне вредности пружаоца услуге. Немојте слати поља оцене, статуса или временске ознаке која се појављују само у одговору као да би могла да промене резултат.
Увезите резултат једном
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"Упознајте се са постојећим наплатама
Овај посреднички сервис не евидентира новоувезени резултат као нову наруџбину која се наплаћује. То не отказује претходно наручену проверу: када за исти vettingId већ постоји наруџбина која чека резултат или наплату, увоз резултата са статусом ACTIVE или FAILED може довести до наплате њене сачуване накнаде. Ова грана синхронизације не наплаћује поново запис који је већ наплаћен.
Пратите стварни исход
Успешан HTTP одговор може садржати запис о провери која је још на чекању. Сачувајте његов vettingId и прегледајте vettingStatus, разлоге, оцену и датуме почетка и истека важења, ако су доступни. PENDING и UNSCORE захтевају даље праћење; ACTIVE, FAILED и EXPIRED описују различите исходе. Само прихватање на нивоу HTTP не доказује повољну оцену нити испуњавање услова за кампању.
Користите статус спољне провере да бисте пратили запис. Читање или увоз коначног резултата може довести до наплате раније наруџбине која се наплаћује; то није нужно ослобођено постојеће неизмирене накнаде.
Поновите исти намеравани захтев
Користите један Idempotency-Key за сваку намеравану операцију и сачувајте потпуно исти метод, путању, упит и бајтове тела захтева. Кључеви подржавају 1–128 штампљивих ASCII знакова без размака. Дупликат захтева чија је обрада у току може вратити 409 са Retry-After. За завршене захтеве поново се враћа њихов сачувани одговор, укључујући грешке. Поштујте ограничења учесталости захтева.
Кеширани одговор 502 може уследити након грешке у преносу. Кеширани одговор 500 са requestId може значити да је регистар прихватио операцију, али да локално трајно чување или наплата нису успели. Сачувајте идентификатор захтева, прегледајте тренутне записе и разјасните стање уз помоћ подршке пре него што употребите нови кључ. Немојте претпостављати да грешка значи да наруџбина не постоји.