极易存储API文档说明

文档说明总则

1、文档列举参数方式为{time} 代表获取参数变量名称为time的具体值，其中{和}只是变量名称界限区分的限定符
2、文档列举md5算法为32位小写md5，例如 343d9040a671c45832ee5381860e2996
3、文档列举时间戳代表为unix时间戳是从1970年1月1日（UTC/GMT的午夜）开始所经过的秒数，不考虑闰秒，例如 1642671883 。
4、文档列举secureKey参数是在注册账号系统自动生成的每个账号唯一值的加密字符串,可以在【套餐信息】中查看，请妥善保管避免泄漏

用户相关接口说明

1、接口统一请求地址： http://pan.coders100.com/api.php
2、接口统一请求方式： HTTP GET
3、接口统一请求参数： secureKey 和 act
4、接口列表说明如下

4.1、 http://pan.coders100.com/api.php?secureKey=efdd3b18dd9ed21f299795c5dbba25a5&act=getDownConfig 请求获取【访问配置数据】

{
    "code": 0,
    "msg": "SUCCESS",
    "data": {
        "id": "1",
        "uid": "1",
        "type": "3",
        "ctime": "2022-01-18 16:30:46",
        "config": "{\"token\":\"abcdef\",\"blackIP\":\"222.222.222.222\",\"whiteIP\":\"127.0.0.1,1.1.1.1\",\"referer\":\"\"}"
    }
}

4.2、 http://pan.coders100.com/api.php?secureKey=efdd3b18dd9ed21f299795c5dbba25a5&act=getRemainRate 请求获取剩余流量字节

{
    "code": 0,
    "msg": "SUCCESS",
    "data": {
        "remain": 532213857769
    }
}

4.3、 http://pan.coders100.com/api.php?secureKey=efdd3b18dd9ed21f299795c5dbba25a5&act=getRemainDisk 请求获取剩余容量字节

{
    "code": 0,
    "msg": "SUCCESS",
    "data": {
        "remain": 532213857769
    }
}

4.4、 http://pan.coders100.com/api.php?secureKey=efdd3b18dd9ed21f299795c5dbba25a5&act=getUploadData 请求获取上传文件列表

{
    "code": 0,
    "msg": "SUCCESS",
    "data": [
        {
            "status": "1",     # 1代表正常态，3代表待同步云存储
            "fid": "2",        # 文件ID
            "filename": "ideaIU-2021.2.2.exe", # 上传文件原始名称
            "ctime": "2022-01-20 19:05:12"    #  文件上传时间
        }
    ]
}

4.5、 http://pan.coders100.com/api.php?secureKey=efdd3b18dd9ed21f299795c5dbba25a5&act=getDownloadData 请求获取下载文件列表

{
    "code": 0,
    "msg": "SUCCESS",
    "data": [
        {
            "fid": "1",   # 文件资源ID
            "filename": "中国水科院2006～2010博士生入学考试数学试题.pdf.pdf",   #上传文件原始名称
            "ctime": "2022-01-20 18:40:54"  # 文件下载时间
        },
        {
            "fid": "2",
            "filename": "ideaIU-2021.2.2.exe",
            "ctime": "2022-01-20 19:07:36"
        },
        {
            "fid": "2",
            "filename": "ideaIU-2021.2.2.exe",
            "ctime": "2022-01-20 19:38:35"
        },
        {
            "fid": "2",
            "filename": "ideaIU-2021.2.2.exe",
            "ctime": "2022-01-20 19:38:52"
        },
        {
            "fid": "2",
            "filename": "ideaIU-2021.2.2.exe",
            "ctime": "2022-01-20 19:39:46"
        },
        {
            "fid": "2",
            "filename": "ideaIU-2021.2.2.exe",
            "ctime": "2022-01-20 19:40:04"
        },
        {
            "fid": "2",
            "filename": "ideaIU-2021.2.2.exe",
            "ctime": "2022-01-20 19:41:12"
        }
    ]
}

上传资源文件到云存储系统

