📗通则

CoinsDo的解决方案都是为满足用户需求而量身定制的，透过CoinsDo API用户可以直接体验到不同解决方案的众多功能以及让用户直接把功能接入到自己已有平台。

• 修订日期 : 2023-01-16

API URL

CoinsDo不仅为使用中的商户提供正式环境API，同时为开发、测试或学习目的的用户提供免费的测试环境

网络环境	URL
正式	https://open.coinsdo.com/coinsdo/open
测试	https://open.coinsdotest.com/coinsdo/open

支持币种列表

请前往您的CoinSend/CoinGet中心的货币控制列表，以获取最新的coinsDoId。

正式链

coinsDoId	mainnet	protocol	tokenAddress	coinType (0-coin; 1-token)	coinName
1070	AB			0	AB
1071	AB	AB_ERC20	NEW182YefmbFPuCW14WtdXQYQo4YbM3TyB7QRex	1	FREE
51	ADA			0	ADA
195	ALGO			0	ALGO
783	AMB	AMB_ERC20	0x096b5914c95c34df19500daff77470c845ec749d	1	AirBond
209	ARB1			0	ETH
210	ARB1	ARB1_ERC20	0xfd086bc7cd5c481dcc9c85ebe478a1c0b69fcbb9	1	USDT
276	ATOM			0	ATOM
53	AVAXC			0	AVAX
54	AVAXC	AVAXC_ERC20	0x9702230a8ea53601f5cd2dc00fdbc13d4df4a8c7	1	USDt
732	BASE			0	ETH
733	BASE			0	USDC
9	BCH			0	BCH
807	BOR	BOR_BRC20	0x33acaa9a3168c10aeefc55dbeb659b7a7f242c7f	1	BOA
14	BSC			0	BNB
22	BSC	BEP20	0x1af3f329e8be154074d8769d1ffa4ee058b1dbc3	1	DAI
24	BSC	BEP20	0xf8a0bf9cf54bb92f17374d9e9a321e6a111a51bd	1	LINK
25	BSC	BEP20	0xcc42724c6683b7e57334c4e856f4c9965ed682bd	1	MATIC
26	BSC	BEP20	0x2859e4544c4bb03966803b044a93563bd2d0dd4d	1	SHIB
23	BSC	BEP20	0xbf5140a22578168fd562dccf235e5d43a02ce9b1	1	UNI
70	BSC	BEP20	0xe9e7cea3dedca5984780bafc599bd69add087d56	1	BUSD
76	BSC	BEP20	0x8ac76a51cc950d9822d68b83fe1ad97b32cd580d	1	USDC
58	BSC	BEP20	0x55d398326f99059ff775485246999027b3197955	1	USDT
278	BSV			0	BSV
1	BTC			0	BTC
4	BTC	OMNI	31	1	USDT
13	DASH			0	DASH
10	DOGE			0	DOGE
119	DOT			0	DOT
1087	ELY			0	ELY
1088	ELY	ELY_ERC20	0xc6e4564f2b74ef481d40329cd6c0f1c0e830a347	1	WN
11	EOS			0	EOS
7	ETC			0	ETC
2	ETH			0	ETH
15	ETH	ERC20	0xb8c77482e45f1f44de1745f52c74426c631bdd52	1	BNB
17	ETH	ERC20	0x6b175474e89094c44da98b954eedeac495271d0f	1	DAI
38	ETH	ERC20	0x6f259637dcd74c767781e37bc6133cd6a68aa161	1	HT
20	ETH	ERC20	0x514910771af9ca656af840dff83e8264ecf986ca	1	LINK
21	ETH	ERC20	0x7d1afa7b718fb893db30a3abc0cfc608aacfebb0	1	MATIC
30	ETH	ERC20	0x75231f58b43240c9718dd58b4967c5114342a86c	1	OKB
16	ETH	ERC20	0x95ad61b0a150d79219dcf64e1e6cc01f0b64c4ce	1	SHIB
19	ETH	ERC20	0x1f9840a85d5af5bf1d1762f925bdaddc4201f984	1	UNI
6	ETH	ERC20	0xdac17f958d2ee523a2206206994597c13d831ec7	1	USDT
18	ETH	ERC20	0x2260fac5e5542a773aa44fbcfedf7c193bc2c599	1	WBTC
196	ETHW			0	ETHW
242	FIL			0	FIL
41	FTM			0	FTM
43	FTM	FTM_ERC20	0x321162cd933e2be498cd2267a90534a804051b11	1	BTC
44	FTM	FTM_ERC20	0x8d11ec38a3eb5e956b052f67da8bdc9bef8abf3e	1	DAI
42	FTM	FTM_ERC20	0xb3654dc3d10ea7645f8319668e8f54d2574fbdc8	1	LINK
27	HECO			0	HT
28	HECO	HRC20	0x9e004545c59d359f6b7bfb06a26390b087717b42	1	LINK
29	HECO	HRC20	0x22c54ce8321a4015740ee1109d9cbc25815c46e6	1	UNI
8	LTC			0	LTC
734	LUNC			0	LUNC
854	MATCH	MATCH_ERC20	0x39dbc91fa77d92c59376b424518904a9280cc72c	1	USDT
33	MATIC			0	MATIC
36	MATIC	MATIC_ERC20	0x8f3cf7ad23cd3cadbd9735aff958023239c6a063	1	DAI
34	MATIC	MATIC_ERC20	0x53e0bca35ec356bd5dddfebbd1fc0fd03fabad39	1	LINK
35	MATIC	MATIC_ERC20	0xb33eaad8d922b1083446dc23f610c2567fb5180f	1	UNI
37	MATIC	MATIC_ERC20	0x1bfd67037b42cf73acf2047067bd4f2c47d9bfd6	1	WBTC
131	MATIC	MATIC_ERC20	0x2791bca1f2de4661ed88a30c99a7a9449aa84174	1	USDC
747	MERL			0	MERL
748	MERL	MERL_ERC20	0x5c46bff4b38dc1eae09c5bac65872a1d8bc87378	1	MERL
208	NEAR			0	NEAR
31	OKC			0	OKT
32	OKC	KIP20	0xdf54b6c6195ea4d948d03bfd818d365cf175cfc2	1	OKB
272	OP			0	ETH
273	OP	OPT_ERC20	0x94b008aa00579c1307b0ef2c499ad98a8ce58e58	1	USDT
735	SHIB			0	BONE
736	SHIB			1	WBONE
49	SOL			0	SOL
52	SOL	SPL	Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB	1	USDT
947	SONIC			0	SONIC
948	SONIC	SONIC_ERC20	0x29219dd400f2bf60e5a23d13be72b486d4038894	1	USDC
781	TON			0	TON
817	TON	JETTON	EQCxE6mUtQJKFnGfaROTKOt1lZbDiiX1kCixRv7Nw2Id_sDs	1	USDT
3	TRX			0	TRX
39	TRX	TRC20	TDyvndWuvX5xTBwHPYJi7J3Yq8pq8yh62h	1	HT
5	TRX	TRC20	TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t	1	USDT
40	TRX	TRC20	TXpw8XeWYeTUd4quDskoUqeQPowRh4jY65	1	WBTC
883	WYZ			0	WYZ
884	WYZ	WRC20	0x804075813fc537f284233e88784469ea390c25f2	1	WYS
45	XDAI			0	XDAI
48	XDAI	XDAI_ERC20	0x44fa8e6f47987339850636f88629646662444217	1	DAI
46	XDAI	XDAI_ERC20	0xe2e73a1c69ecf83f464efce6a5be353a37ca09b2	1	LINK
47	XDAI	XDAI_ERC20	0x4537e328bf7e4efa29d05caea260d7fe26af9d74	1	UNI
243	XLM			0	XLM
50	XRP			0	XRP
649	XYM			0	XYM
12	ZEC			0	ZEC

