短网址API,也被称为URL缩短服务,是一种网络技术,它允许用户将长的、复杂的URL转换为较短的、易于记忆或分享的形式。在提供的文档【短网址API_网址缩短API.doc】中,主要介绍了如何使用不同的请求类型来调用这个API来缩短URL。
我们可以看到API的基本调用格式是`http://qita.in/_app.php`,通过向这个地址发送GET请求,并在查询参数中指定`type`和`url`。`type`参数用于定义响应的数据格式,包括以下几种:
1. **text请求**:当`type=text`时,API会返回一个简单的文本格式的短URL,例如`http://qita.in/czGxml`。
2. **XML请求**:设置`type=xml`,API会以XML格式返回数据,包含短URL和状态信息。例如:
```xml
<response>
<short>http://qita.in/czG</short>
<status>0</status>
</response>
```
3. **JSON请求**:选择`type=json`,API返回JSON格式的数据,结构类似:
```json
{"short": "http:\/\/qita.in\/czG", "status": "0"}
```
4. **JSONP请求**:对于跨域请求,可以使用`type=jsonp`,并提供`callback`参数。例如,如果`callback`为`qita`,则响应为:
```javascript
qita({"short": "http:\/\/qita.in\/czG", "status": "0"})
```
5. **会员API请求**:如果提供了`user`参数,可能是为会员提供特定的服务或权限,返回的短URL可能会与非会员有所不同。
在实际应用中,可以通过不同的编程语言来调用这个API。文档中给出了jQuery和PHP的例子:
- **jQuery**:使用`$.getJSON`函数,支持JSONP,确保了跨域请求的可行性。
```javascript
$.getJSON('http://qita.in/_app.php?type=jsonp&url=' + encodeURIComponent('http://网址')+'&callback=?', function(data) {
alert(data.short);
});
```
- **PHP**:使用`file_get_contents`函数获取HTTP响应。
```php
echo file_get_contents("http://qita.in/_app.php?type=text&url=" . urlencode('http://网址'));
```
此外,文档中还提到了一个链接`http://qita.in/api.html`,这可能是完整的API文档或开发者指南,包含了更多关于API的使用细节和可能的其他功能,如错误处理、API密钥管理、自定义短域名等。
短网址API是一个方便实用的工具,尤其适用于社交媒体分享、邮件、短信等场景,能够提高用户体验,简化长URL的分享和传播。而这个特定的API提供多种响应格式,适应不同开发需求,并支持会员功能,具备一定的灵活性和扩展性。