iot设备绑定关系查询接口 -凯发app官方网站

支持第三方代理调用

更新时间：2023-11-17 10:39:12

订阅更新

我的文档

设置

通用场景

通过设备唯一标识查询设备绑定关系

公共请求参数

参数	类型	是否必选	最大长度	描述	示例值
app_id	string	必选	32	支付宝分配给开发者的应用id	2014072300007148
method	string	必选	128	接口名称	alipay.merchant.iot.device.query
format	string	可选	40	仅支持json	json
charset	string	必选	10	请求使用的编码格式，如utf-8,gbk,gb2312等	utf-8
sign_type	string	必选	10	商户生成签名字符串所使用的签名算法类型，目前支持rsa2和rsa，推荐使用rsa2	rsa2
sign	string	必选	344	商户请求参数的签名串，详见签名	详见示例
timestamp	string	必选	19	发送请求的时间，格式"yyyy-mm-dd hh:mm:ss"	2014-07-24 03:07:50
version	string	必选	3	调用的接口版本，固定为：1.0	1.0
app_auth_token	string	可选	40	详见应用授权概述
biz_content	string	必选		请求参数的集合，最大长度不限，除公共参数外所有请求参数都必须放在这个参数中传递，具体参照各产品快速接入文档

业务请求参数

device_id_type必选string(32)

【描述】可选方式 [id,sn]。id-使用biztid作为设备唯一识别标识；sn-使用supplier_id、device_sn联合作为设备唯一识别标识。由于不同机型的supplier_id不同，推荐使用 id 。

【示例值】sn

biz_tid特殊可选string(128)

【描述】设备 id ，device_id_type 为 id 时填写。

【示例值】01017gv1cz1xxasnbqktjqchletnyvxtsky1pas4fkz6tjrmqymg2zk

supplier_id特殊可选string(128)

【描述】设备供应商id ，device_id_type 为 sn 时填写。需注意不同机型的供应商id可能不同。

【示例值】201812271300540049

device_sn特殊可选string(128)

【描述】设备序列号，device_id_type 为 sn 时填写。需配合supplier_id使用。

【示例值】qcf420190316000107

参数	类型	是否必选	最大长度	描述	示例值
device_id_type	string	必选	32	可选方式 [id,sn]。id-使用biztid作为设备唯一识别标识；sn-使用supplier_id、device_sn联合作为设备唯一识别标识。由于不同机型的supplier_id不同，推荐使用 id 。	sn
biz_tid	string	特殊可选	128	设备 id ，device_id_type 为 id 时填写。	01017gv1cz1xxasnbqktjqchletnyvxtsky1pas4fkz6tjrmqymg2zk
supplier_id	string	特殊可选	128	设备供应商id ，device_id_type 为 sn 时填写。需注意不同机型的供应商id可能不同。	201812271300540049
device_sn	string	特殊可选	128	设备序列号，device_id_type 为 sn 时填写。需配合supplier_id使用。	qcf420190316000107

常见请求示例

默认示例

javac#phphttp

package com.java.sdk.demo;
import com.alipay.api.alipayapiexception;
import com.alipay.api.alipayclient;
import com.alipay.api.defaultalipayclient;
import com.alipay.api.certalipayrequest;
import com.alipay.api.alipayconfig;
import com.alipay.api.domain.alipaymerchantiotdevicequerymodel;
import com.alipay.api.request.alipaymerchantiotdevicequeryrequest;
import com.alipay.api.response.alipaymerchantiotdevicequeryresponse;
import com.alipay.api.fileitem;
import java.util.base64;
import java.util.arraylist;
import java.util.list;
public class alipaymerchantiotdevicequery {
    public static void main(string[] args) throws alipayapiexception {
        string privatekey = "<-- 请填写您的应用私钥，例如：miievqibadanb ... ... -->";
        string alipaypublickey = "<-- 请填写您的支付宝公钥，例如：miibijanbg... -->";
        alipayconfig alipayconfig = new alipayconfig();
        alipayconfig.setserverurl("https://openapi.alipay.com/gateway.do");
        alipayconfig.setappid("<-- 请填写您的appid，例如：2019091767145019 -->");
        alipayconfig.setprivatekey(privatekey);
        alipayconfig.setformat("json");
        alipayconfig.setalipaypublickey(alipaypublickey);
        alipayconfig.setcharset("utf8");
        alipayconfig.setsigntype("rsa2");
        alipayclient alipayclient = new defaultalipayclient(alipayconfig);
        alipaymerchantiotdevicequeryrequest request = new alipaymerchantiotdevicequeryrequest();
        alipaymerchantiotdevicequerymodel model = new alipaymerchantiotdevicequerymodel();
        model.setdeviceidtype("sn");
        model.setdevicesn("qcf420190316000107");
        model.setsupplierid("201812271300540049");
        model.setbiztid("01017gv1cz1xxasnbqktjqchletnyvxtsky1pas4fkz6tjrmqymg2zk");
        request.setbizmodel(model);
        alipaymerchantiotdevicequeryresponse response = alipayclient.execute(request);
        system.out.println(response.getbody());
        if (response.issuccess()) {
            system.out.println("调用成功");
        } else {
            system.out.println("调用失败");
            // sdk版本是"4.38.0.all"及以上,可以参考下面的示例获取诊断链接
            // string diagnosisurl = diagnosisutils.getdiagnosis;
            // system.out.println(diagnosisurl);
        }
    }
}

说明：本示例仅供参考。

公共响应参数

参数	类型	是否必选	最大长度	描述	示例值
code	string	必选	-	网关返回码,	40004
msg	string	必选	-	网关返回码描述,	business failed
sub_code	string	可选	-	业务返回码，参见具体的api接口文档	acq.trade_has_success
sub_msg	string	可选	-	业务返回码描述，参见具体的api接口文档	交易已被支付
sign	string	必选	-	签名,	dzxh8eetuahoye3w1j poiphfdxoybfunn1lket/v7p4zjdyojwea6izs6hz0ydw5cp/viufub5i0/v5wens3oyr8zredqo6d futdlhdc efyckiqhbxizgngpdpdfp1pis7bdhhzrszhbrqb7o4k3dxc aanfauu4v6zdwczo=

业务响应参数

merchant_type必选string(32)

【描述】商户类型。direct表示直连商户，indirect表示间连商户。

【示例值】indirect

pid必选string(64)

【描述】设备绑定的商户支付宝pid。直连场景为商户收单pid，间连场景为商户smid绑定的pid。

【示例值】2088101112139885

shop_id必选string(64)

【描述】设备绑定的门店id。

【示例值】2020081700502012300038796029

smid特殊可选string(64)

【描述】商户smid。直连场景为空。

【示例值】2088101112139886

参数	类型	是否必选	最大长度	描述	示例值
merchant_type	string	必选	32	商户类型。direct表示直连商户，indirect表示间连商户。	indirect
pid	string	必选	64	设备绑定的商户支付宝pid。直连场景为商户收单pid，间连场景为商户smid绑定的pid。	2088101112139885
smid	string	特殊可选	64	商户smid。直连场景为空。	2088101112139886
shop_id	string	必选	64	设备绑定的门店id。	2020081700502012300038796029

响应示例

正常示例

异常示例

{
    "alipay_merchant_iot_device_query_response": {
        "code": "10000",
        "msg": "success",
        "merchant_type": "indirect",
        "pid": "2088101112139885",
        "smid": "2088101112139886",
        "shop_id": "2020081700502012300038796029"
    },
    "sign": "eritjkeijkjhkkkkkkkhjereeeeeeeeeee"
}