测试链

coinsDoId	mainnet	protocol	tokenAddress	coinType (0-coin; 1-token)	coinName
707	AB			0	AB
709	AB	AB_ERC20	NEW17zRsawPpr1TV69YshZCY8cPsRJM5FuDy9qQ	1	Zombie
31	ADA			0	ADA
190	ALGO			0	ALGO
654	AMB			0	AMB
655	AMB	AMB_ERC20	0x096b5914c95c34df19500daff77470c845ec749d	1	AirBond
204	ARB1			0	ETH
205	ARB1	ARB1_ERC20	0x68fed128b095c919ee2c4f64e5c9b9eb64974a87	1	USDT
220	ATOM			0	ATOM
116	AVAXC			0	AVAX
117	AVAXC	AVAXC_ERC20	0xb5ad0e2d92560d0f588506a56e029e5fa1fc5570	1	WAVAX
644	BASE			0	ETH
645	BASE			0	USDC
9	BCH			0	BCH
677	BOR	BOR_BRC20	b33acaa9a3168c10aeefc55dbeb659b7a7f242c7f	1	BOA
14	BSC			0	BNB
15	BSC	BEP20	0xec5dcb5dbf4b114c9d0f65bccab49ec54f6a0867	1	DAI
16	BSC	BEP20	0x337610d27c682e347c9cd60bd4b3b107c9d34ddd	1	USDT
221	BSV			0	BSV
1	BTC			0	BTC
4	BTC	OMNI	2	1	USDT
13	DASH			0	DASH
10	DOGE			0	DOGE
163	DOT			0	DOT
713	ELY			0	ELY
714	ELY	ELY_ERC20	0xdee76baa1c4881f5780c02c5fdf6d42d1b3421e2	1	CDT
11	EOS			0	EOS
7	ETC			0	ETC
2	ETH			0	ETH
6	ETH	ERC20	0x378da755324ee4f1a5735a4f13499a410d82d122	1	USDT
191	ETHW			0	ETHW
213	FIL			0	FIL
25	FTM			0	FTM
26	FTM	FTM_ERC20	0x378da755324ee4f1a5735a4f13499a410d82d122	1	CD
17	HECO			0	HT
18	HECO	HRC20	0x3e24e9d2c824b0ac2c82edc931b67252099b8e79	1	LINK
19	HECO	HRC20	0xd459dad367788893c17c09e17cfbf0bf25c62833	1	USDC
20	HECO	HRC20	0x04f535663110a392a6504839beed34e019fdb4e0	1	USDT
8	LTC			0	LTC
639	LUNC			0	LUNC
691	MATCH			0	BNB
692	MATCH	MATCH_ERC20	0x245fc0a7e2d1e629f5edf8543274ab2fe38359af	1	CDT
23	MATIC			0	MATIC
24	MATIC	MATIC_ERC20	0x326c977e6efc84e512bb9c30f76e30c160ed06fb	1	LINK
652	MERL			0	BTC
651	MERL			0	MERL
650	MERL	MERL	0x8ca2f5f38f37d377a320844c38064a0ef97b37e4	1	MERL
203	NEAR			0	NEAR
21	OKC			0	OKT
22	OKC	KIP20	0xda9d14072ef2262c64240da3a93fea2279253611	1	OKB
215	OP			0	ETH
216	OP	OPT_ERC20	0x6b84ad647c8bc943281d67e569f3572570d20d57	1	CD
219	OP	OPT_ERC20	0x94b008aa00579c1307b0ef2c499ad98a8ce58e58	1	USDT
29	SOL			0	SOL
100	SOL	SPL	4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU	1	USDC
703	SONIC			0	SONIC
704	SONIC	SONIC_ERC20	0xaf93888cbd250300470a1618206e036e11470149	1	CORAL
660	TON			0	TON
679	TON	JETTON	EQC9GzFiNQ2Cygp2V2IDxQlFsbmtJbFXEbpc0QwyudyAfQZ	1	CDC
3	TRX			0	TRX
166	TRX	TRC20	TXLAQ63Xg1NAzckPwKHvzw7CSEmLMEqcdj	1	USDT
5	TRX	TRC20	TJwXPRrs39c9apaGsjccv7XiybkvYaLUhn	1	UT
699	WYZ			0	WYZ
700	WYZ	WRC20	0x32af4671788db409bbc87b7e7df038349b17f1e1	1	WYS
27	XDAI			0	XDAI
28	XDAI	XDAI_ERC20	0x3111c94b9243a8a99d5a867e00609900e437e2c0	1	FAU
214	XLM			0	XLM
30	XRP			0	XRP
617	XYM			0	XYM
12	ZEC			0	ZEC

