Zum Hauptinhalt springen

Erste Schritte mit dem endpoint zum Ausblenden von Antworten

Dieser Schnellstart-Leitfaden hilft Ihnen, Ihre erste Anfrage an den endpoint zum Ausblenden von Antworten mit Postman zu stellen. Wenn Sie Codebeispiele in verschiedenen Sprachen sehen möchten, besuchen Sie bitte die API-Referenzseite zum Ausblenden von Antworten.

Voraussetzungen

Um diesen Leitfaden abzuschließen, benötigen Sie einen Satz 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 lassen Sie es genehmigen.
  • Erstellen Sie ein Project und eine zugehörige Developer-App im Entwicklerportal.
  • Navigieren Sie zur „Keys und Tokens“-Seite Ihrer App, um die erforderlichen Anmeldedaten zu generieren. Stellen Sie sicher, dass Sie alle Anmeldedaten an einem sicheren Ort speichern.

Schritte zum Erstellen einer PUT-/tweets/:id/hidden-Anforderung

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 senden 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 endpoint „hide replies“.

Schritt zwei: Authentifizieren Sie Ihre Anfrage

Um eine Anfrage an die X API korrekt zu stellen, müssen Sie bestätigen, 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. Sie müssen 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 hinterlegen. Wählen Sie dazu in der oberen rechten Ecke von 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 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: Eine Post-ID zum Ausblenden finden

Der endpoint zum Ausblenden von Antworten kann Antworten im Namen eines autorisierten Nutzers aus- oder wieder einblenden. Da wir in diesem Beispiel die Access Tokens verwenden, die mit Ihrem Nutzerprofil verknüpft sind, können Sie Antworten von Nutzern ausblenden, die an einer von Ihnen gestarteten Unterhaltung teilnehmen. Wenn Sie hingegen Access Tokens verwenden, die zu einem anderen Nutzer gehören, der Ihre App autorisiert hat, können Sie entsprechend Antworten in allen von diesem Konto gestarteten Unterhaltungen moderieren. Bitten Sie einen Freund, auf einen Post zu antworten (weisen Sie darauf hin, dass Sie das Ausblenden von Antworten testen), oder antworten Sie von einem Testkonto auf einen Ihrer Posts. Klicken Sie auf diese Antwort und kopieren Sie dann den numerischen Teil ihrer URL. Das ist die Post-ID, die wir ausblenden werden. In diesem Fall betrachten wir den folgenden Post, der die ID 1232720193182412800 hat: https://x.com/TwitterDev/status/1232720193182412800

Schritt vier: Den Post ausblenden

Öffnen Sie in Postman den Ordner Hide replies und wählen Sie Hide a reply. Fügen Sie im Tab Params die Post-ID neben das Feld id ein (Sie müssen :id in der URL nicht ersetzen). Klicken Sie auf „Send“ und Sie sehen eine erfolgreiche Antwort. {"hidden":true}

Schritt fünf: Post wieder einblenden

Ausgeblendete Posts werden in der X App in einen separaten Tab verschoben. Um einen Post in Postman wieder einzublenden, öffnen Sie den Ordner Hide replies und wählen Sie Unhide a reply. Fügen Sie im Tab Params dieselbe Post-ID aus dem vorherigen Schritt in das Feld id ein. Klicken Sie auf “Send” und Sie erhalten eine erfolgreiche Antwort. {"hidden":false} Das Feld hidden gibt den Ausblendstatus des Posts an. Ein Status von true bedeutet, dass der Post ausgeblendet ist. Entsprechend bedeutet false, dass der Post nicht ausgeblendet ist.
I