文档中心 > API类目 > 钉钉API

dingtalk.oapi.openencrypt.encryptbox.status.update (更新加密盒子状态)

用于更新加密盒子状态，1表示盒子掉线，2表示盒子上线，3表示企业之前有盒子，现在变成了无盒子的状态

公共参数

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://gw.api.taobao.com/router/rest	https://eco.taobao.com/router/rest

名称	类型	是否必须	描述
access_token	String	是	钉钉提供的授权Token，想了解详情，ISV开发者请点击这里，企业开发者请点击这里。若有疑问，咨询邮箱dingding_open_dingtalk#list.alibaba-inc.com。

请求参数

名称	类型	是否必须	示例值	更多限制	描述
top_encrypt_box_status	TopEncryptBoxStatus	必须			请求参数
└ request_id String 必须 eab6cbe54683 请求的id └ corp_id String 必须 xxxx 组织的id └ status Number 必须 1 加密盒子状态，1表示盒子掉线，2表示盒子上线，3表示企业之前有盒子，现在变成了无盒子的状态 └ appid Number 必须 12345 微应用的id └ extension String 可选 "" 附加信息，方便扩展

响应参数

名称	类型	示例值	描述
errmsg	String	internal server error	错误消息
errcode	Number	500	内部错误
success	Boolean	true	误接口状态标记
result	String	""	一般是空字符串

请求示例

JAVA
.NET
PHP
CURL
Python
C/C++
NodeJS

DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/topapi/openencrypt/encryptbox/status/update");
OapiOpenencryptEncryptboxStatusUpdateRequest req = new OapiOpenencryptEncryptboxStatusUpdateRequest();
TopEncryptBoxStatus obj1 = new TopEncryptBoxStatus();
obj1.setRequestId("eab6cbe54683");
obj1.setCorpId("xxxx");
obj1.setStatus(1L);
obj1.setAppid(12345L);
obj1.setExtension("\"\"");
req.setTopEncryptBoxStatus(obj1);
OapiOpenencryptEncryptboxStatusUpdateResponse rsp = client.execute(req, access_token);
System.out.println(rsp.getBody());

IDingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/topapi/openencrypt/encryptbox/status/update");
OapiOpenencryptEncryptboxStatusUpdateRequest req = new OapiOpenencryptEncryptboxStatusUpdateRequest();
OapiOpenencryptEncryptboxStatusUpdateRequest.TopEncryptBoxStatusDomain obj1 = new OapiOpenencryptEncryptboxStatusUpdateRequest.TopEncryptBoxStatusDomain();
obj1.RequestId = "eab6cbe54683";
obj1.CorpId = "xxxx";
obj1.Status = 1L;
obj1.Appid = 12345L;
obj1.Extension = "\"\"";
req.TopEncryptBoxStatus_ = obj1;
OapiOpenencryptEncryptboxStatusUpdateResponse rsp = client.Execute(req, access_token);
Console.WriteLine(rsp.Body);

include "TopSdk.php";
date_default_timezone_set('Asia/Shanghai');

$c = new DingTalkClient(DingTalkConstant::$CALL_TYPE_OAPI, DingTalkConstant::$METHOD_POST , DingTalkConstant::$FORMAT_JSON);
$req = new OapiOpenencryptEncryptboxStatusUpdateRequest;
$top_encrypt_box_status = new TopEncryptBoxStatus;
$top_encrypt_box_status->request_id="eab6cbe54683";
$top_encrypt_box_status->corp_id="xxxx";
$top_encrypt_box_status->status="1";
$top_encrypt_box_status->appid="12345";
$top_encrypt_box_status->extension="\"\"";
$req->setTopEncryptBoxStatus($top_encrypt_box_status);
$resp = $c->execute($req, $access_token, "https://oapi.dingtalk.com/topapi/openencrypt/encryptbox/status/update");

curl -X POST "https://oapi.dingtalk.com/topapi/openencrypt/encryptbox/status/update" \
-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \
-d 'access_token=90ac4fea-c320-4908-9f06-746a4ed34fd9' \
-d 'top_encrypt_box_status=null'

# -*- coding: utf-8 -*-
import dingtalk.api

req=dingtalk.api.OapiOpenencryptEncryptboxStatusUpdateRequest("https://oapi.dingtalk.com/topapi/openencrypt/encryptbox/status/update")

req.top_encrypt_box_status=""
try:
	resp= req.getResponse(access_token)
	print(resp)
except Exception,e:
	print(e)

pTopRequest pRequest = alloc_top_request();
pTopResponse pResponse = NULL;
pTaobaoClient pClient = alloc_taobao_client(url, appkey, appsecret);
set_api_name(pRequest,"dingtalk.oapi.openencrypt.encryptbox.status.update");
add_param(pRequest,"top_encrypt_box_status","数据结构JSON示例");
pResponse = top_execute(pClient,pRequest,sessionKey);
printf("ret code:%d\n",pResponse->code);
if(pResponse->code == 0){
	pTopResponseIterator ite = init_response_iterator(pResponse);
	pResultItem pResultItem = alloc_result_item();
	while(parseNext(ite, pResultItem) == 0){
		printf("%s:%s\n",pResultItem->key,pResultItem->value);
	}
	destroy_response_iterator(ite);
	destroy_result_item(pResultItem);
}
destroy_top_request(pRequest);
destroy_top_response(pResponse);
destroy_taobao_client(pClient);

TopClient = require('./topClient').TopClient;
var client = new TopClient({
	'appkey': 'appkey',
	'appsecret': 'secret',
	'REST_URL': 'http://gw.api.taobao.com/router/rest'
});

client.execute('dingtalk.oapi.openencrypt.encryptbox.status.update', {
	'top_encrypt_box_status':'数据结构JSON示例'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

响应示例

JSON示例

{
    "errmsg":"internal server error",
    "errcode":500,
    "success":true,
    "result":"\"\""
}

异常示例

JSON示例

{
	"errcode":88,
	"errmsg":"ding talk error"
}

错误码解释

错误码	错误描述	解决方案

API工具

API测试工具错误码查询工具 SDK下载

如何获得此API

FAQ

我要提问

返回
顶部

淘宝开放平台

钉钉API

dingtalk.oapi.openencrypt.encryptbox.status.update (更新加密盒子状态)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