请求API

快速了解如何请求 CoinsDo API。

请求方式

• POST

请求参数

• Header 参数

参数名	必填	类型/参数值
Content-Type	是	application/json

• Body 参数

参数名	必填	类型	说明
sign	是	string	签名
data	是	string	内容（JSON字符串,具体看每个接口详情定义）

• 签名规则

签名使用HMAC-SHA256算法。

API-KEY所对应的Secret-KEY作为HMAC-SHA256的密钥，对data参数进行加密，得到的输出即为签名。

例如，密钥1024对data参数的签名：

    {
        "data": "{\"apiKey\":\"cd384rt80f5575dc\",\"mainnet\":\"TRX\",\"targetDeviceUuid\":\"085C28EC-0BD6-442B-8232-D23BC8F4D58E\",\"timestamp\":\"1622775712229\",\"addressRemark\":\"trx address\"}",
        "sign": "852cd95d5045f3e41db0447cdde405b73cc03b8844b76da74bd0b498470cba75"
    } 

响应参数

 {
    "code": 200, // 状态码
    "msg": "成功", // 提示信息
    "data": null // 返回内容
}

状态码

状态码	说明
-2	系统异常
200	成功
4001	接口未找到
4002	参数格式错误
4003	JSON数据转换异常
4004	APIKEY不存在
4005	ip受限
4007	验签失败
4010	请求过期
4068	检查APIKEY失败

