配置企业钉工牌

POST

http://127.0.0.1/v1.0/badge/codes/corpInstances

新版服务端API（DingTalk OpenAPI）/钉工牌/使用AccessToken调用

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

责任人：未设置

说明

调用本接口为企业企业开通钉工牌电子码。

权限

要调用此API，需要以下权限之一。

应用类型	是否支持	权限	API Explorer调试
企业内部应用	支持	钉工牌基础数据写权限	API Explorer
第三方企业应用	支持	钉工牌基础数据写权限	API Explorer
第三方个人应用	暂不支持	钉工牌基础数据写权限	暂不支持

错误码

HttpCode	错误码	错误信息	说明
400	missingParameter	缺少必须参数	缺少必须参数
500	unknownError	未知错误	未知错误

请求参数

Header 参数

x-acs-dingtalk-access-token

string

必需

调用该接口的访问凭证。如何获取不同应用的凭证请参考访问凭证概述。

Body 参数application/json

codeIdentity

string

码标识，取值：

必需

corpId

string

必需

开通的企业corpId。

status

string

必需

状态，传入关闭状态需要用户手动开启后才会渲染二维码。

extInfo

object

必需

扩展参数，是否关联支付宝。参数示例：

示例

{}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'http://127.0.0.1/v1.0/badge/codes/corpInstances' \
--header 'x-acs-dingtalk-access-token;' \
--header 'Content-Type: application/json' \
--data-raw '{}'

返回响应

🟢200成功

application/json

Body

codeIdentity

string

码标识。

可选

corpId

string

可选

开通的企业corpId。

status

string

可选

状态，传入关闭状态需要用户手动开启后才会渲染二维码。

extInfo

object

扩展参数。

可选

示例

{
  "codeIdentity": "string",
  "corpId": "string",
  "status": "string",
  "extInfo": {}
}

同步钉工牌码验证结果

创建钉工牌电子码

配置企业钉工牌

说明#

权限#

错误码#

请求参数

示例代码

返回响应

说明

权限

错误码