Wie funktioniert die Schnittstelle (API)?

1. Worum es geht

Die Schnittstelle ist für Entwickler und Agenturen gedacht, die Inhalte automatisch übertragen. Sie arbeitet mit Ihrem persönlichen Konto: Was Sie über die Schnittstelle anlegen, erscheint unter Ihrem Namen oder unter dem Unternehmen, das Sie verwalten – mit denselben Rechten wie auf der Website. Die Nutzung kostet nichts.

2. Einen Zugangsschlüssel anlegen

Im persönlichen Profilmenü finden Sie „API-Tokens“. Unter „Neuen Token erstellen“ geben Sie einen Namen ein, an dem Sie ihn später wiedererkennen – etwa den Namen Ihres CMS –, und klicken auf „Erstellen“.

Der Token wird nur ein einziges Mal angezeigt. Kopieren Sie ihn sofort und bewahren Sie ihn sicher auf; wer ihn hat, handelt in Ihrem Namen. Ihr System schickt ihn bei jeder Anfrage als Bearer-Token mit.

• Höchstens drei Tokens gleichzeitig. Für einen vierten löschen Sie einen alten.
• Kein Ablaufdatum: Ein Token gilt, bis Sie ihn löschen.
• Überblick: Die Liste zeigt bei jedem Token, wann er zuletzt verwendet wurde. Einen, den Sie nicht mehr brauchen oder der in falsche Hände geraten sein könnte, löschen Sie mit dem Papierkorb.

3. Was die Schnittstelle kann

• Artikel: anlegen, abrufen, ändern und löschen – Ihre eigenen und, als Administrator, die Ihres Unternehmens.
• Events: anlegen, abrufen, ändern und löschen.
• Stellenanzeigen: anlegen, abrufen, ändern und löschen.
• Kategorien: die Liste aller Kategorien mit ihren Nummern, die Sie beim Anlegen von Artikeln brauchen.
• Ihre Unternehmen: die Unternehmen, mit denen Ihr Konto verknüpft ist, samt Ihrer Rolle dort.
• Geplante Postings: die Social-Media-Postings, die noch erscheinen werden.

4. Regeln für Artikel

Ein Artikel über die Schnittstelle braucht:

• Titel: mindestens vier Wörter, höchstens 250 Zeichen, auf der Plattform einmalig.
• Text: 800 bis 12.000 Zeichen in einfachem HTML – Zwischenüberschriften, Absätze, Listen, Zitate und Fettdruck. Alles andere wird entfernt.
• Kategorien: eine bis drei.
• Bilder: eins bis fünf, jeweils als öffentlich erreichbare Adresse und mit einer Bildbeschreibung aus mindestens drei Wörtern.
• Erscheinungsdatum: optional. Erst mit einem Datum wird der Artikel veröffentlicht.

Soll ein Artikel im Namen Ihres Unternehmens erscheinen, geben Sie das Unternehmen mit an. Dafür müssen Sie dort Administrator sein. Ohne Premium-Abo gilt auch über die Schnittstelle: drei Artikel pro Unternehmen. Den Absender legen Sie beim Anlegen fest; danach bleibt er.

Mit der Option autooptimize schlägt die KI beim Anlegen Titel und Vorspann für Suchmaschinen vor und übernimmt sie direkt. Meta-Angaben und den Newsletter-Text erzeugen wir ohnehin im Hintergrund.

5. Events und Stellenanzeigen

Beides legen Sie für ein Unternehmen an, bei dem Sie Administrator sind.

• Events brauchen Titel, eine Beschreibung ab 100 Zeichen, Start in der Zukunft, Ende und einen Veranstaltungsort. Den Ort legen Sie einmal auf der Website an und verwenden ihn danach über seine Nummer. Bis zu zehn Bilder sind möglich.
• Stellenanzeigen brauchen Titel, Beschreibung, Laufzeit, Mindestgehalt mit Zahlungsintervall und mindestens drei Fähigkeiten.

6. Grenzen

Veranstaltungsorte und Unternehmensprofile legen Sie auf der Website an und pflegen sie dort; die Schnittstelle liest sie nur. Postings für Social Media erzeugt die Plattform selbst.

Kostenlos

Die Schnittstelle kostet nichts. Es gelten dieselben Grenzen wie auf der Website, etwa drei kostenlose Unternehmensartikel ohne Premium-Abo.