認証
TI の API は OAuth 2.0 を使用してセキュア化されているので、これらの API に対して要求を送信するときにアクセス・トークンを渡す必要があります。アクセス・トークンを取得するには、OAuth API を呼び出します。
- サンドボックス [正式運用開始前]: https://transact-pre.ti.com/v1/oauth/accesstoken
- 正式運用: https://transact.ti.com/v1/oauth/accesstoken
要求を成功させるには、次の点に注意してください。
- TI はクライアント資格情報フローを使用します
- 「Content-Type」 (コンテンツの種類) は「application/x-www-form-urlencoded」にする必要があります
- 追加のクエリ・パラメータを使用せずに、要求を上記の適切な URL 宛に送信する必要があります
- 要求パラメータ (grant_type、client_id、client_secret) は、"&" 記号で区切り、追加のエンコードを行わず、要求本文の中に記述する必要があります。
次に例を示します。"grant_type=client_credentials&client_id=[CLIENT_ID]&client_secret=[CLIENT_SECRET]" - アクセス・トークンの有効な期間は 60 分です。他の API でトークンを使用する前に、このアクセス・トークンが期限切れになっているかどうかを確認してください
curl --request POST \
--url https://transact.ti.com/v1/oauth/accesstoken \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data grant_type=client_credentials \
--data client_id=XXXXXXXXXXXXXXXXX \
--data client_secret=XXXXXXXXXXXXXXXXX
要求が成功した場合の応答:
{
"access_token": "MTQ0NjJkZmQ5OTM2NDE1ZTZjNGZmZjI3",
"token_type": "bearer",
"expires_in": 3599,
"scope": "",
"application_name": "app_name",
"developer.email": "api-portal@list.ti.com",
"issued_at": "1582220284531",
"client_id": "IwOGYzYTlmM2YxOTQ5MGE3YmNmMDFkNTVk"
}
Insomnia クライアントからアクセス・トークンを要求する場合のペイロードとヘッダーの例: