上传接口(快速生成Token)
接口调用地址:
HTTP请求方式:Post
参数列表
名称 | 类型 | 是否必填 | 示例值 | 默认值 | 描述 |
deadline | int | 是 | 1420041660 | 当前Unix时间戳+60 | |
aid | int | 是 | 1 | 相册ID 可以在开放平台查询 | |
from | string | 是 | web | file | 上传方式 通过URL方式上传必须填写为web |
from
的可填写的值只能为web
和file
通过URL方式上传图片必须填写为web
我们可以用如下的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 | 没有购买基础版服务或服务已到期 | 请开通套餐服务 |
4022 | 图片数量达到非专业版用户数量限制 | 请开通专业版 |
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 | 修改图片名称失败 |