1. 删除对象
DELETE:http://api.xdua.com/obj/{key}
下面这些字段放到post的body里
字段名 | 字段位置 | 字段类型 | 字段说明 | 举例 | 可选 |
---|---|---|---|---|---|
apiv | head | string | API版本,默认是1.0.0 | 1.0.0 | 可选 |
Authorization | head | string | 客户端保存的鉴权token,通过登陆获取的 | Authorization字符串 | 必选 |
key | path | string | 对象的id | <=128位的字符串 | 必须 |
魔法参数key = %allkeys%
如果key设置为%allkeys%的时候,删除操作会清除本用户下的所有记录。这个动作非常危险,未来可能成为本系统的安全威胁。 如果获取了某用户的一个新鲜的token,那么就可以删除这个用户下的所有对象。这样的设计是愚蠢的,自杀级的设计。 本魔法参数仅仅用于临时的调试任务。
todo:未来的一个解决方案是,在用户要清除自己账户下所有对象的时候,需要客户自己重新登录一次,获取一个非常新鲜的token, 后台API要对token的生成时间做检查,必须在最近的token才可以有效.
返回数据
成功返回
{
"error": 0,
"reason": "Success",
"result": None,
}
失败返回
{
"error": >0,
"reason": "失败原因"
"result": None,
}
1.1. 错误码
错误码来自于error字段
1.2. Browser SDK调用示例代码
const dua = await lovearth({
APP_KEY: "您的appkey",
APP_SECRET: "您的appsecret",
})
api_name = "删除对象";
res = await dua.delObj('obj_key')
console.log(res);
if(res.error == 0){
console.log(api_name+"成功");
}else{
console.log(api_name+"失败 "+res.reason);
}