1. 创建对象
创建用对象
POST:http://api.xdua.com/fobj
所有字段都放置在body里
| 字段名 | 字段位置 | 字段类型 | 字段说明 | 举例 | 必选 |
|---|---|---|---|---|---|
| apiv | head | string | API版本,默认是1.0.0 | 1.0.0 | 可选 |
| Authorization | head | string | 客户端保存的鉴权token | Authorization字符串 | 必选 |
| url | body | string | 文件地址 | 文件的地址 | 必选 |
| name | body | string | 文件名字 | 默认是空 | 可选 |
| note | body | string | 文件备注 | 用于备注 | 可选 |
| size | body | string | 文件大小 | 以字节为单位的文件大小 | 可选 |
| cato | body | string | 文件类型 | 文件的类型 | 可选 |
| param | body | string | 文件参数 | 文件的参数 | 必选 |
服务会生成一个22字节的对象key
地球号对象服务致力于完成对象的存储/删/改/查询。为了尽可能的满足可能出现的多种查询,地球号增加了三种索引字段:key2,key3,key4。客户完全自定义使用key2/3/4。
const dua = await lovearth({
APP_KEY: "您的appkey",
APP_SECRET: "您的appsecret",
})
api_name = "添加文件";
add_params = {
url:"http://file.xdua.com/example2.txt",
size:1024,
param:{"version":"1.3.2"},
name:"作为案例的文件",
note:"这里是备注",
cato:"firmware"
}
res = await dua.addFobj(add_params)
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": ["ckey"=>"目录的key字符串，用它来做搜索"]
}
1.2. 失败的返回
{
"error": 1,
"reason": "失败原因",
"result": {"失败返回的参考数据"}
}
1.3. 错误码
错误码来自于error字段