小号tela信息报备接口

本文讨论了小号tela信息报备接口中A号码报备接口的相关内容,包括请求参数、请求地址、请求示例、返回示例以及特别注意事项,还介绍了报备回调通知接口的情况。

本文讨论了小号 tela 信息报备接口中 A 号码报备接口的相关内容,包括请求参数、请求地址、请求示例、返回示例以及特别注意事项,还提及了报备回调通知接口的情况。关键要点包括:​
A 号码报备接口请求参数:包含 requestId(每次请求唯一标识)、method(增加或删除成员号码操作)、reportType(报备号码类型)、phoneType(号码类型)、member(成员加密信息)等,且 member 不参与签名。​
请求地址:POST '/openapi/call/api/telA/reporting' 。​
返回示例:成功时返回 "code": 200, "msg": "ok" 。​
特别注意事项:每次最多核验一个号码及身份信息;活体照片不大于 32KB,为 jpg 或 png 格式;每个 ip 连接数不超 10 个;Member 参数用国密 SM4 加密,秘钥有特定生成方式;未收到核验结果前 A 号码禁止重复报送,核验失败 24h 后剔除白名单,二次核验需在通知 24h 后重新上报。​
报备回调通知接口:接口提供方为客户,请求参数有 requestId 和 resultList(报备结果加密信息),成功返回 "code": 200, "msg": "ok" 。

A 号码报备接口

请求参数
字段名称字段类型是否必传字段描述
requestId string每次请求的唯一标识
methodstringappend:增加成员号码 delete:删除指定的成员号码
reportTypeint报备号码类型(1:A 路号码 2:B 路号码)
phoneTypeint号码类型(1:手机号 2:固话)
memberstring成员加密信息,该字段不参与签名。值为 Member 数组转成字符串后,通过 sm4 加密 获取的字符串。
member
字段名称字段类型是否必传字段描述
phoneNumberstring必须号码
namestring必须号码所属人姓名
identityCardstring选填号码所属人身份证号码,method 为 append,增加成员号码时,该字段必填
idCardFrontImagestring选填可不传
idCardBackImagestring选填可不传
liveFaceImagestring选填活体检测人脸照片 base64 编码。不大于 32KB,method 为 append,增加成员号码时,该字段必填
请求地址POST '/openapi/call/api/telA/reporting'请求示例
{ "requestId": "requestIdxxxxxxx", "method": "append", "reportType": 1, "phoneType": 1, "member": "YW0PskHFOTAPvAaMVLexLOZbri0GRVKVWOVl2LexkKF03UqwKO9YUbFAGtMWlKgdke09yJaBrQnOVzj4jQtcqPvosPNJ6c8Ny1D7pcyu9KLR8gZ4WVVeAbXK0jrU1uALSg7w6CsKk5i3rR3vTCEuSmrCRr/Os4FTkfBksom2F04=" }
加密前参数样例:
{ "requestId": "requestIdxxxxxxx", "method": "append", "reportType": 1, "phoneType": 1, "member": "[{\"phoneNumber\": \"130xxxx5678\",\"name\": \"张三 \",\"identityCard\": \"110101xxxxxxxx5821\",\"imgBaseCode\": \"照片 base64\"}]" }
返回示例成功:
{   "code": 200,   "msg": "ok" }
特别注意事项:
  1. 每次最多核验一个号码及身份信息
  2. 活体照片需不大于 32KB, jpg 或 png 格式
  3. 因文件传输占用宽带资源较多,每个 ip 的连接数不得超过 10 个
  4. Member 参数采用国密 SM4 加密方式加密,秘钥为appId 的 MD5 (16)加密(大写),将标准的 32 位 MD5 字符串截取中间部分(去除前 8 位和后 8 位)。
  5. A 号码在当前 AppId 下报备过程中,在未收到核验结果通知前禁止重复报送,核验失败,平台会通过《报备回调通知接口》通知客户,同时平台会在 24h 后对报备的 A 号码进行白 名单剔除,客户如需二次核验,需在收到通知 24h 后进行重新上报

报备回调通知接口

接口提供方:客户请求参数
字段名称字段类型是否必传字段描述
requestId string每次请求的唯一标识
resultListstring报备结果加密信息, 值为 resultList 数组转成字符串后,通过 sm4 加密获取的字符串。
resultList:
字段名称字段类型是否必传字段描述
phoneNumberstring 必须号码
statusInt必须0 成功,非 0 失败
failReasonString 条件失败原因
请求示例
{ "requestId": "requestIdxxxxxxx", "result": "[{\"phoneNumber\": \"130xxxx5678\",\"status\": 0},{\"phoneNumber\": \"186xxxx5678 \",\"status\": -1}]" }
返回示例成功:
{   "code": 200,   "msg": "ok" }
2025-04-21