快速开始

欢迎使用京诚凭证系统开放接口。本指南帮助您用 AppId 和密钥 快速接入并调用所有接口。

接入概述

京诚凭证系统采用 AppId + 密钥 的认证方式，无需先请求 token：

1. 获取由澄心科技分配的 AppId 和 密钥（secret）
2. 在每一个接口的请求头里带上：Authorization: Basic Base64(appId:密钥)
3. 即可直接调用 合同生成、征信查询、征信上报、大数据查询 等全部开放接口

一句话总结

用 AppId 和密钥拼出 Authorization（Basic + Base64(appId:密钥)），所有接口都带这个请求头即可调用。

第一步：获取 AppId 和密钥

请联系澄心科技商务或技术支持，申请接入并获取：

• AppId：应用唯一标识
• 密钥（secret）：用于认证，请妥善保管，切勿泄露或写入前端代码

第二步：拼出 Authorization 并调用接口

拼法：先把 appId 和 密钥 拼成一行 appId:密钥（中间英文冒号），再对这一整串做 Base64 编码，请求头写：

Authorization: Basic {Base64结果}

例如：appId = my_app_001，密钥 = my_secret_123
→ 拼成 my_app_001:my_secret_123
→ Base64 后得到 bXlfYXBwXzAwMTpteV9zZWNyZXRfMTIz
→ 请求头：Authorization: Basic bXlfYXBwXzAwMTpteV9zZWNyZXRfMTIz

之后所有业务接口都带这一个请求头即可，无需再调「获取 token」接口。

能力	说明	文档链接
合同生成	基于模板生成、签署电子合同	合同生成接口
征信查询	查询个人/企业征信信息	征信查询接口
征信上报	上报征信相关数据	征信上报接口
大数据查询	大数据多维查询与检索	大数据查询接口

详细拼法、多语言示例和 grant_type 必传 说明（如需调 token 接口）见 认证说明。

通用响应格式

所有接口统一返回格式：

{
  "code": 0,
  "data": { },
  "msg": "success"
}

• code 为 0 表示成功，非 0 为业务或系统错误码
• data 为具体业务数据
• msg 为提示信息

下一步

• 认证说明：Authorization 拼法、各语言示例、grant_type 说明
• API 概述：全部接口列表与规范