Vai al contenuto principale

​
Guida introduttiva all’endpoint di ricerca dei segnalibri

Questa guida di avvio rapido ti aiuterà a inviare la tua prima richiesta all’endpoint di ricerca dei segnalibri utilizzando Postman. Visita il nostro repository GitHub X API v2 sample code se vuoi vedere esempi di codice in diverse lingue.

​
Prerequisiti

Per completare questa guida, ti servirà un set di chiavi e token per autenticare la richiesta. Puoi generarli seguendo questi passaggi:

​
Passaggi per creare una richiesta di ricerca 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 caricare la raccolta Postman di X API v2 nel tuo ambiente, fai clic sul pulsante seguente:
Una volta caricata la raccolta X API v2 in Postman, vai alla cartella “Bookmarks” e seleziona “Bookmarks lookup”. Secondo passaggio: autentica la tua richiesta Per effettuare correttamente una richiesta a questo endpoint, devi utilizzare 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. Dai 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 l’OAuth 2.0 client ID dal developer portal. Ti servirà solo se stai utilizzando un tipo di App che è un confidential client.
  4. Aggiorna gli scope con i seguenti valori: post.read users.read bookmark.read
  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 in Postman per conto del quale stai cercando di pubblicare. Terzo passaggio: specifica un utente Con questo endpoint, devi specificare l’id dell’utente di cui desideri ricevere i follower nella risposta. Ad esempio, l’id 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: invia la richiesta e verifica la risposta Dopo aver configurato tutto, fai clic sul pulsante “Send” e riceverai una risposta simile al seguente esempio: 
{
   "data": [
       {
           "id": "1501258597237342208",
           "text": "🗣 Hai sviluppato un progetto utilizzando la X API che vorresti condividere con la community? Ci farebbe piacere sentirti. Condividi il tuo progetto con noi!"
       },
       {
           "id": "1501258542258348032",
           "text": "🧰🛠 Questo è solo uno dei modi in cui l'innovazione degli sviluppatori contribuisce a rendere Twitter un posto migliore. Puoi trovare altri strumenti pronti all'uso sviluppati dalla nostra community di sviluppatori nella nostra Twitter Toolbox qui ⬇️ https://t.co/rK0X30JSYU"
       },
       {
           "id": "1501257716941000709",
           "text": "📣Oggi è un giorno importante! \nAbbiamo collaborato con @Jigsaw per il lancio di questo nuovo strumento. Questa collaborazione consente alle ONG e alle organizzazioni non profit di sviluppare strumenti che aiutano le persone a rimanere al sicuro su Twitter, rispondendo alle esigenze e alle preferenze delle comunità che servono. Scopri di più ⬇️ https://t.co/MmznmgxoWT"
       },
       {
           "id": "1501686770810900485",
           "text": "Unisciti a noi domani per continuare la conversazione sulla personalizzazione delle timeline e su come questo potrebbe funzionare per gli sviluppatori. E resta sintonizzato per altri Spaces in arrivo la prossima settimana. 👀 https://t.co/P4JTc14mdC"
       },
       {
           "id": "1501596763194593285",
           "text": "L'innovazione degli sviluppatori è sempre importante, anche in tempi di crisi. Se stai sviluppando strumenti per aiutare a connettere le persone, mantenerle al sicuro o condividere informazioni con il mondo, siamo qui per supportarti—rispondi a questo Tweet per dirci di più sulla tua app."
       }
   ]
}
⌘I