快速开始
获取服务端 Token,并完成第一次 Dibin OpenAPI 请求。
Base URL
所有公开接口均使用 HTTPS:
https://api.dibinos.cn1. 获取 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 或后端代码完成联调。