开发文档

您可以使用我们的示例代码,或您也可以在这里选择合适的接口使用。

API接口

我们的统一API接口地址为:https://api.lanjuhua.com/rest,必须使用https,请保持更新。

搜索API

使用搜索API,可以搜索公有云所有文件,每个关键字1小时内只计费1次。

请求参数列表
字段 类型 说明
action String API名称,搜索API名称为“search”
keyword String 关键字
exts String 文件后缀名筛选,以逗号分隔
start Int 结果开始位置
limit Int 每次获取结果数量
order String 排序方式,3个选项 name, size, time
userid Int 您的用户ID,请在登录后获取
apikey String 密钥,请在登录后获取
返回参数列表
字段 类型 说明
code Int 状态代码,成功为2XX,一般为200。失败为4XX,一般是403
message String 若失败,则会提供失败原因
total Int 结果数量
results Array 结果集
results->id String 文件ID编号,动态变化,不建议存储
results->name String 文件名
results->ext String 文件后缀名
results->time Int 文件上传时间Unix Timestamp
results->size Long 文件大小

举例

POST /rest HTTP/1.1
HOST: api.lanjuhua.com
accept: text/plain
cache-control: no-cache
connection: keep-alive
content-type: application/json
{
  "action": "search",
  "keyword": "黄浦江的故事",
  "start": "0",
  "limit": "2",
  "order": "time",
  "userid": 1999,
  "apikey": "C4CA4238A0B923820DCC509A6F75849B"
}

//返回结果
正确:
返回用户key,格式如下
{
  "code": 200,
  "total": "11",
  "results": [
	{
	  "id": "BSgGPQpjUj1WYF04AWNSZA83B34EMFAwVzUPOVNuVzIENlFiWDU",
	  "name": "黄浦江的故事.The story of Huangpu River.1959.DVD.X264.AAC.mkv",
	  "ext": "mkv",
	  "size": 447916777,
	  "time": 1516014833
	},
	{
	  "id": "Un8BPg9hAW5WalIxUjVTZVx5VjpaaARjBmkFNgY6Vz5QZg",
	  "name": "黄浦江的故事.rar",
	  "ext": "rar",
	  "size": 76426767,
	  "time": 1423143549
	}
  ]
}

错误:
返回json格式错误说明

文件信息API

使用文件信息API,可以具体查看到文件信息,1小时内只计费1次。

请求参数列表
字段 类型 说明
action String API名称,搜索API名称为“file_info”
id String 文件ID编号,通过搜索API获得
userid Int 您的用户ID,请在登录后获取
apikey String 密钥,请在登录后获取
返回参数列表
字段 类型 说明
code Int 状态代码,成功为2XX,一般为200。失败为4XX,一般是403
message String 若失败,则会提供失败原因
id String 文件ID编号,动态变化,不建议存储
name String 文件名
ext String 文件后缀名
time Int 文件上传时间Unix Timestamp
size Long 文件大小
chunkId String 存储库内文件ID编号,需要通过本ID编号和文件ID获取下载地址

举例

POST /rest HTTP/1.1
HOST: api.lanjuhua.com
accept: text/plain
cache-control: no-cache
connection: keep-alive
content-type: application/json
{
  "action": "file_info",
  "id": "BSgGPQpjUj1WYF04AWNSZA83B34EMFAwVzUPOVNuVzIENlFiWDU",
  "userid": 1999,
  "apikey": "C4CA4238A0B923820DCC509A6F75849B"
}

//返回结果
正确:
返回用户key,格式如下
{
  "code": 200,
  "id": "BSgGPQpjUj1WYF04AWNSZA83B34EMFAwVzUPOVNuVzIENlFiWDU",
  "name": "黄浦江的故事.The story of Huangpu River.1959.DVD.X264.AAC.mkv",
  "ext": ".mkv",
  "size": 447916777,
  "time": 1516014833,
  "chunkId": "61394828b3fa77e55f468d3ccec3368b"
}

错误:
返回json格式错误说明

文件下载地址API

文件下载地址API分2种,第一种是低速下载地址,低速下载地址暂时免费,可以直接提供给用户下载。第二种是高速下载地址,需要从您的服务器通过反向代理技术提供给您的用户,将会使用您的服务器的宽带流量,1小时内只计费1次。

请求参数列表
字段 类型 说明
action String API名称,搜索API名称为“file_url”
id String 文件ID编号,通过搜索API获得
chunkId String 存储库文件ID编号,通过文件信息API获得
type String low,high,all 获取低速地址、高速地址,还是全部获取
userid Int 您的用户ID,请在登录后获取
apikey String 密钥,请在登录后获取
返回参数列表
字段 类型 说明
code Int 状态代码,成功为2XX,一般为200。失败为4XX,一般是403
message String 若失败,则会提供失败原因
id String 文件ID编号,动态变化,不建议存储
name String 文件名
ext String 文件后缀名
time Int 文件上传时间Unix Timestamp
size Long 文件大小
chunkId String 存储库内文件ID编号,需要通过本ID编号和文件ID获取下载地址

举例

POST /rest HTTP/1.1
HOST: api.lanjuhua.com
accept: text/plain
cache-control: no-cache
connection: keep-alive
content-type: application/json
{
  "action": "file_url",
  "id": "BSgGPQpjUj1WYF04AWNSZA83B34EMFAwVzUPOVNuVzIENlFiWDU",
  "chunkId": "61394828b3fa77e55f468d3ccec3368b",
  "type": "all",
  "userid": 1999,
  "apikey": "C4CA4238A0B923820DCC509A6F75849B"
}

//返回结果
正确:
返回用户key,格式如下
{
  "code": 200,
  "id": "Ay4GPw1gBmJUYVAzUzQGMVp_VDJValM2B2YPPw8_UjcCNgU4",
  "lowspeed_url": "http://47.74.145.239:8080/cache/%E8%8E%AB%E6%96%87%E8%94%9A%2B%E9%84%AD%E5%B0%91%E7%A7%8B%20-%20%E4%B8%96%E9%96%93%E5%A7%8B%E7%B5%82%E4%BD%A0%E5%A5%BD.rar?ctt=1530598629&ctk=Fv4JP1RyCKwk71zb0mS9Jg&chk=e739c7b5b4d60916f8db5c15b2d4851a-6941710",
  "highspeed_url": "http://180.97.83.178:443/down/test",
  "checksum": "WAQKKALZAP"
}

错误:
返回json格式错误说明