金蝶雲・星辰 開發者指南

鑑權流程（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 與欄位以 官方鑑權文件為準