快速开始
用企企 OpenAPI 按开放对象读写业务数据。本文走 v1(Open-Id)完成一次客户列表查询;细节链到对应文档,不必在本页全部展开。
默认接口域名:https://api2.77hub.com。本地化部署时以实际配置为准,见 公告。
选择接入方式
| 方式 | 适用 | 鉴权 |
|---|---|---|
| v1 / Open-Id | 大多数对接,本文默认 | Header 带 Access-Key-Id、Open-Id,并做 AWS 签名;使用 Java SDK 时无需自己签名 |
| v2 / OAuth2 | 已有 IDPS 自建应用 | Header 带 Authorization(id_token / access_token) |
完整流程见 接入流程。
获取凭证
- 密钥:把应用名称提供给企企管理员,线下拿到
accessKeyId和secretAccessKey。详见 获取密钥。 - Open-Id:用户授权一次即可,长期有效。授权带截图的步骤见 openapi 准备工作,参数说明见 获取 openid。
获取 SDK
- Java SDK、PHP 签名示例:SDK 下载
- Java 客户端构建与配置:Java SDK 使用说明
- 其他语言:按 接口签名 自行签名后调用 HTTP 接口
对象标准接口的请求 body 固定为 {"json":"<接口参数 JSON 字符串>"}。字段与示例见 接口列表 v1 和 数据字典。