メインコンテンツへスキップ
連絡先関連の API を呼び出す前に、連絡先 API 権限を追加する必要があります。本 API を使用して連絡先の権限スコープを取得できます。

API 呼び出し説明

本ドキュメントの API は旧バージョン仕様のサーバー API です。呼び出し方法については、旧バージョン API VS 新バージョン API をご参照ください。
連絡先関連の API を呼び出す前に、管理者は DingTalk 開発者管理画面 で対応する API 権限を申請し、これらの API が取得できる連絡先スコープを指定する必要があります。 下図のように、現在のアプリの access_token は部門 A の連絡先を管理する権限のみを持っています。開発者は本 API を呼び出して、アプリの連絡先権限スコープを確認できます。開発者が連絡先 API を呼び出す際、権限スコープ内の社員の連絡先情報のみ取得でき、権限スコープ外の社員の連絡先情報を取得しようとすると 部門/社員が権限スコープ内にありません というエラーが表示されます。

リクエスト

クエリパラメータ

リクエスト例

Java
Python
PHP
C#

レスポンス

レスポンスボディ

レスポンスボディの例

エラーコード

この API の呼び出し時にエラーが発生した場合は、エラーメッセージをもとに グローバルエラーコード ドキュメントで解決方法を検索してください。