请求地址: http://10086.94cto.com/upload.php
请求方式: HTTP POST enctype=multipart/form-data
请求参数(以下参数均为必传)
- token
- uid
- time
- file
可选参数
- responseType 返回的数据格式，默认为html内容，若传递 responseType=json 则返回json格式
参数说明
- token 校验请求的合法性参数，加密方式为两次md5具体公式为 token = md5(md5({secureKey}{time}{uid})) 其中 secureKey 在登录后到【套餐信息】中查看
- uid 此次上传用户的uid数值，可以登录后在【套餐信息】中查看UID
- time 当前请求的时间戳参数，请注意是秒级别，并且保障传入时间戳的值与服务器偏差不得大于1800秒，否则会报错
- file 代表了POST请求表单中type="file"的表单项的name="file"
返回说明
- 以下说明仅针对JSON格式，HTML格式，请自行在平台页面上体验查看
- 失败返回信息，code非0，msg代表具体的错误信息
- 成功返回信息，code为0，msg信息固定为succeed, fid为上传的该文件的唯一ID

从云存储系统中下载文件

请注意从云存储中下载文件的前提是文件已经成功上传并且同步到云存储系统，即您的上传文件必须状态为【正常状】才可以被下载哦，具体状态信息可以查看【上传列表】
当文件可以正常被下载时候，接口直接会返回下载文件的二进制流信息提供下载，其他情况依据您是否传递responseType返回为html格式或json格式的报错信息
请求地址: http://10086.94cto.com/cloudDown.php
请求方式: HTTP GET
请求参数(以下参数均为必传)
- time
- id
- uid
- auth
可选参数
- responseType 返回的数据格式，默认在发生异常错误情况返回为html内容，若传递 responseType=json 则返回json格式
条件参数
- 若【访问配置】中设置了token的配置项目，需要额外传递token和expire两个参数，两个参数说明参见【其他说明】中的介绍
参数说明
- time 当前请求的时间戳参数，请注意是秒级别，并且保障传入时间戳的值与服务器偏差不得大于1800秒，否则会报错
- id 上传成功后资源文件ID信息，可以从【上传列表】中查看
- uid 此资源上传的用户的uid数值，可以登录后在【套餐信息】中查看UID
- auth 校验请求的合法性参数，加密方式为两次md5具体公式为 auth = md5(md5({time}{uid}{secureKey}{id})) 其中 secureKey 在登录后到【套餐信息】中查看
其他说明
- 如果您配置了【访问配置】，则需要特别注意下载请求是否符合访问配置中的约束条件，例如referer/黑名单/白名单/token配置等
- 如果您在【访问配置】中设置了token，那么请求下载时候，必须多传递两个参数token和expire，其中expire代表链接过期的时间戳，token加密公式为2次md5，具体公式为token = md5(md5({time}{访问配置中设置的token值}{secureKey}{expire}))，具体请求例子如下所示
- 访问配置中配置了token之后的请求参数的例子: http://10086.94cto.com/cloudDown.php?uid=76551&id=789964&auth=8e0129e171bd93ace8230528e8b0d7f5&time=1642671088&expire=1642674688&token=a6b18fecc55d05679d3589d5dd0059f8
- 如果【访问配置】中设置了referer约束，请务必注意请求下载的时候，传递的referer必须满足配置的referer的约束
返回说明
- 以下说明仅针对JSON格式，HTML格式，请自行在平台页面上体验查看
- 失败返回信息，code非0，msg代表具体的错误信息
- 成功直接返回需要下载的资源文件的二进制流信息

从云存储系统中删除文件

请求地址: http://10086.94cto.com/remove.php
请求方式: HTTP GET
请求参数(以下参数均为必传)
- time
- id
- uid
- auth
可选参数
- responseType 返回的数据格式，默认在发生异常错误情况返回为html内容，若传递 responseType=json 则返回json格式
参数说明
- time 当前请求的时间戳参数，请注意是秒级别，并且保障传入时间戳的值与服务器偏差不得大于1800秒，否则会报错
- id 上传成功后资源文件ID信息，可以从【上传列表】中查看
- uid 此资源上传用户的uid数值，可以登录后在【套餐信息】中查看UID
- auth 校验请求的合法性参数，加密方式为两次md5具体公式为 auth = md5(md5({time}{uid}{secureKey}{id})) 其中 secureKey 在登录后到【套餐信息】中查看
返回说明
- 以下说明仅针对JSON格式，HTML格式，请自行在平台页面上体验查看
- 失败返回信息，code非0，msg代表具体的错误信息
- 成功返回信息，code为0，msg固定为succeed