开发文档

接口调用地址：

http://up.imgapi.com/

HTTP请求方式：Post

开发示例下载： JS版 PHP版

参数列表

名称	类型	是否必填	示例值	默认值	描述
deadline	int	是	1420041660		当前Unix时间戳+60
aid	int	是	1		相册ID 可以在开放平台查询
from	string	是	web	file	上传方式通过URL方式上传必须填写为`web`

from的可填写的值只能为web和file通过URL方式上传图片必须填写为web

我们可以用如下的HTML表单来描述表单文件上传的基本用法：

<form enctype="multipart/form-data" method="post" action="http://up.imgapi.com/">
<input name="Token" value="<?php echo $Token ;?>" type="hidden">
<input type="file" name="file">
<input type="submit">
</form>

我们可以用如下的HTML表单来描述表单URL上传的基本用法：

<form method="post" action="http://up.imgapi.com/">
<input name="Token" value="<?php echo $Token ;?>" type="hidden">
<input type="text" name="fileurl">
<input type="submit">
</form>

Token如何获取？点击获取Token

返回格式如下：

{"width":"1365","height":"768","type":"jpg","size":"32570","ubburl":"[url=http://tietuku.com/fed3e1c4dc63d1ab2][img]http://i2.piimg.com/fed3e1c4dc63d1ab.jpg[/img][/url]","linkurl":"http://i2.piimg.com/fed3e1c4dc63d1ab.jpg","htmlurl":"<a href='http://tietuku.com/fed3e1c4dc63d1ab2' target='_blank'><img src='http://i2.piimg.com/fed3e1c4dc63d1ab.jpg' /></a>","s_url":"http://i2.piimg.com/fed3e1c4dc63d1abs.jpg","t_url":"http://i2.piimg.com/fed3e1c4dc63d1abt.jpg"}

返回值说明

名称	类型	示例值	描述
width	int	500	图片的宽
height	int	750	图片的高
size	int	152880	图片大小(单位:字节)
ubburl	string		图片UBB引用代码
htmlurl	string		图片HTML引用代码
linkurl	string		图片原图地址
markdown	string		图片markdown引用代码
s_url	string		图片展示图地址
t_url	string		图片缩略图地址

错误码

错误码	错误描述	解决方案
401	Token错误	检查生成Token的参数

错误码	错误描述	解决方案
4001	上传凭证无效。	检查生成Token的参数
4002	资源不存在。
4003	关闭上传
4004	请求方式错误，非预期的请求方式。
4005	验证Token返回值为空
4006	无法创建存储目录或目录不可写
4007	缺少图片链接
4008	获取本地上传图片信息失败
4009	获取网络上传图片信息失败
4010	打开临时文件失败
4011	存储临时文件失败
4012	不支持此类图片上传
4013	图片太大超过上传限制
4014	未能获取图片信息
4015	存储图片失败
4016	没有上传本地图片
4017	上传本地图片失败
4018	上传文件不存在
4019	达到用户每小时上传数量上限	请升级套餐服务
4020	达到用户单个IP每小时上传数量上限	请升级套餐服务
4021	没有购买基础版服务或服务已到期	请开通套餐服务
4500	缺失Token参数
4501	Token参数值为空
4502	Token参数值无效
4503	公钥无效
4504	路径参数无效
4505	上传公钥等级低
4506	用户提供Token参数值无效
4507	公钥不存在或无效
4510	用户账户不存在或被封
4511	相册不存在或已经删除
4512	不是你的相册，无权操作
4513	写入数据失败
4516	写入图片数据失败
4517	更新图片数量失败
4518	保存已存在图片信息到数据库失败
4519	缺失UID参数
4520	会员账号无效
4521	相册数量不能超过100个
4522	相册名称无效
4523	相册名称长度为3-20字符
4524	只有一个相册时，无法删除
4525	相册ID无效或该用户无权限操作该相册
4526	该相册内有照片，无法删除
4527	相册aid参数无效
4528	插入findurl失败
4529	图片不存在
4530	权限不足
4531	删除图片失败
4532	缺失图片ID
4533	没有找到相关信息
4534	修改图片名称失败

上传接口(快速生成Token)

参数列表

返回值说明

错误码

错误码汇总