telegra.ph API

Die Gründer des kostenlosen Messengers Telegram führten Ende 2016 mit „telegra.ph“ ein Tool für das einfache und schnelle Veröffentlichen von Texten, Videos und Bildern ein. Ein großer Vorteil von telegra.ph ist, dass man sich nicht anmelden muss und jeder einfach eigene Blogs erstellen und mit anderen teilen kann.

Die Anmeldedaten werden als Cookie im aktuell genutzten Browser gespeichert.

API

Des Weiteren haben die Entwickler eine Schnittstelle (API) zur Nutzung von telegra.ph in anderen Webanwendungen bereitgestellt. Mit Hilfe dieser API kann man Accounts erstellen, seine erstellen Blogbeiträge abrufen, sich abmelden und Beiträge bearbeiten, ohne auf die eigentliche telegra.ph Seite gehen zu müssen.

Mit Hilfe der API habe ich zum Beispiel die Webseite https://telegraph-buddy.org/ erstellt.

Mit Hilfe der Webseite können telegra.ph Nutzer ganz einfach ihre Beiträge verwalten, anpassen und sogar löschen.

Im Folgenden werden ein paar wichtige API-Funktionen aufgelistet.

Account erstellen

Mit folgendem Befehl kannst du einen telegra.ph Account erstellen:

https://api.telegra.ph/createAccount?short_name=Richi&author_name=Richi

Nach der Anfrage bekommt man ein JSON Objekt mit folgenden Informationen zurück:

{
  "ok": true,
  "result": {
    "short_name": "Richi",
    "author_name": "Richi",
    "author_url": "",
    "access_token": "a848597ca50d0f92c70b21ce1f803b9822c71bbfde2241a4854ee2cc30e5",
    "auth_url": "https://edit.telegra.ph/auth/GxHNjnLyxs4lXZyBZbViVaJeekLXyWUerz1LVKhqcl"
  }
}

Das access_token ist so etwas wie ein eindeutiges Passwort des Accounts. Das Token benötigt man zum Beispiel um Account Informationen zu bekommen oder zu ändern, um eine neue telegra.ph Seite zu erstellen oder eine Seite zu editieren.

access_token (String)
Optional. Only returned by the createAccount and revokeAccessToken method. Access token of the Telegraph account.

Die auth_url bekommt man, wenn man einen Account erstellt oder Account Informationen mit Hilfe des access_token abruft. Mit Hilfe dieser auth_url kann man sich bei telegra.ph anmelden und auf seine erstellten Beiträge zugreifen.

auth_url (String)
Optional. URL to authorize a browser on telegra.ph and connect it to a Telegraph account. This URL is valid for only one use and for 5 minutes only.

Account Informationen abrufen und Anmeldung

Mit diesem Befehl kannst du Account Informationen abrufen und dich zum Beispiel an dem Account dann anmelden:

https://api.telegra.ph/getAccountInfo?access_token=a848597ca50d0f92c70b21ce1f803b9822c71bbfde2241a4854ee2cc30e5&fields=["short_name","auth_url"]

Available fields: short_name, author_name, author_url, auth_url, page_count.

Folgendes JSON bekommst du zurück. Mit der auth_url meldest du dich bei telegra.ph an. Diese ist nur einmal nutzbar und läuft nach 5 Minuten ab. Um eine neue auth_url zu bekommen, musst du nochmals die Account-Informationen mit dem passenden access_token abrufen.

{
  "ok": true,
  "result": {
    "short_name": "Richi",
    "auth_url": "https://edit.telegra.ph/auth/wV8fLnwNMyYRL3zkrUEGmqEHF6cmciYId4YYrsJb0G"
  }
}

Account abmelden

Da die Authentifizierung als Cookie im Browser gespeichert wird, kann man sich nur abmelden, wenn man für den Account ein neues access_token generiert.

https://api.telegra.ph/revokeAccessToken?access_token=a848597ca50d0f92c70b21ce1f803b9822c71bbfde2241a4854ee2cc30e5

Das alte Token wird mit einem neuen ersetzt:

{
  "ok": true,
  "result": {
    "access_token": "ecdcdf1be199d3e1839fa7a937c4af1e45838f39b90a36f417d915f49191",
    "auth_url": "https://edit.telegra.ph/auth/kxjXFA2TSo7mTfKnhwRtHy4aIshIwCeO8vLN5MEVaJ"
  }
}

Dieses neue access_token muss man unbedingt sicher aufbewahren, da man ohne nicht mehr auf seinen Account zugreifen kann und auch keine Posts mehr verändern kann.

API

Account erstellen

Account Informationen abrufen und Anmeldung

Account abmelden

Links:

unsere-schule.org

Code: