qurl/assets/usage.html

48 lines
1.4 KiB
HTML
Raw Permalink Normal View History

2018-11-23 19:18:26 -09:00
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>qurl.org - API usage</title>
<style>
body { font-size: 14px; }
pre { font-size: 12px; border-left: 3px solid blue; padding-left: 10px; }
ul { margin: 0px; padding: 0px; }
li { margin: 0px 0px 0px 20px; padding: 0px; }
</style>
</head>
<body>
<h1>API usage</h1>
<p>API URL: http://qurl.org/api/url</p>
<p>
<ul>Parameters (GET or POST)
<li><b>url</b> The url to be shortened</li>
</ul>
</p>
<p>
<ul>JSON Response
<li><b>url</b> <i>(string)</i> the shortened url (e.g. http://qurl.org/0)</li>
<li><b>exists</b> <i>(boolean)</i> true if the provided URL was already in the database</li>
<li><b>error</b> <i>(string)</i> error message if url could not be shortened (e.g. "Invalid URL")</li>
</ul>
</p>
<h1>API example</h1>
<p>
<b>Submit:</b><pre>http://qurl.org/api/url?url=http://fark.com</pre>
<b>Response:</b><pre>{"exists":true,"url":"http:\/\/qurl.org\/s"}</pre>
</p>
<br/>
<p>
<b>Submit:</b><pre>http://qurl.org/api/url?url=http://klasjdlh.com</pre>
<b>Response:</b><pre>{"exists":false,"url":"http:\/\/qurl.org\/Z1q"}</pre>
</p>
<br/>
<p>
<b>Submit:</b><pre>http://qurl.org/api/url?url=notaurl</pre>
<b>Response:</b><pre>{"error":"Not a valid URL."}</pre>
</p>
</body>
</html>