接口凭证获取 #api-base

用于生成调用开放平台的接口凭证，为第三方应用或合作伙伴生成访问并调用本开放平台API接口所必需的安全凭证

• 请求方式 POST
• Headers Content-Type: application/json

正式环境	测试环境
https://api.linkingopen.com/service/base/app/auth/token/get	https://api.linkingopen.com/test/base/app/auth/token/get

Headers 中放入以下字段

名称	描述	类型	必填
appKey	开放平台应用密钥	String	是

请求参数

名称	描述	类型	必填
appId	开放平台应用ID	String	是

返回参数

名称	描述	类型	必填
bizContent	患者摘要	bizContent	是

bizContent -> appToken

名称	描述	类型	必填
token	应用凭证	String	是
expireTime	凭证过期时间	DateTime	是

接口示例

参数示例

请求参数

POST https://api.linkingopen.com/base/app/auth/token/get
Content-Type: application/json
appKey: 123***************

//body 传入参数
{
  "appId" : "c01*******************"
}

返回参数

{
  "code": 1,
  "message": "操作成功",
  "bizContent": {
    "appToken": {
      "token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJhdWQiOiJsaW5raW5nU2VydmljZSIsImxvZ2luSWQiOiIxNGYxZDJhMS1kZWMwLTQyOGMtOThjMy0xNzZlYzE5NWQ3YjciLCJhcHBOYW1lIjoi6Jm55Y-j56S-5Yy65LqS6IGU572R5Yy76ZmiIiwiYXBwSWQiOiJkZTg2Y2Y1MS1iYmIzLTRjZDYtYTE2MC05ODVlMGIwMWY5NDMiLCJpc3MiOiJsaW5raW5nb3BlbiIsImV4cCI6MTc1NTc2OTc2OSwib3JnSWQiOiJkZTg2Y2Y1MS1iYmIzLTRjZDYtYTE2MC05ODVlMGIwMWY5NDMiLCJleHBEYXRlIjoiMjAyNS0wOC0yMVQxNzo0OToyOS4wODk4MDE1MzQifQ.zvkOechmjdhELZgbZZShe8i30vLdVLkAHhOkhETLDP4",
      "expireTime": "2025-08-21T17:49:29.089801534"
    }
  }
}

常见业务状态码

错误码	描述	解决方案
SYSTEM_ERROR	系统繁忙	服务器异常 可能发生了网络或者系统异常，导致服务调用失败，商户可以用同样的请求发起重试
INVALID_PARAMETER	参数有误	请根据接口返回的参数非法的具体错误信息，修改参数后进行重试
APP_NOT_ONLINE	小程序未处于上架状态	小程序上架状态再操作