#111: API Return the available languages

This commit is contained in:
Claude 2013-11-11 11:13:13 +01:00
parent 90c2d7f681
commit e2241dbb28
4 changed files with 72 additions and 51 deletions

View File

@ -9,6 +9,7 @@
* - random()
* - recent()
* - trending()
* - langs()
* Classes list:
* - Api extends Main
*/
@ -168,4 +169,10 @@ class Api extends Main
}
echo json_encode($data);
}
function langs()
{
$languages = $this->languages->get_languages();
echo json_encode($languages);
}
}

View File

@ -24,6 +24,9 @@
<h2>Get trending pastes</h2>
<p class="explain"><code><?php echo site_url('api/trending'); ?></code></p>
<h2>List available languages</h2>
<p class="explain"><code><?php echo site_url('api/langs'); ?></code></p>
<h2>Create a paste</h2>
<p class="explain"><code><?php echo site_url('api/create'); ?></code></p>

View File

@ -19,6 +19,9 @@
<h2>Get trending pastes</h2>
<p class="explain"><code><?php echo site_url('api/trending'); ?></code></p>
<h2>List available languages</h2>
<p class="explain"><code><?php echo site_url('api/langs'); ?></code></p>
<h2>Create a paste</h2>
<p class="explain"><code><?php echo site_url('api/create'); ?></code></p>

View File

@ -1,75 +1,83 @@
<?php $this->load->view("defaults/header");?>
<div class="api">
<h1>API</h1>
<p class="explain border">Create pastes from the commandline</p>
<div class="row">
<div class="span12">
<div class="page-header">
<h1>API</h1>
</div>
</div>
<div class="span12">
<p class="explain border">Create pastes from the commandline</p>
<h2>API URL</h2>
<p class="explain"><code><?php echo site_url('api'); ?></code></p>
<h2>API URL</h2>
<p class="explain"><code><?php echo site_url('api'); ?></code></p>
<h2>Get paste</h2>
<p class="explain"><code><?php echo site_url('api/paste/[pasteid]'); ?></code></p>
<h2>Get paste</h2>
<p class="explain"><code><?php echo site_url('api/paste/[pasteid]'); ?></code></p>
<h2>Get random paste</h2>
<p class="explain"><code><?php echo site_url('api/random'); ?></code></p>
<h2>Get random paste</h2>
<p class="explain"><code><?php echo site_url('api/random'); ?></code></p>
<h2>Get recent pastes</h2>
<p class="explain"><code><?php echo site_url('api/recent'); ?></code></p>
<h2>Get recent pastes</h2>
<p class="explain"><code><?php echo site_url('api/recent'); ?></code></p>
<h2>Get trending pastes</h2>
<p class="explain"><code><?php echo site_url('api/trending'); ?></code></p>
<h2>Get trending pastes</h2>
<p class="explain"><code><?php echo site_url('api/trending'); ?></code></p>
<h2>Create a paste</h2>
<p class="explain"><code><?php echo site_url('api/create'); ?></code></p>
<h2>List available languages</h2>
<p class="explain"><code><?php echo site_url('api/langs'); ?></code></p>
<h3>POST parameters</h3>
<code>text=[your paste text]</code>
<p class="explain">The paste content. Required.</p>
<h2>Create a paste</h2>
<p class="explain"><code><?php echo site_url('api/create'); ?></code></p>
<code>title=[title]</code>
<p class="explain">Title for the paste.</p>
<h3>POST parameters</h3>
<code>text=[your paste text]</code>
<p class="explain">The paste content. Required.</p>
<code>name=[name]</code>
<p class="explain">The author's name.</p>
<code>title=[title]</code>
<p class="explain">Title for the paste.</p>
<code>private=1</code>
<p class="explain">Make paste private.</p>
<code>name=[name]</code>
<p class="explain">The author's name.</p>
<code>lang=[language]</code>
<p class="explain">
Use alternative syntax highlighting.<br />
Possible values: <?php echo $languages; ?>
</p>
<code>private=1</code>
<p class="explain">Make paste private.</p>
<code>expire=[minutes]</code>
<p class="explain">Set paste expiration.</p>
<code>lang=[language]</code>
<p class="explain">
Use alternative syntax highlighting.<br />
Possible values: <?php echo $languages; ?>
</p>
<code>reply=[pasteid]</code>
<p class="explain">Reply to existing paste.</p>
<code>expire=[minutes]</code>
<p class="explain">Set paste expiration.</p>
<h3>Return values</h3>
<p class="explain">
On success, the API returns the paste URL: <code><?php echo site_url('view/[pasteid]'); ?></code><br />
On error, the API returns the error message: <code>Error: Missing paste text</code>
</p>
<code>reply=[pasteid]</code>
<p class="explain">Reply to existing paste.</p>
<h2>Examples</h2>
<h3>Create paste</h3>
<code>curl -d text='this is my text' <?php echo site_url('api/create'); ?></code>
<p class="explain">Create a paste with the text 'this is my text'.</p>
<h3>Return values</h3>
<p class="explain">
On success, the API returns the paste URL: <code><?php echo site_url('view/[pasteid]'); ?></code><br />
On error, the API returns the error message: <code>Error: Missing paste text</code>
</p>
<h3>Create paste from a file</h3>
<code>curl -d private=1 -d name=Herbert --data-urlencode text@/etc/passwd <?php echo site_url('api/create'); ?></code>
<p class="explain">Create a private paste with the author 'Herbert' and the contents of '/etc/passwd'.</p>
<h2>Examples</h2>
<h3>Create paste</h3>
<code>curl -d text='this is my text' <?php echo site_url('api/create'); ?></code>
<p class="explain">Create a paste with the text 'this is my text'.</p>
<h3>Create paste from a php file</h3>
<code>curl -d lang=php --data-urlencode text@main.php <?php echo site_url('api/create'); ?></code>
<p class="explain">Create a paste with PHP syntax highlighting.</p>
<h3>Create paste from a file</h3>
<code>curl -d private=1 -d name=Herbert --data-urlencode text@/etc/passwd <?php echo site_url('api/create'); ?></code>
<p class="explain">Create a private paste with the author 'Herbert' and the contents of '/etc/passwd'.</p>
<h3>Get paste ;-)</h3>
<code>curl <?php echo site_url('view/raw/[pasteid]'); ?></code>
<p class="explain">Display paste.</p>
<h3>Create paste from a php file</h3>
<code>curl -d lang=php --data-urlencode text@main.php <?php echo site_url('api/create'); ?></code>
<p class="explain">Create a paste with PHP syntax highlighting.</p>
<h3>Get paste ;-)</h3>
<code>curl <?php echo site_url('view/raw/[pasteid]'); ?></code>
<p class="explain">Display paste.</p>
</div>
</div>
<?php $this->load->view("defaults/footer");?>