获取顶级文件夹 ID
获取顶级文件夹 ID,需要 SID,safekey,timeStamp,返回顶级文件夹的 ID。
URL
https://root_url/partner/api/cloud.api.php?action=getTopFolderId
HTTP Request Methods
编码格式
请求参数
key |
必填 |
更多限制 |
说明 |
规则说明 |
SID |
是 |
无 |
机构认证 ID |
通过 eeo.cn 申请机构认证可获得 |
safeKey |
是 |
固定 32 位全小写字符 |
机构认证安全密钥 |
safeKey=MD5(SECRET+timeStamp) |
timeStamp |
是 |
无 |
当前调用接口20分钟以内的 Unix Epoch 时间戳 |
Unix Epoch 时间戳是 1970年1月1日00:00:00 (世界标准时间) 起经过的秒数 |
响应参数
参数名 |
类型 |
示例值 |
含义 |
data |
string |
123456 |
返回顶级文件夹 ID |
error_info |
object |
|
返回信息对象 |
└ errno |
number |
1 |
错误代码 |
└ error |
string |
"程序正常执行" |
错误详情 |
示例
POST /partner/api/cloud.api.php?action=getTopFolderId HTTP/1.1
www.eeo.cn
application/x-www-form-urlencoded
no-cache
SID=2339736&safeKey=479aeb917dfb34ff1bf6660a1a5f016c&timeStamp=1493798334
curl -H "Content-Type: application/x-www-form-urlencoded" -X "POST" \
-d "SID=1234567" \
-d "safeKey=0f7781b3033527a8cc2b1abbf45a5fd2" \
-d "timeStamp=1484719085" \
"https://root_url/partner/api/cloud.api.php?action=getTopFolderId"
响应示例(正常时返回的 json
数据包示例)
{
"data": "123456",
"error_info": {
"errno": 1,
"error": "程序正常执行"
}
}
错误码说明
错误码 |
说明 |
1 |
表示成功执行 |
100 |
表示参数不全或错误 |
102 |
表示无权限(安全验证没通过) |
106 |
表示无数据 |