批量新增wifi信息

POST

http://127.0.0.1/topapi/attendance/group/wifis/add

服务端API/考勤/考勤组管理

最后修改时间：2022-08-30 09:19:22

责任人：未设置

说明

调用本接口为指定考勤组批量新增wifi信息。
服务地址：https://oapi.dingtalk.com

权限

服务端API是以应用维度授权的，在调用接口前，确保已经为应用添加了接口权限。

应用类型	是否支持调用	权限申请方式	API Explorer调试
企业内部应用	是	开发者后台申请	调试
第三方企业应用	否	—	—
第三方个人应用	否	—	—

请求参数

Query 参数

access_token

string

必需

调用服务端API授权凭证，可通过获取企业内部应用的access_token接口获取。

示例值:

1eb68xxx

Body 参数application/json

op_userid

string

可选

操作人的userid

group_key

string

必需

考勤组ID。如果你使用的考勤组标识是group_id，可以调用groupId转换为groupKey接口将group_id转换为group_key。

wifi_list

array [object {3}]

wifi列表。

必需

foreign_id

string

必需

业务方wifiId。

mac_addr

string

MAC地址。

必需

ssid

string

名称。

必需

示例

{
  "wifi_list": [
    {
      "foreign_id": "alibaba-guest",
      "mac_addr": "02:10:18:11:11:11",
      "ssid": "alibaba-guest1"
    },
    {
      "foreign_id": "alibaba-inc",
      "mac_addr": "11:11:11:11:11:11",
      "ssid": "alibaba-guest1"
    }
  ],
  "op_userid": "user01",
  "group_key": "0151E0xxx"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'http://127.0.0.1/topapi/attendance/group/wifis/add?access_token=1eb68xxx' \
--header 'Content-Type: application/json' \
--data-raw '{
    "wifi_list": [
        {
            "foreign_id": "alibaba-guest",
            "mac_addr": "02:10:18:11:11:11",
            "ssid": "alibaba-guest1"
        },
        {
            "foreign_id": "alibaba-inc",
            "mac_addr": "11:11:11:11:11:11",
            "ssid": "alibaba-guest1"
        }
    ],
    "op_userid": "user01",
    "group_key": "0151E0xxx"
}'

返回响应

🟢200成功

application/json

Body

result

object

返回的信息。

可选

result

object

添加wifi结果。

可选

errcode

number

返回码。

可选

errmsg

string

返回码描述。

可选

success

boolean

是否成功。

可选

request_id

string

请求ID。

可选

示例

{
  "result": {
    "result": {
      "error_info_list": [
        {
          "failure_list": [
            {
              "foreign_id": "string",
              "mac_addr": "string",
              "ssid": "string",
              "wifi_key": "string"
            }
          ],
          "msg": "string",
          "code": "string"
        }
      ],
      "success_list": [
        {
          "foreign_id": "string",
          "mac_addr": "string",
          "ssid": "string",
          "wifi_key": "string"
        }
      ]
    },
    "errcode": 0,
    "errmsg": "string",
    "success": true,
    "request_id": "string"
  }
}

修改于 2022-08-30 09:19:22

搜索考勤组摘要

批量移除wifi

批量新增wifi信息

说明#

权限#

请求参数

示例代码

返回响应

说明

权限