贴图库接口开发文档

贴图库上传图片接口


贴图库接口开发文档

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

页面列表

ITEM_HTML