{% extends "base.html" %}
{% load i18n %}
+{% load build_absolute_uri from fnp_common %}
{% block title %}{% trans "WolneLektury.pl API" %}{% endblock %}
<h1>API</h1>
+<div class="normal-text white-box">
<p>
-{% blocktrans %}
-WolneLektury.pl API resides under <code>http://www.wolnelektury.pl/api/</code>.
+{% url "api" as u %}
+{% blocktrans with u=u|build_absolute_uri:request %}
+WolneLektury.pl API resides under <code>{{ u }}</code>.
You can use it to access information about books, their fragments and
their metadata.
{% endblocktrans %}
<p>
{% blocktrans %}
Default data serialization format is
-<a href="http://en.wikipedia.org/wiki/JSON">JSON</a>,
+<a href="http://en.wikipedia.org/wiki/JSON">JSON</a>,
but you can also use XML by appending <code>?format=xml</code>
query parameter to each URL.
{% endblocktrans %}
</p>
<ul>
- <li><a href='/api/books/'>/api/books/</a> – {% trans "List of all books" %}
+ <li><a href='{% url "api_book_list" "" %}'>
+ {% url "api_book_list" "" %}</a> – {% trans "All books" %}
+ <li><a href='{% url "api_audiobook_list" "" %}'>
+ {% url "api_audiobook_list" "" %}</a> – {% trans "Audiobooks" %}
+ <li><a href='{% url "api_daisy_list" "" %}'>
+ {% url "api_daisy_list" "" %}</a> – {% trans "DAISY" %}
- <li><a href='/api/authors/'>/api/authors/</a> – {% trans "List of all authors" %}</li>
- <li><a href='/api/epochs/'>/api/epochs/</a> – {% trans "List of all epochs" %}</li>
- <li><a href='/api/genres/'>/api/genres/</a> – {% trans "List of all genres" %}</li>
- <li><a href='/api/kinds/'>/api/kinds/</a> – {% trans "List of all kinds" %}</li>
+ <li><a href='{% url "api_tag_list" "authors" %}'>
+ {% url "api_tag_list" "authors" %}</a> – {% trans "List of all authors" %}</li>
+ <li><a href='{% url "api_tag_list" "epochs" %}'>
+ {% url "api_tag_list" "epochs" %}</a> – {% trans "List of all epochs" %}</li>
+ <li><a href='{% url "api_tag_list" "genres" %}'>
+ {% url "api_tag_list" "genres" %}</a> – {% trans "List of all genres" %}</li>
+ <li><a href='{% url "api_tag_list" "kinds" %}'>
+ {% url "api_tag_list" "kinds" %}</a> – {% trans "List of all kinds" %}</li>
- <li><a href='/api/themes/'>/api/themes/</a> – {% trans "List of all themes" %}</li>
+ <li><a href='{% url "api_tag_list" "themes" %}'>
+ {% url "api_tag_list" "themes" %}</a> – {% trans "List of all themes" %}</li>
+ <li><a href='{% url "api_collections" %}'>
+ {% url "api_collections" %}</a> – {% trans "Collections" %}
</ul>
<p>
-{% url api_book "studnia-i-wahadlo" as e1 %}
-{% url api_tag "authors" "edgar-allan-poe" as e2 %}
+{% url "api_book" "studnia-i-wahadlo" as e1 %}
+{% url "api_tag" "authors" "edgar-allan-poe" as e2 %}
{% blocktrans %}
Each element of those lists contains a link (in a "href") attibute
which points to individual resource's details, i.e.:
</p>
<p>
-{% url api_fragment "sen-nocy-letniej" "1290526312912-3814598192" as f %}
+{% url "api_fragment" "sen-nocy-letniej" "1290526312912-3814598192" as f %}
{% blocktrans with "/api/authors/william-shakespeare/themes/zabawa/fragments/" as e %}
The same way, using also books and themes, you can search for a list of fragments:
<a href="{{e}}">{{e}}</a>.
<a href="{{f}}">{{f}}</a>.
{% endblocktrans %}
</p>
-
+</div>
{% endblock %}