贴图库接口开发文档
<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>本地方式上传:
<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></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>