鉴权方式

所有服务端接口均通过 access_token 鉴权，token 有效期 2 小时，请在失效前刷新。

请求规范

• 统一使用 HTTPS，编码 UTF-8
• POST 请求 Content-Type: application/json
• 时间戳参数均为秒级

通用错误码

接口清单

消息接口

发送单聊、群聊消息，支持文本、图片、卡片等类型。

通讯录接口

同步部门与成员信息，支持增量拉取。

{
  "errcode": 0,
  "errmsg": "ok",
  "data": {
    "user_id": "zhangsan",
    "name": "张三"
  }
}

调用示例

$ch = curl_init("https://api.example.com/v1/message/send");
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($payload));
curl_setopt($ch, CURLOPT_HTTPHEADER, array("Authorization: Bearer " . $token));
$result = curl_exec($ch);