alliance get

2023-06-16 05:25

概览

API URL：/api/v1/zoloz/idnetwork/alliance/get
API 描述：该接口用于查询联盟记录。

请求参数

字段名称

数据类型

最大长度

是否必填

描述

示例值

itemIds

List<String>

是

待查询的记录ID列表，该ID是入库时IDN返回的数据记录ID。

说明：支持批量查询，一次最多可以查询100条记录。

["AIN20220725875271649639","AIN20220725875123649642"]

返回参数

字段名称	数据类型	描述	示例值
result	Result	API请求结果，包含结果状态、结果码和结果消息。	{ "resultStatus":"S", "resultCode":"SUCCESS", "resultMessage":"Success" }
transactionId	String	IDN生成的唯一业务ID。	"8365364ceddd411da027cdb15fea92ed"
allianceItems	AllianceItems	商户信息，目前仅返回userId和clientId这两个字段。详细信息，请参见AllianceItems。	[ { "itemId":"AIN20220725875271649639", "userId":"e9830710-0d70", "clientId" : "2188426362797742", "merchantName":"xxxbank" },{ "itemId":"AIN20220725875123649642", "userId":"e9830620-0d11", "clientId" : "2188426362797742", "merchantName":"xxxbank" } ]

AllianceItems字段说明

字段名称	数据类型	描述	示例值
itemId	String	入库时IDN返回的数据记录ID。	"AIN20220725875271649639"
userId	String	商户定义的用户ID。	"e9830710-0d70"
clientId	String	客户ID。	"2188426362797742"
merchantName	String	商户名。	"xxxbank"

代码示例

请求示例

copy
POST https://ip:port/api/v1/zoloz/idnetwork/alliance/get

# POST Body:
{
  "itemIds":["AIN20220725875271649639","AIN20220725875123649642"]
}

返回示例

copy
# Response Body
{
    "result":{
        "resultStatus":"S",
        "resultCode":"SUCCESS",
        "resultMessage":"Success"
    },
    "transactionId":"8365364ceddd411da027cdb15fea92ed",
    "allianceItems":[
      {
        "itemId":"AIN20220725875271649639",
        "userId":"e9830710-0d70",
            "clientId" : "2188426362797742",
        "merchantName":"xxxbank"
      },{
        "itemId":"AIN20220725875123649642",
        "userId":"e9830620-0d11",
            "clientId" : "2188426362797742",
        "merchantName":"xxxbank"
      }
    ]
}