查询子商户分数

1、查询子商户分数

接口路径

• GET
• /api/agent/score/query

说明

• 查询指定子商户的分数列表，按币种返回，每个币种对应一条记录。
• 可通过 currency 参数筛选特定币种，不传则返回该子商户所有币种的分数。
• 调用方只能查询其直属子商户的分数。

请求参数

参数	名称	类型	必填	说明
agent_id	商户 ID	string	必填	商户 ID
sub_agent_id	子商户 ID	string	必填	要查询分数的子商户 ID
currency	币种	string	选填	按币种筛选，不传则返回所有币种
timestamp	当前时间戳	string	必填	传调用接口时的时间戳（单位毫秒，有效期十分钟）
sign	签名	string	必填	签名算法详见接口说明

响应参数

参数	名称	类型	说明
code	响应码	int	错误码
message	响应信息	string	错误信息
data	响应数据	dict	响应数据详情
--list	分数列表	List	分数记录列表
----agent_id	子商户 ID	string	子商户 ID
----name	子商户名称	string	子商户名称
----currency	币种	string	币种
----score	分数	float	当前分数

请求范例

curl --location 'https://staging.aig1234.com/api/agent/score/query?agent_id=agent001&sub_agent_id=agent002&currency=USD&timestamp=1732589849000&sign=6d39491fb4195d392dc3d53bf6c88138' \
--header 'Content-Type: application/json'

响应范例

{
    "code": 200,
    "message": "success",
    "data": {
        "list": [
            {
                "agent_id": "agent002",
                "name": "子商户A",
                "currency": "USD",
                "score": 1500.00
            }
        ]
    }
}

错误码

200    成功
408003 白名单限制
600100 签名不合法
600101 参数不合法
700101 商户不存在