创建钉工牌电子码

POST

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

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

责任人：未设置

说明

调用本接口，为用户创建钉工牌电子码实例，主要用于访客、会展等临时证场景。
服务地址：api.dingtalk.com

权限

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

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

错误码

HttpCode	错误码	错误信息	说明
400	userNotInExtContact	用户不在外部联系人	用户不在外部联系人
400	invalidCodeIdentity	非法的码标识	非法的码标识
400	corpNotOpen	企业未开通指定的码	企业未开通指定的码
400	noAuthority	无权限调用	无权限调用
400	userCodeExist	用户码已存在	用户码已存在
400	userNotExist	用户不存在	用户不存在
400	invalidMobileFormat	手机号格式非法	手机号格式非法
400	notCorpStaff	非企业内部员工	非企业内部员工
400	invalidAvailableTime	有效时间非法	有效时间非法
500	unknownError	未知错误	未知错误

请求参数

Header 参数

Body 参数application/json

示例

{}

请求示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

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

返回响应

🟢200成功

application/json

Body

示例

{
    "codeId": "string"
}

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

更新钉工牌电子码