贴图库接口开发文档
接口描述
- 用户上传图片接口
请求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 | 更新图片数量失败 |