快速开始

1. 准备凭证

从 客户后台 获取账户的 API Key 和 API Secret。凭证只应保存在服务端，不要写入浏览器代码、移动应用或公开仓库。

2. 获取访问令牌

curl --request POST \
  --url https://api.sandbox.glacix.io/api/open/v1/auth/token \
  --header 'Content-Type: application/json' \
  --header 'X-Request-Id: 550e8400-e29b-41d4-a716-446655440000' \
  --data '{
    "api_key": "YOUR_API_KEY",
    "api_secret": "YOUR_API_SECRET"
  }'

成功响应的 data 包含 access_token、token_type 和以秒为单位的 expires_in。完整字段见 认证授权。

3. 发起业务请求

curl --request GET \
  --url 'https://api.sandbox.glacix.io/api/open/v1/account/issuing/balance' \
  --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  --header 'X-Request-Id: 550e8400-e29b-41d4-a716-446655440001'

为每次请求生成唯一的 X-Request-Id，并在日志中保留它，以便定位请求。

4. 选择业务流程

• 发卡：创建持卡人，完成 KYC，查询卡产品并创建卡片。

• 异步通知：接入 Webhooks，按事件类型处理最终状态。

具体字段、枚举和响应模型以 API 参考 为准。