API 呼び出し権限の追加

​

適用対象

• 社内アプリ：企業が自社で開発し、自社内のみで使用するアプリです。組織内部のシステム統合シーンに適しています。
• サードパーティ社内アプリ：ISV（独立系ソフトウェアベンダー）が開発し、複数の企業顧客がインストールして利用するサービス型アプリです。
• サードパーティ個人アプリ：プロダクトソリューションプロバイダーの開発者が開発し、DingTalk 上の個人ユーザーに提供するアプリです。

​

機能概要

​

前提条件

1. アプリタイプが社内アプリ、サードパーティ社内アプリまたはサードパーティ個人アプリであり、開発者バックエンドで作成済みであること。
2. 現在ログイン中のアカウントが、該当アプリの管理権限（通常は組織管理者またはアプリ責任者）を保有していること。
3. 企業の認証が完了していること（一部の特殊な API は企業の実名認証完了後にのみ申請可能です）。
4. API 呼び出しの認証に使用するアプリの AppKey と AppSecret を取得し、適切に設定していること。

​

一般的な API 呼び出し権限の追加

1. API ドキュメントで、対象 API ドキュメントの権限セクションにある権限スコープをコピーします。
2. 開発者バックエンドにログインします。
3. アプリ開発ページで、対象アプリをクリックしてアプリ詳細ページに移動します。
4. アプリ詳細ページで権限管理をクリックし、コピーした権限スコープを検索して権限をリクエストをクリックします。

​

特殊な API 呼び出し権限の追加

1. API ドキュメントで、対象 API ドキュメントの権限セクションにある権限スコープをコピーします。
2. 管理者が開発者バックエンドにログインします。
3. アプリ開発ページで、対象アプリをクリックしてアプリ詳細ページに移動します。
4. 権限管理をクリックし、追加したい特殊な API を選択して権限をリクエストをクリックします。
5. 申請理由を入力し、最後に申請をクリックします。 説明
   • API 呼び出し権限の申請は、対応する API の DingTalk 担当者が承認します。承認は通常 1 営業日以内に完了し、承認後はステータスが有効化完了に変わります。
   • 申請が拒否された場合、申請欄で該当の権限エントリを確認し、審査未通過タグにマウスを合わせると具体的な却下理由が表示されます。フィードバックに基づき改善のうえ、再度送信してください。

​

権限不足エラーの解決方法

{
  "Code": "Forbidden.AccessDenied.AccessTokenPermissionDenied",
  "StatusCode": 403,
  "Message": "code: 403, この API を呼び出す権限がありません request id: 8197EFxxxx59D33E58",
  "Data": "{\"AccessDeniedDetail\":{\"requiredScopes\":[\"Contact.Org.Read\"]},\"Code\":\"Forbidden.AccessDenied.AccessTokenPermissionDenied\",\"HostId\":\"dingtalk-inner.aliyuncs.com\",
            \"Message\":\"この API を呼び出す権限がありません\",\"Recommend\":\"https://next.api.aliyun.com/troubleshoot?q=Forbidden.AccessDenied.AccessTokenPermissionDenied\\u0026product=dingtalk\",
            \"RequestId\":\"8197Exxxx88C759D33E58\",\"statusCode\":403}",
  "Stack": null,
  "Description": "\u003cni\u003e",
  "AccessDeniedDetail": {
    "requiredScopes": [
      "Contact.Org.Read"
    ]
  }
}

1. エラーレスポンス内の AccessDeniedDetail にある requiredScopes フィールドの値を抽出します。これが対象 API に必要な権限スコープ Code です。
2. 現在のアプリの権限管理ページで、その権限スコープ Code を検索し、対応する API 権限の有効化を申請します。

​

重要