1. 创建对象
创建用对象
POST:http://api.xdua.com/obj
所有字段都放置在body里
| 字段名 | 字段位置 | 字段类型 | 字段说明 | 举例 | 必选 |
|---|---|---|---|---|---|
| apiv | head | string | API版本,默认是1.0.0 | 1.0.0 | 可选 |
| Authorization | head | string | 客户端保存的鉴权token | Authorization字符串 | 必选 |
| key | body | string | 对象键名 | 小于等于128位的字符串,在一个应用下一个用户的key必须保持唯一,可中文 | 必选 |
| key2 | body | string | 对象键二 | 用了辅助索引的第二索引字段,最长128个字节,同一应用用户下可以相同 | 可选 |
| key3 | body | string | 对象键三 | 用了辅助索引的第三索引字段,最长128个字节,同一应用用户下可以相同 | 可选 |
| key4 | body | string | 对象键四 | 用了辅助索引的第四索引字段,最长128个字节,同一应用用户下可以相同 | 可选 |
| value | body | string | 对象的值 | 小于等于4096字节的字符串,或者串化的JSON对象 | 必选 |
地球号对象服务致力于完成对象的存储/删/改/查询。为了尽可能的满足可能出现的多种查询,地球号增加了三种索引字段:key2,key3,key4。客户完全自定义使用key2/3/4。
const dua = await lovearth({
APP_KEY: "您的appkey",
APP_SECRET: "您的appsecret",
})
api_name = "添加对象";
res = await dua.addObj({
key : "obj_key",
key2 : "obj_index_key2",
value: 'obj_value as string'
})
console.log(res);
if(res.error == 0){
console.log(api_name+"成功");
}else{
console.log(api_name+"失败 "+res.reason);
}
1.1. 成功的返回
返回的id便是新创建的obj的id.
{
"error": 0,
"reason": "Success",
"result": ["id"=>"obj的key"]
}
1.2. 失败的返回
{
"error": 1,
"reason": "失败原因",
"result": {"失败返回的参考数据"}
}
1.3. 错误码
错误码来自于error字段