列出PolarClaw设备配对
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求语法
POST HTTP/1.1
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| ApplicationId |
string |
是 |
应用 ID |
pa-************** |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
Schema of Response |
||
| RequestId |
string |
Id of the request |
A7E6A8FD-C50B-46B2-BA85-D8B8D3****** |
| Message |
string |
返回消息 |
successful |
| Code |
integer |
返回状态码 |
200 |
| ApplicationId |
string |
应用 ID |
pa-************** |
| Pending |
array<object> |
待审批配对请求列表 |
|
|
object |
待审批配对 |
||
| PairRequestId |
string |
配对请求 ID |
test-1778647932986 |
| DeviceId |
string |
设备唯一标识 |
device-784x37k0vko734fk |
| PublicKey |
string |
Ed25519 公钥 |
test-pubkey-base64url |
| DisplayName |
string |
设备显示名称 |
test |
| Platform |
string |
操作系统平台 |
linux |
| DeviceFamily |
string |
硬件类别 |
server |
| ClientId |
string |
客户端标识 |
cli |
| ClientMode |
string |
客户端模式 |
cli |
| Role |
string |
设备角色 |
operator |
| Roles |
array |
角色列表 |
|
|
string |
设备角色 |
operator |
|
| Scopes |
array |
权限作用域列表 |
|
|
string |
权限作用域 |
operator.read |
|
| RemoteIp |
string |
请求方 IP 地址 |
127.0.0.1 |
| Silent |
boolean |
是否静默配对 |
false |
| IsRepair |
boolean |
是否为重新配对 |
false |
| Ts |
integer |
配对请求时间戳(Unix 毫秒) |
1778660347550 |
| Paired |
array<object> |
已配对设备列表 |
|
|
object |
|||
| DeviceId |
string |
设备唯一标识 |
f92620d6bea04f65d48cf603c57b367c97e837c1ab9f6d78f741f477e99d857c |
| DisplayName |
string |
设备显示名称 |
empty |
| Platform |
string |
操作系统平台 |
linux |
| DeviceFamily |
string |
硬件类别 |
empty |
| ClientId |
string |
客户端标识 |
cli |
| ClientMode |
string |
客户端模式 |
cli |
| Role |
string |
设备角色 |
operator |
| Scopes |
array |
权限作用域列表 |
|
|
string |
权限作用域 |
operator.admin |
|
| CreatedAtMs |
integer |
设备配对创建时间(Unix 毫秒) |
1778659807727 |
| LastSeenAtMs |
integer |
设备最后活跃时间(Unix 毫秒) |
1778659807727 |
示例
正常返回示例
JSON格式
{
"RequestId": "A7E6A8FD-C50B-46B2-BA85-D8B8D3******",
"Message": "successful",
"Code": 200,
"ApplicationId": "pa-**************",
"Pending": [
{
"PairRequestId": "test-1778647932986",
"DeviceId": "device-784x37k0vko734fk",
"PublicKey": "test-pubkey-base64url",
"DisplayName": "test",
"Platform": "linux",
"DeviceFamily": "server",
"ClientId": "cli",
"ClientMode": "cli",
"Role": "operator",
"Roles": [
"operator"
],
"Scopes": [
"operator.read"
],
"RemoteIp": "127.0.0.1",
"Silent": false,
"IsRepair": false,
"Ts": 1778660347550
}
],
"Paired": [
{
"DeviceId": "f92620d6bea04f65d48cf603c57b367c97e837c1ab9f6d78f741f477e99d857c",
"DisplayName": "empty",
"Platform": "linux",
"DeviceFamily": " empty",
"ClientId": "cli",
"ClientMode": "cli",
"Role": "operator",
"Scopes": [
"operator.admin"
],
"CreatedAtMs": 1778659807727,
"LastSeenAtMs": 1778659807727
}
]
}
错误码
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。