Vai al contenuto principale

​
Introduzione all’endpoint per nascondere le risposte

Questa guida di Avvio rapido ti aiuterà a inviare la prima richiesta all’endpoint per nascondere le risposte utilizzando Postman. Se desideri consultare alcuni snippet di codice in lingue diverse, visita la pagina di riferimento dell’API “hide replies”.

​
Prerequisiti

Per completare questa guida, ti servirà un set di chiavi e token per autenticare la richiesta. Puoi generare queste chiavi e token seguendo questi passaggi:
  • Registrati per un account sviluppatore e attendi l’approvazione.
  • Crea un Project e la developer App associata nel developer portal.
  • Vai alla pagina “Keys and tokens” della tua App per generare le credenziali necessarie. Assicurati di salvare tutte le credenziali in un luogo sicuro.

​
Procedure per creare una richiesta PUT /tweets/:id/hidden

​
Primo passaggio: inizia con uno strumento o una libreria

Esistono diversi strumenti, esempi di codice e librerie che puoi utilizzare per effettuare una richiesta a questo endpoint, ma qui useremo Postman per semplificare il processo. Per importare la collection di X API v2 in Postman nel tuo ambiente, fai clic sul seguente pulsante:
Una volta importata la collection X API v2 in Postman, naviga all’endpoint per nascondere le risposte.

​
Passaggio due: autentica la tua richiesta

Per inviare correttamente una richiesta alla X API, devi verificare di avere l’autorizzazione. Per farlo con questo endpoint, devi autenticare la tua richiesta utilizzando OAuth 1.0a User Context oppure OAuth 2.0 Authorization Code with PKCE. In questo esempio, utilizzeremo OAuth 1.0a User Context. Devi aggiungere le tue chiavi e token – in particolare la tua API Key, la tua API Secret Key, l’Access Token utente OAuth 1.0a e l’Access Token Secret utente OAuth 1.0a – in Postman. Puoi farlo selezionando l’ambiente denominato “X API v2” nell’angolo in alto a destra di Postman e aggiungendo le tue chiavi e i tuoi token ai campi “initial value” e “current value” (facendo clic sull’icona a forma di occhio accanto al menu a discesa dell’ambiente). Queste variabili verranno inserite automaticamente nella scheda di autorizzazione della richiesta se hai eseguito correttamente questa operazione.  

​
Terzo passaggio: trova un ID del Post da nascondere

L’endpoint hide replies può nascondere o ripristinare le risposte per conto di un utente autorizzato. Poiché in questo esempio utilizziamo gli Access Tokens associati al tuo profilo utente, potrai nascondere le risposte degli utenti che partecipano a una conversazione iniziata da te. Allo stesso modo, se stessi utilizzando Access Tokens appartenenti a un altro utente che ha autorizzato la tua App, potresti moderare le risposte a qualsiasi conversazione iniziata da quell’account. Chiedi a un amico di rispondere a un Post (informalo che stai testando la funzione per nascondere le risposte) oppure rispondi a uno qualsiasi dei tuoi Post da un account di test. Clicca su quella risposta, quindi copia la parte numerica del suo URL. Quello sarà l’ID del Post che nasconderemo. In questo caso, esamineremo il seguente Post, che ha l’ID 1232720193182412800: https://x.com/TwitterDev/status/1232720193182412800

​
Quarto passaggio: nascondere il Post

In Postman, apri la cartella Hide replies e seleziona Hide a reply. Nella scheda Params, incolla l’ID del Post accanto al campo id (non è necessario sostituire :id nell’URL). Fai clic su “Send” e vedrai una risposta di successo. {"hidden":true}

​
Passaggio cinque: mostrare il Post

I Post nascosti vengono spostati in una scheda separata nell’app X. Per rendere visibile un Post in Postman, apri la cartella Hide replies e seleziona Unhide a reply. Nella scheda Params, incolla lo stesso ID del Post utilizzato nel passaggio precedente nel campo id. Fai clic su “Send” e vedrai una risposta positiva. {"hidden":false} Il campo hidden indica lo stato di visibilità del Post. Se hidden è true, il Post è nascosto. Analogamente, se è false, il Post non è nascosto.
⌘I