本ドキュメントの API は旧バージョン仕様のサーバー API です。呼び出し方法については、旧バージョン API VS 新バージョン API をご参照ください。
連絡先関連の API を呼び出す前に、管理者は DingTalk 開発者管理画面 で対応する API 権限を申請し、これらの API が取得できる連絡先スコープを指定する必要があります。下図のように、現在のアプリの access_token は部門 A の連絡先を管理する権限のみを持っています。開発者は本 API を呼び出して、アプリの連絡先権限スコープを確認できます。開発者が連絡先 API を呼び出す際、権限スコープ内の社員の連絡先情報のみ取得でき、権限スコープ外の社員の連絡先情報を取得しようとすると 部門/社員が権限スコープ内にありません というエラーが表示されます。
include "TopSdk.php";date_default_timezone_set('Asia/Shanghai');$c = new DingTalkClient(DingTalkConstant::$CALL_TYPE_OAPI, DingTalkConstant::$METHOD_GET , DingTalkConstant::$FORMAT_JSON);$req = new OapiAuthScopesRequest;$resp = $c->execute($req, $access_token, "https://oapi.dingtalk.io/auth/scopes");
C#
IDingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.io/auth/scopes");OapiAuthScopesRequest req = new OapiAuthScopesRequest();req.SetHttpMethod("GET");OapiAuthScopesResponse rsp = client.Execute(req, access_token);Console.WriteLine(rsp.Body);