开发者指南 金蝶云・星辰 API 集成与扩展开发

鉴权流程（4 步）

1. 1 在金蝶云·星辰开放平台后台申请应用，获取 app_key 与 app_secret
2. 2 引导用户在授权页同意后回调拿到 code，再换取 access_token（有效期 2 小时）
3. 3 调用业务接口时在 Header 携带 access_token，并按接口要求传入 accountId / tenantId
4. 4 过期前 30 min 用 refresh_token 静默续签，避免业务调用中断

curl 示例（获取 access_token）

# 1. 用授权码换 access_token
curl -X POST https://openapi.kingdee.com/koas/APP000041/api/oauth2/access_token \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=authorization_code" \
  -d "app_key=YOUR_APP_KEY" \
  -d "app_secret=YOUR_APP_SECRET" \
  -d "code=USER_AUTH_CODE"

# 返回
# {
#   "access_token": "xxx",
#   "refresh_token": "yyy",
#   "expires_in": 7200,
#   "accountId": "123456"
# }

# 2. 携带 token 调用业务接口
curl -X GET https://openapi.kingdee.com/jdy/v2/scm/inv_real_qty \
  -H "Access-Token: xxx" \
  -H "X-Account-Id: 123456"

具体 endpoint 与字段以 官方鉴权文档为准