API FAQ

Frequently Asked Questions

Was sind “Items”?

Ein Item ist jedes Einzelelement, welches über Supermagnetic.io innerhalb eines Feeds bereitgestellt wird. Dies kann ein Beitrag aus einem sozialen Netzwerk (Facebook, Twitter, YouTube, Instagram), ein manuell hochgeladenes und dem Feed hinzugefügtes Bild oder eine Wetterinformation sein. Somit gilt jedes eingebundene Objekt als Item, unabhängig von Dienst und Typ.

Beispiel:
100 Items pro Quelle bedeuten, dass insgesamt maximal 100 Inhalte für jede Quelle abgerufen und vorgehalten werden. Dabei spielt es keine Rolle, ob es sich um Social Media Dienste, Grafiken oder Wetterinformationen handelt. Neuere Items werden dem Feed hinzugefügt und ältere > 100 fallen aus dem Feed heraus.

Was sind “Quellen”?

Eine Quelle ist der komfortabelste Weg, um Inhalte in einen Feed zu importieren. Jeder Quelle kann nur ein Social Media Dienst zugewiesen werden. Dabei variieren die Bezugsmethoden bzw. Typen der verschieden Social Media Dienste.
Somit besteht die Auswahl zwischen Facebook, Instagram, Twitter oder YouTube und den jeweiligen Typen.

Neben den Social Media Diensten, lassen sich zudem Wetterinformationen als Quelle nutzen.

Beispiel:
Quelle 1 - Dienst: Instagram, Typ: Hashtag
Quelle 2 - Dienst: Instagram, Typ: User Feed
Quelle 3 - Dienst: Wetterinformationen

Was sind “Feeds”?

Ein Feed ist der Fluss an Informationen/Items, der sich aus den vom Redakteur/Nutzer hinzugefügten Quellen und Inhalten ergibt. Ein Feed lässt sich mit Hilfe von JSON in Ihre Anwendung oder Website integrieren und über das Supermagnetic.io Backend steuern. So lassen sich Items und Inhalte themenorientiert verwalten und ausgeben.

Was sind “Aufrufe”?

Als Aufrufe verstehen sich alle Seiten-Ladevorgänge, in deren Zuge die Supermagnetic-Schnittstelle abgefragt wird. Somit sind nur die Seiten relevant, in denen Supermagnetic.io auch integriert ist.

Was sind “JSON Objekte”?

Ein JSON Objekt ist ein kompaktes Datenformat in Javascript Notation, welches zum Austausch von Daten zwischen zwei Anwendungen dienen kann.

Was ist das Supermagnetic.io Backend?

Das Backend bietet den Redakteuren/Nutzern von Supermagnetic.io eine Verwaltungsoberfläche mit deren Hilfe sie Quellen und Inhalte zu Feeds zusammenfügen und für eine beliebige Ausgabe kuratieren können.

Benötige ich einen Facebook Account?

Wenn Sie Inhalte aus Ihren Facebook-Seiten innerhalb eines Feeds aggregieren möchten, dann ja. Sie müssen sich in diesem Fall innerhalb des Supermagnetic.io Backends mit Ihrem Facebook-Account authentifizieren und Facebook mit Supermagnetic.io verknüpfen.

Benötige ich einen Instagram Account?

Wenn Sie Inhalte aus Ihrem oder einem anderen Instagram Account innerhalb eines Feeds aggregieren möchten, dann ja. Sie müssen sich in diesem Fall innerhalb des Supermagnetic.io Backends mit Ihrem Instgram Account authentifizieren und Instagram mit Supermagnetic.io verknüpfen.

Benötige ich einen Twitter Account?

Wenn Sie Inhalte aus Ihrem oder einem anderen Twitter-Account innerhalb eines Feeds aggregieren möchten, dann ja. Sie müssen sich in diesem Fall innerhalb des Supermagnetic.io Backends mit Ihrem Twitter-Account authentifizieren und Twitter mit Supermagnetic.io verknüpfen.

Benötige ich einen YouTube Account?

Wenn Sie Inhalte aus Ihrem oder einem anderen YoutTube-Account innerhalb eines Feeds aggregieren möchten, dann ja. Sie müssen sich in diesem Fall innerhalb des Supermagnetic.io Backends mit Ihrem YouTube-Account authentifizieren und YouTube mit Supermagnetic.io verknüpfen.

Worin besteht der Unterschied zwischen einem Konto und Benutzerprofilen?

Ein Konto bildet den Rahmen für Benutzerprofile. So verfügen Firmen für gewöhnlich über ein Konto in dem sie mehrere Benutzerprofile mit unterschiedlichen Rechten anlegen können. So ist es möglich, dass mehrere Mitarbeiter in einem Konto arbeiten und dies unter Berücksichtigung der individuell vergebenen Rechte.

