Tellvote API Developer Guide

Damit die Inhalte und Beiträge von Tellvote besser verbeitet und zugänglich gemacht werden können, stellt Tellvote ein API zur Verfügung.

Zum aktuellen Zeitpunkt beschränkt sich die API auf das externe Einbinden von Tellvote-Beiträgen mittels Code. Diese API-Features können zukünftig jederzeit ausgebaut werden.

Beim Einfügen von Tellvote-Inhalten in deine Website oder App, akzeptierst du die Tellvote API Nutzungsbedingungen.

Einbetten von Beiträgen von Tellvote

Voraussetzungen

Die Beiträge Tellpaper, Tellpost, News sowie Kommentare können in externe Websites eingebettet werden, sofern:

  • der Autor des Beitrages die Zustimmung für die Verwendung eigener Inhalte in seinem Profil nicht wiederrufen hat.
  • der Autor des Beitrages den betreffenden Beitrag nicht zeitlich befristet hat.

Wenn einer der obgenannen Punkte eingetreten ist, dann darf der betreffende Beitrag unter keinen Umständen in eine externe Website eingebunden werden.
Somit sind bei diesen Beiträgen kein Menülink mit dem spezifisch für diesen Inhalt angelegten Einbettungscode vorhanden.

Vorgehen

Ist ein Beitrag für das Einbetten freigegeben, dann kann über das Beitragsmenü (meist oben Rechts vom Beitrag) der Menülink "Einbetten" ausgewählt werden, wodurch der korrekte Einbettungscode in 2 Schritten für diesen Beitrag angezeigt wird.

Zum Beispiel:

Schritt 1: Platziere den Code dort, wo der Tellvote-Beitrag auf deiner Seite angezeigt werden soll.

<figure class="tellvote-content" data-widget-id="162"><blockquote><span lang="de" dir="ltr"><p>Herzlich Willkommen<br />
Die Alpha-Version von Tellvote ist endlich online. 🍾 </p>
<p>Um die Entwicklung und Vision von Tellvote voranzutreiben, bin ich für jede Unterstützung dankbar. ❤</p>
<p>Sicherlich braucht es etwas Zeit bis die Plattform fahrt aufnimmt. Umso wichtiger ist jeder einzelne Beitrag. In diesem Sinne, auf ein gutes Gelingen 🥂🍀</p>
<p>Update 📣:  Medienberichte über die Aktion Butterfly Effect</p>
<p><a href="https://www.20min.ch/story/100er-note-gratis-zum-mitnehmen-358932052292">https://www.20min.ch/story/100er-note-gratis-zum-…</a></p>
<p><a href="https://www.blick.ch/schweiz/graubuenden/anonyme-person-deponiert-100-franken-mit-grusskarte-geldsegen-an-churer-bushaltestelle-id16282848.html">https://www.blick.ch/schweiz/graubuenden/anonyme-…</a></p>
</span></blockquote><figcaption> — <cite><a href="/de/tellpost/162/endlich-online">Endlich Online!</a></cite>, @tellvote, 1. Januar 2021</figcaption></figure>

Schritt 2: Wenn du nur einen einzigen Tellvote Beitrag auf einer Seite hinzufügst, kannst du das Javascript direkt UNTERHALB des Beitrag-Codes integrieren.

Wenn du mehrere Tellvote-Beiträge auf der gleichen Seite einbetten möchtest, integriere das Javascript einmalig auf deiner Seite, vor dem SCHLIESSENDEN body-Tag.

<script async src="https://platform.tell.vote/widgets.js" charset="utf-8"></script>