BioTech 开放平台文档
简体中文English
输入关键词搜索文档。

获取调用方信息

使用 /openapi/profile 验证 Access Token、接口登记和应用授权。

查看 Markdown在 ChatGPT 中打开在 Claude 中打开

接口信息

项目值
请求方法GET
请求 URLhttps://backend.biotech-mkt.com/openapi/profile
接口路径/openapi/profile
认证方式Bearer Access Token
权限要求接口需启用并授权给当前应用
频控按应用与接口配置
Acceptapplication/json

响应结果

发送请求后，HTTP 状态、耗时和响应内容会显示在这里。

该接口用于联调诊断，返回当前 Access Token 对应的应用和请求上下文。

请求参数

需要 Access Token，并且平台管理员必须将该接口登记、启用并授权给当前应用。

该接口没有查询参数或请求体，只需要以下请求头：

请求头类型必填说明
Authorizationstring是Bearer <access_token>

请求示例

Terminal window
curl "https://backend.biotech-mkt.com/openapi/profile" \
  --header "Authorization: Bearer $OPENAPI_ACCESS_TOKEN"

应答字段

字段返回类型说明
codeinteger业务状态码，成功时为 200
messagestring响应消息
dataobject调用方上下文
app_idintegerOpenAPI 应用内部 ID
app_keystring当前应用的 App Key
app_namestring当前应用名称
token_idinteger当前令牌记录 ID，不是完整令牌
access_expires_atstringAccess Token 绝对过期时间
request_methodstring当前请求方法
request_pathstring当前请求路径

应答示例

json
{
  "code": 200,
  "message": "成功",
  "data": {
    "app_id": 1,
    "app_key": "ak_xxx",
    "app_name": "订单数据应用",
    "token_id": 12,
    "access_expires_at": "2026-08-27 12:00:00",
    "request_method": "GET",
    "request_path": "/openapi/profile"
  }
}

错误码与频控

该接口可能返回 401、403、404、405、429 或 503。频控按“应用 ID + 接口 ID”独立计数；具体处理方式和响应头见错误与频控。

接入验收

首次接入时应确认：

  1. HTTP 状态码和响应 code 都是 200。
  2. app_key 与平台交付的应用一致。
  3. request_method 为 GET，request_path 为 /openapi/profile。
  4. 响应包含 X-Request-Id 和当前接口的频控状态头。

最后更新于 2026年8月27日