Worin unterscheiden sich die Verwaltungsrollen-Besitzer und Redakteure?

Der Verwaltungsrollen-Besitzer verfügt über uneingeschränkte Verwaltungsrechte innerhalb des Supermagnetic.io Backends. Redakteure hingegen sind in ihren Rechten eingeschränkt und können nur die eingebundenen Items verwalten, Items ein und ausblenden sowie Selected Posts und Grafiken einem bestehenden Feed hinzufügen.

Welche Leistungen sind innerhalb einer Quelle verfügbar?

Innerhalb einer Quelle sind momentan vier Social Media Dienste verfügbar, die in ihren Einbindungsmöglichkeiten variieren. Des Weiteren besteht die Möglichkeit eigene Grafiken hochzuladen, sowie Wetterinformationen einzubinden. Im Folgenden sind die Typen jedes Dienstes inklusive ihrer Verwendungsmöglichkeiten gelistet.


Facebook

  • Typ: Facebook Page Feed
  • Selected Posts (nur public)

Instagram

  • Typ: Instagram User Feed
  • Typ: Instagram Hashtag
  • Selected Posts (nur public)

Twitter

  • Typ: Instagram User Feed
  • Typ: Instagram Hashtag
  • Selected Tweets (nur public)

YouTube

  • Typ: User Videos
  • Typ: Channel Videos

Upload von Grafiken

  • Typ: JPEG

Wetterinformationen


Was sind “Selected Posts”?

Unter einem Selected Post wird ein einzelner, manuell ausgewählter Inhalt verstanden, welcher nicht durch einen Hashtag oder eine abonnierte Quelle aggregiert, sondern einzeln und manuell einem Feed hinzugefügt wird.

Dies kann beispielsweise ein einzelner Tweet oder ein Facebook-Posting sein. Diese Inhalte müssen öffentlich vom Autor verfügbar gemacht worden sein.

Wie werden “Selected Posts” und Grafiken hinzugefügt?

Zunächst muss in der Navigationsleiste ein Feed, sowie die Sektion “Inhalt” ausgewählt werden. Danach wird der Button “+ BEITRAG HINZUFÜGEN” betätigt. Nun lässt sich zwischen Social Media und einem Bild wählen.

Selected Post (Social Media):
Es gilt einen Dienst auszuwählen, sowie sicherzustellen, dass bereits eine Verbindung zu einem aktiven Konto besteht. Im nächsten Schritt wird der Link des jeweiligen Posts eingefügt und der “Beitrag Holen Button” betätigt. Es erscheint eine Vorschau, sowie die Möglichkeit den Beitrag zum Feed hinzuzufügen.

Upload von Grafiken:
Ziehen Sie via Drag and Drop eine JPEG Datei in die markierte Fläche oder öffnen Sie durch einen Klick in diesen Bereich den lokalen Ordner und wählen eine Grafik aus. Im Anschluss erscheint eine Vorschau und die Datei kann durch betätigen des entsprechenden Buttons hochgeladen werden.

Was beinhaltet der "Service"?

Für die Pakete Basic und Business bieten wir E-Mail-basierte Hilfestellung bei Bedienungsproblemen und Störungen an der Software. Im Rahmen des “Enterprise Pakets” besteht zudem ein telefonischer Support.

Die Service ist werktags von 10 bis 17 Uhr unter der +49 203 87838060 erreichbar.

Welche Möglichkeiten gibt es mit kritischen Inhalten umzugehen?

Für eine Wiedergabe von potenziell kritischen Inhalten, empfehlen wir die manuelle Freigabe. Dazu muss im Zuge der Quell-Einrichtung die Checkbox “Beiträge verstecken” aktiviert werden. Somit werden alle Items über diese Quelle zunächst als “Versteckte Beiträge” angelegt und nicht ausgegeben.

Ein- und Ausblenden “Versteckter Beiträge”

Die Übersicht der sich im Feed befindenden Inhalte ist in zwei Bereiche unterteilt. Zum Einen in “Sichtbare Beiträge”, die auf der Website ausgegeben werden und zum Anderen in “Versteckte Beiträge”. Für eine Statusänderung lassen sich Items manuell mit Hilfe des Sichtbarkeit-Symbols ein- und ausblenden.

Wo befindet sich das Symbol zu Statusänderung?

In der Übersicht der sich im Feed befindenden Inhalte, verfügt jedes Item über einen Button zur Statusänderung. Dieser Button wird sichtbar wenn der Mouse Cursor über das Item geführt wird.

Filtern nach Social Media Dienst