*每个接口有各自的状态码

回调通知

通过回调通知API将下发记录审批结果、归集收币到账确认状态通知至商户后台设置的回调URL。

回调场景

• 当你选择处理时，响应code为200视为回调成功，不再回调

• 当你选择忽略时，响应code为202视为忽略成功，不再回调（可选项，实际效果等同于200，作用仅限于标识是否处理）

回调场景	描述	建议
下发	下发请求链上交易(成功/驳回/取消）	处理
归集收币一个确认	存币后链上达到一个确认数(中间状态)	处理/忽略
归集收币到账	达到指定确认数&核查成功(最终状态)入账	处理

请求方式

• POST

请求参数

• Header 参数

参数名	必填	类型/参数值
Content-Type	是	application/json

• Body 参数

参数名	必填	类型	说明
sign	是	string	签名
data	是	string	内容（JSON字符串）

返回示例

{
    "code": 200, // 状态码
    "msg": "成功", // 提示信息
    "data": null //返回信息 
}

获取当前矿工费

可通过此API查询某一币种的当前矿工费

接口描述

• 查询某一币种的当前矿工费

请求地址

• {URL}/v1/txFeeGet

请求方式

• POST

• Body 参数

参数名	必填	类型	说明
data	是	string	内容（JSON字符串，如下）

{
    "apiKey": "aa465953d55641b3", 
    "coinsDoId": "25", 
    "timestamp": "2847982343622"
}

• data 参数

参数名	必填	类型	说明
apiKey	是	string	API KEY
coinsDoId	是	string	币种ID(参数见币种列表)
timestamp	是	string	时间戳(秒或毫秒)

请求示例

{
    "data": "{\"apiKey\":\"aa465953d55641b3\",\"coinsDoId\":\"25\",\"timestamp\":\"2847982343622\"}",
    "sign": "b7452bd73629ac1ddaae1096a1257a8a70262450b23c95f6c5f199d631d97486"
}

返回示例

{
    "success": true,
    "code": 200,
    "msg": "Success",
    "data": {
        "transFee": "0.000021525084",
        "updateTime": "1748329922"
    }
}

参数名	必填	类型	说明
transFee	是	string	币种的矿工费
updateTime	是	string	矿工费更新时间戳(秒)

获取各链当前高度

接口描述

• 查询各链当前高度

请求地址

• {URL}/v1/blockNumberGet

请求方式

• POST

请求示例

{
    "data": "{\"apiKey\":\"aa465953d55641b3\",\"timestamp\":\"2847982343622\"}",
    "sign": "7639a6a58d8ae74db48db3841f71a21b92e68131529c5e4d72ef4baa6234146b"
}

返回示例

{
    "success": true,
    "code": 200,
    "msg": "Success",
    "data": {
        "blockNumberList": [
            {
                "currency": "ADA",
                "latestNumber": "92652996",
                "scanNumber": "3519718"
            },
            {
                "currency": "ALGO",
                "latestNumber": "51985959",
                "scanNumber": "42260246"
            },
            {
                "currency": "ARB1",
                "latestNumber": "157274340",
                "scanNumber": "55797388"
            },
            {
                "currency": "ARB1_ERC20",
                "latestNumber": "157274340",
                "scanNumber": "55554107"
            },
            {
                "currency": "ATOM",
                "latestNumber": null,
                "scanNumber": null
            },
            {
                "currency": "AVAXC",
                "latestNumber": "40975753",
                "scanNumber": "40975750"
            },
            {
                "currency": "AVAXC_ERC20",
                "latestNumber": "40975753",
                "scanNumber": "40975751"
            },
            {
                "currency": "BCH",
                "latestNumber": "1659234",
                "scanNumber": "1659233"
            },
            {
                "currency": "BNB",
                "latestNumber": "52676688",
                "scanNumber": "52676277"
            },
            {
                "currency": "BEP20",
                "latestNumber": "52676688",
                "scanNumber": "52599334"
            },
            {
                "currency": "BSV",
                "latestNumber": "1676446",
                "scanNumber": "1557627"
            },
            {
                "currency": "BTC",
                "latestNumber": "4325100",
                "scanNumber": "4325100"
            },
            {
                "currency": "OMNI",
                "latestNumber": "4408037",
                "scanNumber": "4148045"
            },
            {
                "currency": "DASH",
                "latestNumber": "1258885",
                "scanNumber": "1258885"
            },
            {
                "currency": "DOGE",
                "latestNumber": "8132183",
                "scanNumber": "8132179"
            },
            {
                "currency": "DOT",
                "latestNumber": "26211647",
                "scanNumber": "22790235"
            },
            {
                "currency": "EOS",
                "latestNumber": "204968789",
                "scanNumber": null
            },
            {
                "currency": "ETC",
                "latestNumber": "13782067",
                "scanNumber": "13782067"
            },
            {
                "currency": "ETH",
                "latestNumber": "8416520",
                "scanNumber": "6800272"
            },
            {
                "currency": "ERC20",
                "latestNumber": "8416520",
                "scanNumber": "6644598"
            },
            {
                "currency": "ERC721",
                "latestNumber": null,
                "scanNumber": null
            },
            {
                "currency": "ERC1155",
                "latestNumber": null,
                "scanNumber": null
            },
            {
                "currency": "ETHW",
                "latestNumber": "7168212",
                "scanNumber": "17080074"
            },
            {
                "currency": "FIL",
                "latestNumber": "2700329",
                "scanNumber": "1720412"
            },
            {
                "currency": "FTM",
                "latestNumber": "57627751",
                "scanNumber": "26394756"
            },
            {
                "currency": "FTM_ERC20",
                "latestNumber": "57627751",
                "scanNumber": "26394757"
            },
            {
                "currency": "HT",
                "latestNumber": null,
                "scanNumber": "23643001"
            },
            {
                "currency": "HRC20",
                "latestNumber": null,
                "scanNumber": "23643001"
            },
            {
                "currency": "LTC",
                "latestNumber": "3832131",
                "scanNumber": "3832121"
            },
            {
                "currency": "MATIC",
                "latestNumber": "22176049",
                "scanNumber": "15208453"
            },
            {
                "currency": "MATIC_ERC20",
                "latestNumber": "22176049",
                "scanNumber": "15208453"
            },
            {
                "currency": "NEAR",
                "latestNumber": "198651320",
                "scanNumber": "169904595"
            },
            {
                "currency": "OKT",
                "latestNumber": "34347084",
                "scanNumber": "31785564"
            },
            {
                "currency": "KIP20",
                "latestNumber": "34347084",
                "scanNumber": "31785564"
            },
            {
                "currency": "OPT",
                "latestNumber": "28266854",
                "scanNumber": "16001277"
            },
            {
                "currency": "OPT_ERC20",
                "latestNumber": "28266854",
                "scanNumber": "13934311"
            },
            {
                "currency": "SOL",
                "latestNumber": "383622952",
                "scanNumber": "376613448"
            },
            {
                "currency": "SPL",
                "latestNumber": null,
                "scanNumber": null
            },
            {
                "currency": "TRX",
                "latestNumber": "57317699",
                "scanNumber": "57317697"
            },
            {
                "currency": "TRC20",
                "latestNumber": "57317699",
                "scanNumber": "57317695"
            },
            {
                "currency": "XDAI",
                "latestNumber": "40273331",
                "scanNumber": "35159032"
            },
            {
                "currency": "XDAI_ERC20",
                "latestNumber": "40273331",
                "scanNumber": "33240007"
            },
            {
                "currency": "XLM",
                "latestNumber": "1185079",
                "scanNumber": "1708797"
            },
            {
                "currency": "XRP",
                "latestNumber": "7622039",
                "scanNumber": "2433520"
            },
            {
                "currency": "ZEC",
                "latestNumber": "3415225",
                "scanNumber": "3415223"
            },
            {
                "currency": "XYM",
                "latestNumber": "2407448",
                "scanNumber": "1605773"
            },
            {
                "currency": "XYM_TOKEN",
                "latestNumber": "2407448",
                "scanNumber": null
            },
            {
                "currency": "BONE",
                "latestNumber": "9052288",
                "scanNumber": "9052287"
            },
            {
                "currency": "BONE_ERC20",
                "latestNumber": null,
                "scanNumber": null
            },
            {
                "currency": "LUNC",
                "latestNumber": "16864475",
                "scanNumber": "16864474"
            },
            {
                "currency": "BASE",
                "latestNumber": null,
                "scanNumber": null
            },
            {
                "currency": "BASE_ERC20",
                "latestNumber": "26283981",
                "scanNumber": "21000571"
            },
            {
                "currency": "MERL",
                "latestNumber": "18712372",
                "scanNumber": "18089588"
            },
            {
                "currency": "MERL_ERC20",
                "latestNumber": "18712372",
                "scanNumber": "14469866"
            },
            {
                "currency": "AMB",
                "latestNumber": "4585571",
                "scanNumber": "4585571"
            },
            {
                "currency": "AMB_ERC20",
                "latestNumber": "4585571",
                "scanNumber": "4585571"
            },
            {
                "currency": "TON",
                "latestNumber": "31582886",
                "scanNumber": "31582884"
            },
            {
                "currency": "JETTON",
                "latestNumber": null,
                "scanNumber": null
            },
            {
                "currency": "BOR",
                "latestNumber": null,
                "scanNumber": null
            },
            {
                "currency": "BOR_BRC20",
                "latestNumber": null,
                "scanNumber": null
            },
            {
                "currency": "MATCH",
                "latestNumber": null,
                "scanNumber": null
            },
            {
                "currency": "MATCH_ERC20",
                "latestNumber": null,
                "scanNumber": null
            },
            {
                "currency": "WYZ",
                "latestNumber": null,
                "scanNumber": null
            },
            {
                "currency": "WRC20",
                "latestNumber": null,
                "scanNumber": null
            },
            {
                "currency": "SONIC",
                "latestNumber": null,
                "scanNumber": null
            },
            {
                "currency": "SONIC_ERC20",
                "latestNumber": null,
                "scanNumber": null
            },
            {
                "currency": "AB",
                "latestNumber": null,
                "scanNumber": null
            },
            {
                "currency": "AB_ERC20",
                "latestNumber": null,
                "scanNumber": null
            },
            {
                "currency": "ELY",
                "latestNumber": null,
                "scanNumber": null
            },
            {
                "currency": "ELY_ERC20",
                "latestNumber": null,
                "scanNumber": null
            }
        ],
        "timestamp": "2025-05-27T08:57:32.378+00:00"
    }
}

• data 参数

参数名	必填	类型	说明
blockNumberList	是	array	区块高度列表
timestamp	是	string	时间戳(秒或毫秒)

• blockNumberList 参数

参数名	必填	类型	说明
currency	是	string	币种
latestNumber	否	string	当前链上最新高度
scanNumber	否	string	coinsdo扫块高度

返回状态码

状态码	说明
4099	请求次数太频繁

商户查询账户下所有客户端在线状态API

接口描述

• 查询商户所有装置的在线状态

请求地址

• {URL}/v1/onlineDeviceList

请求方式

• POST

• Body 参数

参数名	必填	类型	说明
data	是	string	内容（JSON字符串，如下）

{
    "apiKey": "7bb52d79e46e47ab",
    "timestamp": "1744697998"
}

• data 参数

参数名	必填	类型	说明
apiKey	是	string	API KEY
timestamp	是	string	时间戳 (秒或毫秒)

请求示例

{
    "data":"{\"apiKey\":\"7bb52d79e46e47ab\",\"timestamp\":\"1744697998\"}",
    "sign":"03dabf4073bad9d5fcde3b881bba076cae211ac28b11995289740f96f51162a5"
}

返回示例

{
    "success": true,
    "code": 200,
    "msg": "Success",
    "data": [
        {
            "deviceUuid": "1ebec22c-d3b8-7940-0345-c3a8645252ad",
            "deviceName": "Wong Yun Fat",
            "deviceType": 0,
            "onlineStatus": 1
        },
        {
            "deviceUuid": "25604db6-2424-1ce7-1ddb-0e08c0946d1a",
            "deviceName": "Fung Wing Sze",
            "deviceType": 1,
            "onlineStatus": 0
        },
        {
            "deviceUuid": "27298be4-9ee4-0289-8819-b4b9f06376d6",
            "deviceName": "Nakagawa Airi",
            "deviceType": 1,
            "onlineStatus": 1
        },
        {
            "deviceUuid": "5c72cbde-7357-c2e6-0710-ce0605e16a6f",
            "deviceName": "Rose Gonzalez",
            "deviceType": 0,
            "onlineStatus": 0
        }
    ]
}

• data 参数

参数名	必填	类型	说明
deviceName	是	string	设备名称
deviceUuid	是	string	设备UUID
deviceType	是	Integer	设备类型（0.下发 1.归集）
onlineStatus	是	Integer	在线状态(0.离线 1.在线)

返回状态码

状态码	说明
4002	参数格式错误
4003	JSON数据转换异常
4004	APIKEY不存在
4005	ip受限，当前ip:
4007	验签失败
4010	请求过期
4068	检查APIKEY失败
4099	请求次数太频繁
4143	查询在线设备失败
4144	查询归集在线设备失败
4145	查询商户设备失败