Hogyan kell bejelentkezni api
Egy másik fontos szempont a protokoll az élettartama a hozzáférési tokent. Kézhezvételét követően a token semmilyen módon, egy válasz mellett a hozzáférési token lesz jelen, és a területén expires_in refresh_token. Az első arra az időre utal a token élettartama másodpercben. Az API myTarget szabványos élettartam egyenlő 86.400 másodperc, amely megfelel egy nap. Ebben az időszakban, akkor lehet, hogy a különböző API-kéréssel ezzel jelzőt. Lejártakor az élet, a lekérdezés egy hibaüzenet, amely szerint a token már nem érvényes. Ahhoz, hogy egy új kérelmet nem kell, hogy egy újat, akkor frissíteni kell a token a futás a parancsot:
POST /api/v2/oauth2/token.json HTTP / 1.1
Host: target.my.com
Content-Type: application / x-www-form-urlencoded
grant_type = refresh_tokenrefresh_token = client_id = client_secret =
Frissítése a token nem hoz létre egy új példányt, de csak megváltoztatja a húr gombot. Ez a helyes módja, hogy használja az API. Megjegyezzük, hogy ésszerűtlen generációs új jelzőt (frissítése helyett) tekintik hibás munka az API és vezethet tilalmat, hogy az API.
Token automatikusan törlődnek egy hónap után inaktivitás (lejárat expires_in).
Amikor elérte a határértéket válaszul egy kísérletet, hogy egy új tokent ad vissza hibakódot a http-403.
Ahhoz, hogy elkerüljük az ilyen hibákat, meg kell, hogy megfelelően frissíti a rajzolt zsetont, és ne okozzanak nekik felesleges másolatokat.
Ajánlott irodalom:
Ahhoz, hogy a hozzáférés-token, meg kell küldeni a parancsot:
POST /api/v2/oauth2/token.json HTTP / 1.1
Host: target.my.com
Content-Type: application / x-www-form-urlencoded
grant_type = client_credentialsclient_id = client_secret =
Keys client_id client_secret és állíthatók elő kérelmet küldenek csatlakozni az API.
Ha sikeres, a válasz a következő lesz:
Továbbá a kapott hozzáférési token lehet használni kérések küldésére az API target.my.com. Token jelzett érték a cím Engedélyezési. Mielőtt token meg kell határoznia, hogy milyen típusú Csatorna:
GET /api/v2/campaigns.json HTTP / 1.1
Host: target.my.com
Engedély: Bemutatóra szóló
A kérés egy jelképes e rendszer a következőképpen néz ki:
POST /api/v2/oauth2/token.json HTTP / 1.1
Host: target.my.com
Content-Type: application / x-www-form-urlencoded
grant_type = agency_client_credentialsclient_id = client_secret = agency_client_name =
A válasz ugyanaz lenne, mint a kérelemben az ügyfél bizonyítványok Grant rendszer.
Így annak érdekében, hogy hozzáférjen az ügyfél a hivatal, kövesse az alábbi lépéseket:
Ennek megfelelően, ha a hozzáférést más ügyfél adatait, majd ismételje meg a harmadik lépésben a kliens bejelentkezést.
Alkalmazások, amelyek szolgáltatást dolgozni myTarget harmadik fél ügyfelek használja a rendszer jogosultsági kód Grant.
3. Az alkalmazási kódot csere hozzáférési token kérelem útján
POST /api/v2/oauth2/token.json HTTP / 1.1
Host: target.my.com
Content-Type: application / x-www-form-urlencoded
POST /api/v2/oauth2/token.json HTTP / 1.1
Host: target.my.com
Content-Type: application / x-www-form-urlencoded
grant_type = agency_client_credentialsclient_id = client_secret = agency_client_name = access_token =
Ezzel szemben a kérelem nevében a hivatal, ezen lekérdezés, az alkalmazás meg kell adnia mellett saját client_id client_secret és a access_token után kapott ügynökség hozzáférést az alkalmazás.