Für eine noch präzisere Übersicht lässt sich unter Verwendung der Filter Funktion zwischen den jeweiligen Social Media Diensten und Quellen selektieren. Die Filter werden mit Verwendung eines neuen Dienstes bzw. Typs erstellt und befinden sich im oberen Bereich der Item-Übersicht eines Feeds.

Wie kann ich ein Upgrade durchführen?

Bitte wenden Sie sich an upgrade@supermagnetic.io und wir helfen Ihnen gerne und unkompliziert weiter.

Falls bereits bekannt und möglich, stellen Sie uns dabei bitte die folgenden Informationen zur Verfügung:

Hiermit beauftrage ich ein sofortiges Upgrade meines Grundpaketes um die folgenden Positionen, zum nächsten Werktag.

Aufrufe: Monatlich um (eintragen falls gewünscht) Aufrufe (5.000/100.000 Schritten)
Feeds: Monatlich um (eintragen falls gewünscht) Feeds
Nutzer: Monatlich um (eintragen falls gewünscht) Nutzer

Upgrade Grundpaket auf: (eintragen falls gewünscht)

Name des Auftraggebers:

Unternehmen:

Ich würde gerne Supermagnetic.io für meine Kunden nutzen und Wiederverkäufer werden - bestehen Kooperationsmöglichkeiten?

Wenden sie sich bitte per E-Mail an sales@supermagnetic.io.

Ist die API dokumentiert?

Die API Dokumentation ist unter www.supermagnetic.io/apidoc/ hinterlegt.

Beispielanwendung

Wir haben auf GitHub eine beispielhafte jQuery-Einbindung der API hinterlegt: github.com/Rheinschafe/jquery.supermagnetic

Beispielaufruf

jQuery-Beispielaufruf um Social Media Items eines Feeds zu aggregieren:

$.ajax({
														type: 'GET',
														dataType: 'json',
														url: 'https://app.supermagnetic.io/api/v1/items?feed_id=124&access_token=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpZCI6NzYsImlhdCI6MTQ4Mzc5ODU2Mn0.vEkb4yPCZAg4GIBb5CDgpRyWnOUi-ahA6-zE0JpxtXw&limit=20'
													});

Was ist eine "API"?

Die Abkürzung API steht für Application Programming Interface bzw. (Anwendungs-)Programmierschnittstelle.
Die Supermagnetic.io API dient dem Datentransfer zwischen der Anwendung Supermagnetic.io und einem von Ihnen oder Dritten angebundenen Service/Endpunkt. Sie ermöglicht somit einen plattformübergreifenden Informationsaustausch.

Was kann ich mit der jQuery library machen?

Die JavaScript Bibliothek verschlankt den Integransionsprozess. Der dokumentierte Code ist Ideal um Ihn zu Testzwecken einzubinden oder um Ihn als Ausgangspunkt für weitere Individualisierungen zu verwenden.

Was kann ich mit einer API machen?

Die Supermagnetic.io API ermöglicht Ihnen den Zugriff auf die Daten der von Ihnen innerhalb des Supermagnetic.io Backends zusammengestellten Feeds zuzugreifen und diese in Form eines JSON-Objektes auszulesen.

Was ist ein Access Token?

Der Access-Token ermöglichen den exklusiven Zugriff auf die im Backend konfigurierten Inhalte. Unter Konto -> Access Token können Sie Ihren persönlichen Access Token erstellen.

Wo finde ich die Feed-ID?

Die Feed ID ist eine drei- bis fünfstellige Zahl, welche in der Feed-URL wie folgt enthalten ist:

URL: „https://app.supermagnetic.io/app/{Ihr Account}/feeds/{Feed ID}/“ -> Feed ID: XXX

Um diese URL aufzurufen, wählen Sie im Backend von Supermagnetic.io einen Feed aus. Die ID Ihres Feeds können Sie nun am Ende der URL auslesen.

Sie möchten Supermagnetic.io für Kunden einsetzen?

Profitieren Sie von unseren Konditionen für Reseller

Können wir Ihnen helfen?

Es gibt viele Möglichkeiten Supermagnetic.io in Ihre Website, Ihr Intranet, Ihre App oder überall dort, wo Sie Ihre Social Media Inhalte ausgeben möchten, einzubinden. Wir helfen Ihnen gerne dabei, den besten Weg für Sie zu finden.

Kontakt aufnehmen

Integration in Ihre Anwendung

Integrieren Sie die Supermagnetic.io API mit JSON in Ihre Anwendung - hierzu stellen wir Ihnen unsere Beispieleinbindung und die API-Doku zur Verfügung. Bei weiteren Fragen hilft ein Blick in die API FAQ.

Jetzt testen
Top