D黑奴背锅 文档中心

快速开始

获取服务端 Token,并完成第一次 Dibin OpenAPI 请求。

Base URL

所有公开接口均使用 HTTPS:

https://api.dibinos.cn

1. 获取 Access Token

在开发者控制台创建应用并取得 Client ID 与 Client Secret 后,在服务端请求 Token:

curl -X POST https://api.dibinos.cn/oauth/token \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -u "CLIENT_ID:CLIENT_SECRET" \
  -d "grant_type=client_credentials" \
  -d "scope=openapi"
{
  "access_token": "eyJ...",
  "token_type": "Bearer",
  "expires_in": 3600,
  "scope": "openapi"
}

Client Secret 只能保存在服务端。建议按 expires_in 缓存 Access Token,过期后重新获取。

2. 发起第一次请求

curl "https://api.dibinos.cn/openapi/v1/calendar/get_holiday?year=2026" \
  -H "Authorization: Bearer ACCESS_TOKEN"

3. 读取响应

{
  "code": 0,
  "message": "获取节假日数据成功",
  "data": [
    {
      "name": "端午节",
      "date": "2026-06-19",
      "isOffDay": true
    }
  ],
  "time": 1779502528
}
  • code 为业务状态码,成功时通常为 0
  • message 为结果说明。
  • data 为接口数据,具体结构以对应接口参考为准。
  • time 为服务端时间戳。

接口调试器初期保持关闭,避免在浏览器中持久化真实 Bearer Token。请使用 cURL、Postman 或后端代码完成联调。

On this page