Zum Hauptinhalt springen

​
Erste Schritte mit den Endpoints zum Verwalten von Follows

Diese Schnellstartanleitung hilft Ihnen, Ihre erste Anfrage an die Endpoints zum Verwalten von Follows mit Postman zu stellen. Wenn Sie Beispielcode in verschiedenen Sprachen sehen möchten, besuchen Sie bitte unser GitHub-Repository mit X API v2 Sample Code. 

​
Voraussetzungen

Um diese Anleitung abzuschließen, benötigen Sie einen Satz von Keys und Tokens, um Ihre Anfrage zu authentifizieren. Sie können diese Keys und Tokens generieren, indem Sie die folgenden Schritte ausführen:
  • Registrieren Sie sich für ein Developer-Konto und erhalten Sie eine Genehmigung.
  • Erstellen Sie ein Project und eine zugehörige Developer-App im Entwicklerportal.
  • Navigieren Sie zur Seite „Keys und Tokens“ Ihrer App, um die erforderlichen Anmeldedaten zu generieren. Stellen Sie sicher, dass Sie alle Anmeldedaten an einem sicheren Ort speichern.

​
Schritte zum Erstellen einer Manage-Follows-Anfrage

​
Schritt eins: Beginnen Sie mit einem Tool oder einer Bibliothek

Es gibt verschiedene Tools, Codebeispiele und Bibliotheken, mit denen Sie eine Anfrage an dieses endpoint stellen können. Wir verwenden hier Postman, um den Prozess zu vereinfachen. Um die X API v2-Postman-Collection in Ihre Umgebung zu laden, klicken Sie bitte auf die folgende Schaltfläche:
Sobald Sie die X API v2-Collection in Postman geladen haben, navigieren Sie zum Ordner „Follows“ und wählen Sie „Follow a user ID“ aus.  

​
Schritt zwei: Authentifizieren Sie Ihre Anfrage

Um eine Anfrage an die X API korrekt zu stellen, müssen Sie nachweisen, dass Sie berechtigt sind. Bei diesem endpoint müssen Sie Ihre Anfrage entweder mit OAuth 1.0a User Context oder OAuth 2.0 Authorization Code mit PKCE authentifizieren. In diesem Beispiel verwenden wir OAuth 1.0a User Context. Fügen Sie Ihre Keys und Tokens – insbesondere Ihren API Key, API Secret Key, OAuth 1.0a user Access Token und OAuth 1.0a user Access Token Secret – in Postman hinzu. Wählen Sie dazu oben rechts in Postman die Umgebung „X API v2“ aus und tragen Sie Ihre Keys und Tokens in die Felder „initial value“ und „current value“ ein (klicken Sie dazu auf das Augensymbol neben der Umgebungs-Dropdownliste). Diese Variablen werden automatisch in den Authorization-Tab der Anfrage übernommen, wenn Sie dies korrekt eingerichtet haben.  

​
Schritt drei: Festlegen, wer wem folgen soll

Die Manage-Follows-endpoints erwarten zwei IDs: eine für den Quellnutzer (der Nutzer, der einem anderen Nutzer folgen oder nicht mehr folgen möchte) und eine für den Zielnutzer (der Nutzer, dem gefolgt oder entfolgt wird). Die ID des Quellnutzers muss der Nutzer-ID des authentifizierenden Nutzers entsprechen. In diesem Fall können Sie die ID Ihres eigenen Nutzers angeben. Ihre ID können Sie auf zwei Arten ermitteln:
  1. Mit dem endpoint user lookup by username können Sie einen Benutzernamen übergeben und erhalten das Feld id.
  2. Im Access Token ist der numerische Teil Ihre Nutzer-ID.
Die Ziel-ID kann jede gültige Nutzer-ID sein. Beispielsweise lautet die Nutzer-ID für @XDevelopers 2244994945. Navigieren Sie in Postman zur Registerkarte „Params“ und geben Sie Ihre ID in die Spalte „Value“ der id-Pfadvariable ein. Navigieren Sie zur Registerkarte „Body“ und geben Sie 2244994945 (die Nutzer-ID für @XDevelopers) als Wert für den Parameter target_user_id ein. Achten Sie darauf, vor oder nach einer ID keine Leerzeichen einzufügen.
KeyValue
id(Ihre Nutzer-ID)
target_user_id2244994945
Wenn Sie auf die Schaltfläche „Send“ klicken, erhalten Sie ein Response-Objekt mit dem Status der Beziehung:
  • Wenn Sie ein “following”: true erhalten, folgt die id erfolgreich der target_user_id.
  • Wenn Sie ein “pending”: true erhalten, ist die target_user_id geschützt und muss Ihre Folgeanfrage akzeptieren.

​

Schritt vier: Senden Sie Ihre Anfrage und überprüfen Sie die Antwort Sobald alles eingerichtet ist, klicken Sie auf die Schaltfläche „Send“ und Sie erhalten die folgende Antwort: 
    "data": {
        "following": true,
        "pending_follow": false
    }
}
Wenn Sie hingegen einem Nutzer nicht mehr folgen möchten, verwenden Sie die Anfrage „Unfollow a user ID“ in derselben Postman‑Sammlung. Dabei sollten sowohl die Parameter source_user_id als auch target_user_id als Pfadvariablen über das Unfollow-endpoint übergeben werden.
⌘I