添加企业下的小鱼终端

功能说明

默认接口请求频率限制：20 次/秒

实现方法

REST URL

POST https://sdk.xylink.com/api/rest/external/{version}/buffet/nemos?enterpriseId=XXX&signature=XXX

请求参数说明

参数	参数类型	参数位置	必须	默认值	说明	初始平台
version	String	Path	是	无	传v1即可
enterpriseId	String	Query	是	无	企业ID，通过管理平台-云视讯API获得
signature	String	Query	签名鉴权1.0（旧）：是签名鉴权2.0：否	无	API签名，参考签名鉴权
nemoNumber	String	Body	否	无	小鱼号：小鱼号和小鱼终端 SN二选一。	3.9
deviceSN	String	Body	否	无	小鱼终端 SN：小鱼号和小鱼终端 SN二选一。	3.9
displayName	String	Body	是	无	小鱼终端名称	3.9

示例代码

请求示例

请求消息体示例（Json）

[
  {
    "displayName": "视频会议终端",
    "nemoNumber": "533435353"
  },
  {
    "deviceSN": "9Z30073C62D0EE61",
    "displayName": "视频会议终端"
  }
]

结果示例

请求成功结果示例

{
  "failedDevices": [
    {
      "deviceSN": null,
      "nemoNumber": "xxxxxx",
      "model": null,
      "errorStatus": "8002",
      "errorMsg": "nemoid.numberPO.not.exists"
    }
  ],
  "succeedDevices": [
    {
      "deviceSN": "xxxxxx",
      "nemoNumber": null,
      "model": "ME90",
      "errorStatus": "0",
      "errorMsg": "device.add.success"
    }
  ]
}

请求失败结果示例

{
    "developerMessage": "ErrorStatus: SDK_INVALID_APPKEY No app found for extId: ",
    "userMessage": "sdk.invalid.key",
    "errorCode": 60001,
    "moreInfo": "http://www.com.ainemo.com/errors/60001"
}

错误码

错误码见小鱼RESTAPI错误码

2023-11-30 10:19:08