Vai al contenuto principale

​
Guida introduttiva agli endpoint per la gestione dei segnalibri

Questa guida di Avvio rapido ti aiuterà a effettuare la tua prima richiesta agli endpoint per la gestione dei segnalibri utilizzando Postman. Se desideri consultare esempi di codice in diverse lingue, visita il nostro repository GitHub X API v2 sample code.
PrerequisitiPer completare questa guida, avrai bisogno di un set di chiavi e token per autenticare la tua richiesta. Puoi generare queste chiavi e token seguendo questi passaggi:
  • Registrati per un account sviluppatore e attendi l’approvazione.
  • Crea un Project e un’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.

​
Passaggi per creare una richiesta di gestione dei Segnalibri

Primo passaggio: inizia con uno strumento o una libreria Esistono diversi strumenti, esempi di codice e librerie che puoi usare per effettuare una richiesta a questo endpoint, ma qui useremo Postman per semplificare il processo. Per importare la collection X API v2 di Postman nel tuo ambiente, fai clic sul seguente pulsante:
Una volta importata la collection X API v2 in Postman, vai alla cartella “Bookmarks” e seleziona “Create a Bookmark”. Secondo passaggio: autentica la tua richiesta Per effettuare correttamente una richiesta a questo endpoint, dovrai utilizzare l’OAuth 2.0 Authorization Code Flow with PKCE. Puoi generare un access token direttamente in Postman. Vai alla scheda “Authorization” e seleziona “OAuth 2.0”. In questa scheda, assicurati di seguire questi passaggi:
  1. Assegna un nome al token
  2. Seleziona come Grant Type: Authorization Code (with PKCE)
  3. Aggiorna i parametri: Callback URL - https://www.example.com Deve corrispondere alla callback URL impostata nella pagina delle impostazioni di autenticazione nel developer portal. Auth URL - https://x.com/i/oauth2/authorize Access Token URL - https://api.x.com/2/oauth2/token Client ID - Copia e incolla l’OAuth 2.0 client ID dal developer portal Client Secret - Copia e incolla il client secret OAuth 2.0 dal developer portal. Ti servirà solo se stai utilizzando un tipo di App che è un confidential client.
  4. Imposta gli scope con i seguenti valori: post.read users.read bookmark.write
  5. Compila il campo state con “State”
  6. Fai clic su “Generate Token”
  7. Premi l’icona di salvataggio per salvare le modifiche alla cartella.
Potresti ricevere un messaggio che indica che non hai effettuato l’accesso a X. In tal caso, accedi all’account X all’interno di Postman per conto del quale stai tentando di pubblicare. Terzo passaggio: specifica un utente Con questo endpoint, devi specificare l’ID dell’utente i cui follower desideri ricevere nella risposta. Ad esempio, l’ID utente per @XDevelopers è 2244994945. In Postman, vai alla scheda “Params” e inserisci l’ID tuo o di un utente autenticato come valore per il parametro id.
KeyValue
id2244994945
Quarto passaggio: specifica un Post che vuoi aggiungere ai Segnalibri Vai alla scheda “Body” e assicurati che l’ID del Post corrisponda a quello che desideri salvare nei Segnalibri. Il payload JSON dovrebbe essere simile al seguente. 
      {"tweet_id": "1460323737035677698"}
Passaggio cinque: invia la richiesta e rivedi la risposta Una volta configurato tutto, fai clic sul pulsante “Send” e riceverai una risposta simile al seguente esempio: 
{
   "data": {
       "bookmarked": true
   }
}
Per eliminare un Post, seleziona la richiesta “Remove a Bookmark”, presente anche nella cartella “Bookmarks” della raccolta X API v2 caricata in Postman. Per prima cosa, specifica l’id dell’utente per conto del quale stai effettuando la richiesta come valore per la colonna “id”. Questo endpoint richiede anche l’id del Post che desideri eliminare. Quindi, nella scheda “Params”, inserisci l’id del Post che desideri eliminare come valore per la colonna “tweet_id”. Quando la richiesta di DELETE va a buon fine, riceverai una risposta simile al seguente esempio: 
{
   "data": {
       "bookmarked": false
   }
}
⌘I