概述（接入凭证与开发者配置）

​

📄 正文

​

凭证配发：apiKey / secretKey

• 沙盒环境：请直接联系 DCS 团队获取 apiKey / secretKey。
• 生产环境：走”安全邮箱 + 一次性提取链接”流程（见下方生产环境凭证的安全提取），避免凭证在传递过程中泄露给第三方。

凭证如何参与请求签名（X-DAPI-API-KEY / X-DAPI-SIGN / X-DAPI-TIMESTAMP / X-DAPI-NONCE、HmacSHA256 签名规则）请参阅 接入资源 › 鉴权指南。

​

生产环境凭证的安全提取

1. 向 DCS 团队提供：一个安全邮箱地址（接收提取流程）+ 一个提取请求 IP（将被加入提取白名单）。
2. 安全邮箱会收到 DCS 发送的邮件，其中包含一个临时安全链接（仅一次提取有效）。
3. 将 extractUrl 与 extractSecretKey 拼接后，在指定机器上执行，即可提取到 apiKey / secretKey。

{
  "code": "SYS_SUCCESS",
  "message": null,
  "messageDetail": null,
  "data": {
    "expireTime": "<EXPIRE_TIME>",
    "extractSecretKey": "<EXTRACT_SECRET_KEY>",
    "extractUrl": "https://<DECARD_DOMAIN>/internal/open-api/v1/secret-extract/",
    "howToUse": "Please concatenate the url with the secret-key and execute it on the specified machine.",
    "notes": "This link is only valid for one AKSK extraction. If the content is not properly accessed, the AKSK may have been compromised, please contact us promptly."
  }
}

响应结构：全站统一为 {code, message, messageDetail, data}，成功码字面量为 SYS_SUCCESS，不含 success 布尔字段。 安全提示：临时链接仅可提取一次。若未能成功提取到凭证，说明链接可能已被他人使用、密钥存在泄露风险，请立即与 DCS 商务沟通后重新发起邮件。

​

接口白名单（IP Whitelisting）

• 沙盒环境出口 IP
• 生产环境出口 IP

IP 白名单的更多说明（多地址、变更流程等）见 接入资源 › IP 白名单。

​

Webhook 配置

1. 实现接收端：暴露一个 POST 接口，支持 application/json、2 秒内返回 200 OK（其他状态码触发重试）。
2. 同步 DCS 团队配置：将您的回调 URL（必须为 HTTPS、公网可访问）同步给 DCS 团队，由 DCS 完成配置。
3. 验证与上线：在 UAT 环境验证通过后上线。

​

配发与上线时序

​

下一步

• 完成凭证配发与签名鉴权：接入资源 › 鉴权指南
• 登记接口白名单：接入资源 › IP 白名单
• 配置事件回调：接入资源 › Webhook 与 WebSocket 实时通知