配置企业钉工牌
POST
/v1.0/badge/codes/corpInstances最后修改时间:: 2 年前
责任人: 未设置
说明
调用本接口为企业企业开通钉工牌电子码。
权限
要调用此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
必需
扩展参数,是否关联支付宝。参数示例:
示例
{}
示例代码
返回响应
成功(200)
HTTP 状态码: 200
内容格式: JSONapplication/json
数据结构
codeIdentity
string
码标识。
corpId
string
可选
开通的企业corpId。
status
string
可选
状态,传入关闭状态需要用户手动开启后才会渲染二维码。
extInfo
object
扩展参数。
示例
{
"codeIdentity": "string",
"corpId": "string",
"status": "string",
"extInfo": {}
}
最后修改时间: 2 年前