上传电脑图片 上传网络图片 应用中心 套餐服务 开发文档 插件下载
关于我们
登录   |

开发文档

贴图库上传接口及开发文档。

接口调用地址:

http://up.imgapi.com/

HTTP请求方式:Post

开发示例下载:JS版

参数列表

名称 类型 是否必填 示例值 默认值 描述
deadline int 1420041660 当前Unix时间戳+60
aid int 1 相册ID 可以在开放平台查询
from string 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参数
4501Token参数值为空
4502Token参数值无效
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修改图片名称失败