Важен аспект на протокола е на жизнения цикъл на означението за достъп. При получаване на маркера по някакъв начин, в отговор освен означението за достъп, ще присъства и refresh_token поле expires_in. Първият се отнася до момента, в който символично живот в секунди. Стандартният живот API myTarget равна на 86,400 секунди, което съответства на един ден. През този период, можете да направите различни искания към API, използващи този знак. При изтичане на живота, заявката връща съобщение за грешка, че белегът вече не е валидна. За да направи ново искане не е необходимо да получите нова, трябва да актуализирате маркера с командата:
POST /api/v2/oauth2/token.json HTTP / 1.1
Водещ: target.my.com
Content-Type: заявление / х-WWW-форма-urlencoded
grant_type = refresh_tokenrefresh_token = client_id = client_secret =
Актуализиране на маркера не създава ново копие на това, но се променя само клавиша низ. Това е най-правилния начин за използване на API. Имайте предвид, че неразумно поколение на нови жетони (вместо актуализиране) се счита за неправилна работа с приложния програмен интерфейс и може да доведе до забрана за достъп до API.
Знаците се изтриват автоматично след един месец на неактивност (изтичане expires_in).
При достигане на лимита в отговор на опит да се получи нов знак ще се върне код за грешка на HTTP-403.
За да се избегнат тези грешки, трябва да актуализирате правилно изготвени символи, а не ги създават излишни копия.
Препоръчителна четене:
За да получите достъп-логика е необходимо да изпратите команда:
POST /api/v2/oauth2/token.json HTTP / 1.1
Водещ: target.my.com
Content-Type: заявление / х-WWW-форма-urlencoded
grant_type = client_credentialsclient_id = client_secret =
Ключове CLIENT_ID client_secret и могат да бъдат получени чрез изпращане на искане за свързване с API.
При успех, отговорът ще бъде, както следва:
Освен това, получава достъп-означение може да се използва за изпращане на заявки към target.my.com на API. Token стойност посочено в разрешението, посочено в заглавието. Преди знак трябва да се определи видът на приносител:
GET /api/v2/campaigns.json HTTP / 1.1
Водещ: target.my.com
Разрешение: Носител
Искането за знак на тази схема ще изглежда така:
POST /api/v2/oauth2/token.json HTTP / 1.1
Водещ: target.my.com
Content-Type: заявление / х-WWW-форма-urlencoded
grant_type = agency_client_credentialsclient_id = client_secret = agency_client_name =
Отговорът ще бъде същата като в искането се използва схемата за безвъзмездна помощ на клиента на идентификационни данни.
По този начин, за да получат достъп до клиента на агенцията, изпълнете следните стъпки:
Съответно, ако друг достъп до данните на клиента, а след това се повтаря третата стъпка за този клиент за вход.
Приложения, които предоставят услуга за работа с myTarget за клиенти трети страни трябва да използват схемата Разрешение Код Грант.
3. Кодът на заявление за замяна на достъп чрез заявката за означение
POST /api/v2/oauth2/token.json HTTP / 1.1
Водещ: target.my.com
Content-Type: заявление / х-WWW-форма-urlencoded
POST /api/v2/oauth2/token.json HTTP / 1.1
Водещ: target.my.com
Content-Type: заявление / х-WWW-форма-urlencoded
grant_type = agency_client_credentialsclient_id = client_secret = agency_client_name = access_token =
За разлика от искането от името на агенцията, в тази заявка, заявката ще трябва да се посочи в допълнение към собствената си client_id client_secret и повече и access_token, получена след достъп на агенцията до вашата кандидатура.