メインコンテンツへ移動

tpapp

サードパーティアプリケーション​

この機能は、HAPをアイデンティティ認証センターとして活用し、サードパーティアプリケーションをHAPから外部アプリケーションへの入口として作成するユースケースを想定しています。認証プロセスはOAuth 2.0プロトコルに基づいています。

1. アプリケーションの作成​

組織管理者 》 インテグレーション 》 サードパーティアプリケーション にアクセスし、アプリケーションを作成します（ホームページの左下から作成済みアプリケーションの一覧もご覧いただけます）。

2. リクエスト認証コードの取得​

リクエスト例（GET）：
{HAP アクセスアドレス}/api/oauth2/authorize?app_key=441139F6ADFA&redirect_uri=http://www.baidu.com&projectid=f0dc6a74-854a-46cb-ab8c-909b7846d34c リクエストパラメーター:

  • app_key: アプリケーションのApp Key
  • redirect_uri: アプリケーションのコールバックアドレス
  • projectid: HAP内の組織ID

3. アクセストークンの取得​

リクエストパラメーター:

  • app_key: App Key
  • app_secret: App Secret
  • grant_type: 固定値 authorization_code
  • code: 前のステップで取得したリクエスト認証コード
  • redirect_uri: アプリケーションのコールバックURL
  • format: json（デフォルトはXML形式で返却されます） リクエスト例（GET）：
    {HAP アクセスアドレス}/api/oauth2/access_token?app_key=441139F6ADFA&app_secret=6188275EF965388891B3618BD9398A&grant_type=authorization_code&code=f8a6f0ffb8d249499f4e7c332d2446c4&redirect_uri=http://www.baidu.com&format=json リクエスト結果:
{
    "access_token": "9h9kapa********",
    "expires_in": "604800",
    "refresh_token": "00b100b5********",
    "success": true
}

4. 現在のアカウント情報の取得​

リクエスト例（GET）：
{HAP アクセスアドレス}/api/v1/passport/get_passport_detail?access_token=9h9kapa******** 主なレスポンス（主要フィールド）:

{
    "data": {
        "user_id": "string",
        "full_name": "string",
        "account_id": "string",
        "project_id": "string",
        "email": "string",
        "mobile_phone": "string",
        "department": "string",
        "job": "string",
        "job_number": "string",
        "work_site": "string",
        "contact_phone": "string"
    },
    "success": true,
    "error_code": 1
}

フィールドの説明：

フィールド意味
user_idユーザーID。同じアカウントでも組織ごとに異なります
full_name氏名
account_idアカウントID。同じアカウントであれば組織が異なっても同一です
project_id組織ID
emailメールアドレス
mobile_phone携帯電話番号
department部署
job役職
job_number社員番号
work_site勤務地
contact_phone勤務先電話番号