Milesight Development Platformとアプリケーション間の安全でスムーズな通信を確保するため、アクセス トークンが有効期限切れになる前に更新する必要があります。
リクエスト URL
POST {base_url}/oauth/token
リクエスト パラメーター
パラメーター | 必須 | タイプ | 説明 |
---|---|---|---|
refresh_token | Yes | 文字列 | 最新の refresh_token 値 |
grant_type | Yes | 文字列 | アクセス トークンを更新するための OAuth グラント タイプ。
有効な値: |
レスポンスパラメーター
パラメーター | タイプ | 説明 |
---|---|---|
data | オブジェクト<Token_Details> | リクエストされたトークンの詳細。 |
status | 文字列 | APIリクエストの結果。
|
requestId | 文字列 | リクエストの一意のID。リクエストを迅速に特定するために使用できます。 |
- Token_Details
-
パラメーター タイプ 説明 access_token 文字列 新しいアクセス トークン。 refresh_token 文字列 新しいリフレッシュ トークン。 expires_in 整数 新しいアクセス トークンの残りの有効期間(単位: 秒)。 refresh_token_expires_in 整数 整数 新しいリフレッシュ トークンの残りの有効期間(単位: 秒)。
例
- リクエスト例
-
- アクセス トークンをリフレッシュします。
POST /oauth/token HTTP/1.1 Host: demo.milesight.com Content-Type: x-www-form-urlencoded refresh_token=eyJhbGciOiJSUzIxxxxxxxxxxx&grant_type=refresh_token
- レスポンス例
-
HTTP/1.1 200 OK { "data": { "access_token": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCIsImtpZCI6InllYXN0b25lLWRlZmF1bHQta2V5LWlkIn0.eyJncmFudF90eXBlIjoiY2xpZW50X2NyZWRlbnRpYWxzIiwic2NvcGUiOlsib3BlbmFwaSJdLCJjbGllbnRfZXh0Ijp7ImFwcF9pZCI6IjE3MzQ0NzUwODY0NjY2MDA5NjIifSwiZXhwIjoxNzAyNDYxNDM3LCJhdXRob3JpdGllcyI6WyJST0xFX0NMSUVOVCJdLCJqdGkiOiIwNWNjN2RjYS1jNGZkLTQ1M2ItYTZmYy01ZWI1YWQ1MTdiM2UiLCJjbGllbnRfaWQiOiJlZTZhZDY1MC03ZDMzLTQxNGQtYmFmYi0wODM3YjNlMzQzMWQiLCJ0cyI6MTcwMjQ1NzgzNzk4MH0.WeEy_eq9Y8fKzrSx4mAIkJfIuu9MCwjGW8XrQ0Z28eAP5jD_WblhnN6T7oGrgvL1fnmol3KDCqeKLVR6QUuuYrTDEICc_ZFGOY_WvLGgRpmstu86V1J0uY3HupAHQI54Up1nrtnxxxxxxxxxxxxxxxxxxxxxxxxx", "refresh_token": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCIsImtpZCI6InllYXN0b25lLWRlZmF1bHQta2V5LWlkIn0.eyJncmFudF90eXBlIjoiY2xpZW50X2NyZWRlbnRpYWxzIiwic2NvcGUiOlsib3BlbmFwaSJdLCJjbGllbnRfZXh0Ijp7ImFwcF9pZCI6IjE3MzQ0NzUwODY0NjY2MDA5NjIifSwiYXRpIjoiMDVjYzdkY2EtYzRmZC00NTNiLWE2ZmMtNWViNWFkNTE3YjNlIiwiZXhwIjoxNzA1MDQ5NjQ1LCJhdXRob3JpdGllcyI6WyJST0xFX0NMSUVOVCJdLCJqdGkiOiJmNTc3YjI0NS1mOWZiLTQxYjQtOGYyNi1lN2NhMmJjM2RiYmUiLCJjbGllbnRfaWQiOiJlZTZhZDY1MC03ZDMzLTQxNGQtYmFmYi0wODM3YjNlMzQzMWQiLCJ0cyI6MTcwMjQ1NzgzNzk4MH0.dwVoSvuYq3Q9mM0tIvuWeZwchmkr8yjc9rHo7JYBCxrPSJ_uLoONO9HLMwbv4POwJaL2bJynP51_stgL8xxxxxxxxxxxxxxxxxxxxxxxxx", "expires_in": 3599, "refresh_token_expires_in": 2591999 }, "status": "Success", "requestId": "def8e88ab0dd853f4459d9ba5e65e4b4" }
ソリューション / IoT サポート
- ▢3. Milesight開発プラットフォームAPIの概要システムをサードパーティのアプリケーションと統合するためのアプリケーションプログラミングインターフェース (API) を提供しています
- 3.1.1.1 APIリクエスト構造Milesight Development Platform APIのリクエスト構造について説明します
- 3.1.1.2 API レスポンス結果APIリクエストを受信すると、Milesight Development Platformはリクエストの結果を示すHTTPステータスコードと、API呼び出しで要求された情報を含むJSONレスポンスボディを返します。
- 3.1.2 API インターフェース一覧このトピックでは、Milesight Development Platform API のインターフェースの要約リストを提供します。
- 3.1.3.1 API 認証ルールMilesight Development Platform APIは、OAuth 2.0を使用して認証を行い、アプリケーションがMilesight Development Platform上のリソースにアクセスするためのセキュアなトークンを発行します。
- 3.1.3.2 API アクセス トークンの取得アクセス トークンは、認証された API 呼び出しを検証するために使用されます。アプリケーションはまずアクセス トークンをリクエストし、その後、Milesight Development Platform API にアクセスするすべてのリクエストにそのトークンを含める必要があります。
- 3.1.3.3 API アクセス トークンの更新Milesight Development Platformとアプリケーション間の安全でスムーズな通信を確保するため、アクセス トークンが有効期限切れになる前に更新する必要があります。