| 请求方法 | GET / POST |
| 数据编码 | application/x-www-form-urlencoded 或 application/json |
| 请求参数 |
key: 文本标识,长度为3-60位字符,仅支持以下字符:0-9a-zA-Z-_。 value: 文本数据,20万字符以下任意文本,value为空则表示删除记录。 由于没有密码鉴权保护,建议使用随机生成20位及以上的key,降低碰撞概率,减少业务风险。 |
| 请求示例 |
使用第一种方式请求需要设置伪静态,具体设置请参考后文。 【创建/更新】 example.com/123456?value=123 或 example.com/?key=123456&value=123 【删除】 example.com/123456?value= 或 example.com/?key=123456&value= 【读取】 example.com/123456 或 example.com/?key=123456 若使用GET方式更新数据,请先进行URLEncode编码处理,建议优先使用POST方法请求。 也支持application/json方式POST提交,只需提交{"key":123,"value":123}即可。 |
| 响应参数 |
status: 请求处理结果,1为成功,0为失败。 data.key: 自定义的文本标识。 data.url: 文本记录的URL,可以通过该URL读取文本数据。 req_id: API请求ID。 |
| 响应示例 | {
"status": 1,
"data": {
"key": "123456",
"url": "example.com/123456"
},
"req_id": "131690600e2b79b47108"
}
|
| 伪静态设置 |
注意:只有在使用目录请求的方式才需要设置伪静态,使用key和value参数请求无需设置伪静态 Nginx
location / {
if (!-e $request_filename) {
rewrite ^(.*)$ /index.php?key=$1 last;
break;
}
}
Apache
<IfModule mod_rewrite.c>
RewriteEngine On
# 如果请求的是文件或目录,直接访问
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
# 将类似 /123 这样的请求重写为 /index.php?key=123
RewriteRule ^([^/]+)/?$ index.php?key=$1 [QSA,L]
</IfModule>
|
| 在线体验 | https://textdb.online |
| 版权声明 | 本离线版本仅限授权用户部署使用,部署前请 联系我们 获取授权和获取安装指导。 |