Qscore 监控告警
账户通过 PUT /v1/qscore/subjects/{docID}/monitoring 监控的主体自上次检查以来 发生了变化。triggers 列出触发本次告警的原因:score_drop_below(评分向下穿越订阅的 monitor_since_score 阈值:先前 >= 阈值,新值 < 阈值)、new_records(征信局登记了新事件; 当 only_material: true 时,仅重大负面事件——未结清的逾期、拒付、破产、诉讼——计入)或 records_removed(征信局当前显示的事件少于基线,即某条记录已结清或删除)。活跃订阅每 ~5 分钟重新评估一次;订阅后的首次扫描仅建立基线,绝不会就已购买报告中展示过的历史 记录发出告警。当主体暂无可分类评分时,score 和 previous_score 将被省略;没有新事件 触发时,new_records 也将被省略。
每次交付都包含 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 次尝试,采用递增退避。
授权
会话 JWT(来自注册/登录)或 API key(pk_...)。
也接受 X-API-Key: <token> 作为替代请求头。
请求体
person, company score_drop_below, new_records, records_removed A, B, C, D, E, SC 响应
返回任何 2xx 以确认交付。