Alle Schlagwörter auflisten (Tagcloud)

GET /api/letter-tags
<?xml version="1.0" encoding="UTF-8"?>
<letter-tags type="array" page="1" per_page="100" total="2">
    <letter-tag>
        <id type="integer">1</id>
        <name>foo</name>
        <count type="integer">12</count>
    </letter-tag>
    <letter-tag>
        <id type="integer">1</id>
        <name>bar</name>
        <count type="integer">7</count>
    </letter-tag>
</letter-tags>

Alle Schlagworte eines Briefs auflisten

GET /api/letter-tags?letter_id={letter_id}

Schlagworte können immer nur für einen bestimmten Brief zurückgegeben werden.
Deshalb ist letter_id ein Pflichtparameter.

<?xml version="1.0" encoding="UTF-8"?>
<letter-tags type="array" page="1" per_page="100" total="2">
    <letter-tag>
        ...
    <letter-tag>
    <letter-tag>
        ...
    <letter-tag>
</letter-tags>

Einzelnes Schlagwort aufrufen

GET /api/letter-tags/{id}
<?xml version="1.0" encoding="UTF-8"?>
<letter-tag>
    <id type="integer">1</id>
    <letter_id type="integer">1</letter_id>
    <name>foo</name>
</letter-tag>

Schlagwort erstellen

POST /api/letter-tags
XML-ElementBeschreibungTypDefault-WertPflichtfeld
letter_idID des BriefsINTja
nameSchlagwortALNUMja
<letter-tag>
    <letter_id>1</letter_id>
    <name>foo</name>
</letter-tag>
<?xml version="1.0" encoding="UTF-8"?>
<letter-tag>
    <id type="integer">1</id>
    <letter_id type="integer">1</letter_id>
    <name>foo</name>
</letter-tag>

Schlagwort löschen

DELETE /api/letter-tags/{id}