{
"report_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"subject_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"doc_id": "12983319",
"country": "CL",
"subject_type": "person",
"score": 742,
"band": "B",
"verify_code": "Q3fa85f6457174562b3fc2c963f66afa6a1b2c3d4e5f"
}Qscore 信用报告已就绪
通过 POST /v1/qscore/reports 购买的 Qscore 信用报告已成功生成。payload 携带报告标识、生成的评分/等级以及公开的 verify_code(可与主体共享,作为在 GET /verify/qscore/{code} 处的真实性证明)。如果生成失败,报告状态为 failed,不会发出任何事件。当购买的报告对该主体已存在时也会发出此事件 (幂等重用)。
当账户持有人通过 POST /v1/qscore/my-report 生成自助报告时,也会触发同一事件; 此时 payload 会额外包含 purpose: "self_access"(购买的报告没有此字段)。
每次交付都包含 X-Webhook-Event、X-Webhook-Event-ID、X-Webhook-Delivery-ID、X-Webhook-Timestamp 和 X-Webhook-Signature = hex(HMAC-SHA256(secret, timestamp + "." + body))。响应 2xx; 最多 5 次尝试,采用递增退避。
WEBHOOK
risk_report_ready
{
"report_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"subject_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"doc_id": "12983319",
"country": "CL",
"subject_type": "person",
"score": 742,
"band": "B",
"verify_code": "Q3fa85f6457174562b3fc2c963f66afa6a1b2c3d4e5f"
}授权
会话 JWT(来自注册/登录)或 API key(pk_...)。
也接受 X-API-Key: <token> 作为替代请求头。
请求体
application/json
响应
200
返回任何 2xx 以确认交付。
最后修改于 2026年9月10日