In diesem Artikel schlagen wir einen Code in C # vor, in dem wir die Tumblr-API verwenden, um einen Beitrag oder Artikel zu erstellen . Tumblr bietet mehrere Bibliotheken zur Verwendung seiner API mit verschiedenen Programmiersprachen (Ruby, PHP, Python, Java, Javascript und Objective-C), jedoch keine für C #. Ich habe nur PHP ausprobiert, um einen Artikel im Testblog zu erstellen, und ich kann sagen, dass er korrekt funktioniert, obwohl die Installation der Bibliothek etwas umständlich war, da ich mich noch nie mit dem automatischen Abhängigkeitsmanager namens Composer befasst hatte . In diesem Artikel werden wir jedoch die Tumblr-API mit C # unter der .NET-Plattform behandeln, da nirgendwo das Thema behandelt wird und die verfügbaren Bibliotheken veraltet sind, da sie für die alte Version der Tumblr-API entwickelt wurden, die derzeit bereits vorhanden ist Es ist nicht funktionsfähig.
Der vorgeschlagene Code zeigt den Mechanismus zum Erstellen eines neuen Posts oder Artikels mithilfe der Tumblr-API. Bei der Überprüfung der API konnte ich überprüfen, ob das verwendete System praktisch mit dem der Twitter-API identisch ist. In einigen Fällen verweist die Tumblr-API-Dokumentation auf die Twitter-API-Dokumentation. Aus diesem Grund ist es ratsam, den Artikel über das Veröffentlichen auf Twitter mit API- und OAuth C # -Authentifizierung zur Hand zu haben, da wir uns hiermit befassen werden, um einige Dinge zu erläutern.
Die Tumblr-API basiert wie die von Twitter auf dem Authentifizierungssystem Oauth 1.0a, sodass ich den größten Teil des Codes im Beispiel wiederverwenden kann, um einen Twitter-Beitrag mit der API zu erstellen.
Der erste Schritt ist das Registrieren oder Erstellen einer Anwendung auf Tumblr.
Natürlich müssen wir bei Tumblr registriert sein. Sobald wir uns registriert haben und unser Konto aktiviert ist, müssen wir zur Verwaltungs- und Erstellungsseite von Tumblr-Anwendungen gehen und auf “Anwendung registrieren” klicken. Auf dem neuen Bildschirm füllen wir die Felder aus: Anwendungsname, Anwendungswebsite, Anwendungsbeschreibung, Standard-Rückruf-URL und klicken auf “Registrieren” .
Nach der Registrierung zeigt uns die Anwendung den consumer key und consumer secret , die zur Authentifizierung in der API erforderlich sind.
Eine weitere notwendige Tatsache ist unser base-hostname , der nichts anderes ist als der Name unseres Tumblr-Blogs. Das zeotest.tumblr.com , das ich zur Entwicklung dieser Anwendung erstelle, lautet beispielsweise http://zeotest.tumblr.com/ und der base-hostname zeotest.tumblr.com . In Tumblr können Sie Ihre eigenen Domains verwenden. In diesem Fall ist der base-hostname der Name der Domain, der durch einen CNAME-Eintrag im DNS bestimmt wird.
Wir haben fast alle notwendigen Daten, wir müssen noch das Access Token und das Access Token Secret . Um diese beiden Daten zu erhalten, gibt es zwei Möglichkeiten:
- Manuelles Formular: Klicken Sie auf der Anwendungsverwaltungsseite von Tumblr auf “API erkunden”, wie in der folgenden rot hervorgehobenen Abbildung dargestellt:
Daraufhin wird ein Bildschirm angezeigt, in dem Sie gefragt werden, ob Sie der Anwendung Berechtigungen erteilen möchten:
Wir klicken auf “Zulassen” und rufen die Konsolenseite auf, wo wir auf die Schaltfläche “Schlüssel anzeigen” oben rechts klicken und ein Popup – Fenster mit allen erforderlichen Daten sehen, die zum Kopieren und Einfügen bereit sind (der Verbraucher und die Token) - Automatische Methode: Eine andere Methode besteht darin, den Wert dieser Token über die API-eigenen Anforderungen abzurufen.
Da es sich um ein Testprogramm zum Verständnis der API handelt, werde ich die manuelle Methode zum Abrufen der Token verwenden. In einem zukünftigen Artikel werde ich jedoch erläutern, wie Sie den Wert dieser Token über die API ermitteln können, da dies die am besten geeignete Methode ist .
Zu diesem Zeitpunkt sollten wir die folgenden Daten haben:
- Verbraucherschlüssel
- Verbrauchergeheimnis
- Token
- Token Secret
- Basis-Hostname
Verwenden Sie die Tumblr-API mit C #
Jetzt ist es an der Zeit, die Tumblr-API zu nutzen, deren Dokumentation auf Englisch unter dem Link http://www.tumblr.com/docs/en/api/v2 zu finden ist
Zunächst bilden wir den OAuth-Authentifizierungsheader , über den ich nicht viel Spaß haben werde, da er genau derselbe ist, der in der Twitter-API verwendet wird, und der in dem Artikel zum Veröffentlichen auf Twitter mit der API ausführlich erläutert wird.
Der Hauptunterschied besteht darin, dass Sie beim Erstellen der oauth_signature die folgenden neuen Parameter berücksichtigen müssen:
-
body: ist der Inhalt des Artikels. -
title: e der titel des artikels. -
type: ist die Art des Artikels. Tumblr unterstützt verschiedene Arten von Artikeln (Text, Foto, Zitat, Link, Chat, Audio, Video), in unserem Fall verwenden wir jedoch Text. -
URL: Die URL zum Erstellen eines Artikels lautethttp://api.tumblr.com/v2/blog/base-hostname/post
Dann sollte in der HTTP-Anforderung mit POST-Verb auch berücksichtigt werden, dass die neue URL http://api.tumblr.com/v2/blog/zeotest.tumblr.com/post lautet und die über POST gesendeten Daten sind body , title und type .
Wenn alles geklappt hat, erhalten wir eine API-Antwort im JSON-Format vom Typ:
{"meta":{"status":201,"msg":"Created"},"response":{"id":75903174759}}
Die Anwendung ist wie immer sehr einfach und hängt ein in C # für Visual Studio 2010 programmiertes Projekt zum Download bereit.