贴图库接口开发文档
接口描述
- 用户上传图片接口
请求URL
http(s)://up.tietuku.cn
请求方式
- POST
参数
参数名 | 必选 | 类型 | 说明 | 默认值 |
---|---|---|---|---|
deadline | 是 | int | 当前Unix时间戳+60 | - |
aid | 是 | int | 相册ID 可以在[相册管理](http://www.tietuku.cn/console/index/index.html "相册管理")查询 | - |
from | 否 | string | 上传方式,通过URL方式上传必须填写为web |
file |
> from
的可选值只能为web
和file
,通过URL方式上传图片必须填写为web
我们可以用如下的HTML表单来描述表单文件上传的基本用法:
本地方式上传:
<form enctype="multipart/form-data" method="post" action="http://up.tietuku.cn/">
<input name="Token" value="<?php echo $Token ;?>" type="hidden">
<input type="file" name="file">
<input type="submit">
</form>
URL方式上传:
<form enctype="multipart/form-data" method="post" action="http://up.tietuku.cn/">
<input name="Token" value="<?php echo $Token ;?>" type="hidden">
<input type="txt" name="fileurl">
<input type="submit">
</form>
返回示例
{
"linkurl": "http://v0012.bvimg.com/10012/a62f35b88ccc6d45.jpg",
"name": "test.jpg"
}
Token获取
[[获取Token]](http://www.tietuku.cn/index/user/pickey.html "[Token获取]")
开发示例下载
[JS版](http://www.tietuku.cn/download/tietuku_JSAPI.zip ) PHP版
返回参数说明
参数名 | 类型 | 说明 |
---|---|---|
linkurl | string | 图片链接 |
name | string | 图片名称 |
错误码
错误码 | 错误描述 | 解决方案 |
---|---|---|
4001 | Token错误 上传凭证无效 | 检查生成Token的参数 |
4002 | 资源不存在 | - |
4003 | 关闭上传 | - |
4007 | 缺少图片链接 | - |
4008 | 获取本地上传图片信息失败 | - |
4009 | 获取网络上传图片信息失败 | - |
4011 | 存储临时文件失败 | - |
4012 | 不支持此类图片上传 | - |
4013 | 图片太大超过上传限制 | - |
4014 | 未能获取图片信息 | - |
4015 | 存储图片失败 | - |
4016 | 没有上传本地图片 | - |
4017 | 上传本地图片失败 | - |
4018 | 上传文件不存在 | |
4021 | 没有购买基础版服务或服务已到期 | 请续费基础服务 |
4023 | 没有购买存储服务 | 请购买存储服务 |
4506 | 用户提供Token参数值无效 | |
4507 | 公钥不存在或无效 | |
4511 | 相册不存在或已经删除 | |
4513 | 写入图片索引数据失败 | |
4516 | 写入图片数据失败 | |
4517 | 更新图片数量失败 |