---
title: 获取调用凭证
description: 使用 appKey、appSecret 换取 V3 接口调用凭证
outline: deep
---

# 获取调用凭证

```http
POST /openapi/v3/query/token
```

说明：使用 `appKey`、`appSecret` 换取接口调用凭证。

请求体：

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| appKey | string | API 账号标识，在管理后台申请获取 |
| appSecret | string | API 密钥，在管理后台申请获取 |
| refresh | string | 是否刷新 token：`1` 强制生成新 token，`0` 或留空时尽量复用已有 token |

请求示例：

```json
{
    "appKey": "example-app-key",
    "appSecret": "example-app-secret"
}
```

响应结构：

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| data.appId | string | 客户组织编码，**后续所有接口请求体中都要传入此值** |
| data.accessToken | string | 接口调用凭证，后续放入 `X-Access-Token` |

::: info 注意：appId ≠ appKey
- **`appKey`**（如 `SDYZ`）只用于获取 token，调用 `/openapi/v3/query/token` 后就不再需要
- **`appId`**（如 `CUS-202601-0001`）由 token 接口返回，后续调用 sim-info 等接口时，请求体中的 `appId` 字段必须填这个值
- 如果传错会导致 `code: 61 "登录已过期"` 错误
:::

响应示例：

```json
{
    "code": 0,
    "message": "",
    "data": {
        "appId": "CUS-202601-0001",
        "accessToken": "example-access-token"
    },
    "error": null
}
```