Vai al contenuto principale
Questa guida illustra i passaggi che puoi seguire per effettuare la tua prima richiesta. È una risorsa utile dopo esserti registrato a un account X. Se sei interessato a esempi di codice, guide più tecniche o a uno strumento grafico come Postman, prendi in considerazione le seguenti guide per effettuare la tua prima richiesta: Questa guida presuppone che tu abbia raccolto la tua API Key e secret, user Access Token e Secret, App Access Token e che li abbia archiviati in un luogo sicuro. Puoi imparare come fare seguendo i passaggi nella guida Ottenere l’accesso alla X API.

​
Passaggio 1. Individuare l’endpoint che si desidera utilizzare

La X API consente di eseguire diverse operazioni tramite codice, analoghe a quelle disponibili sul sito web o nell’app mobile di X. Mettiamo a disposizione un elenco completo degli endpoint disponibili tramite l’API nel nostro Indice di riferimento dell’API, ma per semplicità consigliamo di iniziare con uno dei seguenti:

​
Passaggio 2. Scegli uno strumento per effettuare la tua richiesta

Alcune richieste sono semplici, mentre altre possono essere più complesse da implementare. Per questo la straordinaria community di sviluppatori ha creato strumenti che semplificano parte della complessità. Di seguito sono riportati alcuni strumenti consigliati e le istruzioni su come usarli:

​
Postman

Postman è uno strumento visivo che puoi utilizzare per inviare richieste agli endpoint REST. Abbiamo creato materiali utili su Postman per aiutarti a iniziare ed esplorare i diversi endpoint disponibili tramite la X API. Ti consigliamo di leggere il nostro tutorial “Introduzione a Postman” per imparare ad aggiungere le tue chiavi e token e a inviare la tua prima richiesta. Abbiamo anche realizzato una guida di avvio rapido per ciascuno dei nostri endpoint della X API v2, la maggior parte dei quali utilizza Postman. Puoi trovare queste guide in ciascuna sezione dell’endpoint corrispondente; ecco alcuni link:
  • Avvio rapido: Pubblicare un Tweet
  • Avvio rapido: Cercare Post
  • Avvio rapido: Cercare un utente
Tieni presente che non puoi inviare richieste agli endpoint di streaming utilizzando Postman. Visita la guida di avvio rapido per filtered stream o 1% sampled stream per imparare a lavorare con questi endpoint. Se preferisci uno strumento grafico più semplice, puoi anche prendere in considerazione l’uso di Insomnia.

​
Esempio di codice

Se desideri usare del codice semplice per inviare la tua richiesta, abbiamo preparato esempi in diverse lingue per ciascuno dei nostri endpoint della X API v2. Puoi trovare gli esempi di codice nel nostro repository GitHub, X-API-v2-sample-code, che contiene anche un file README con le istruzioni per configurare correttamente le tue credenziali e utilizzare le richieste. Ad esempio, ecco un esempio cURL per l’endpoint di ricerca utente. Per usare questa richiesta, ti basta sostituire ACCESS_TOKEN e USERNAME con il tuo App Access Token e l’handle X. Quindi, copia e incolla questo codice nel tuo strumento da riga di comando e premi “Return” o “Enter”. 
curl "https://api.x.com/2/users/by/username/$USERNAME" -H "Authorization: Bearer $ACCESS_TOKEN"

​
Librerie

L’eccezionale community di sviluppatori di X ha creato librerie in diversi linguaggi di programmazione che puoi usare per inviare richieste alla X API. Abbiamo pubblicato una pagina “Strumenti e librerie” che elenca tutte le librerie della community note. Ogni libreria dovrebbe includere un file README con le istruzioni per configurare il repository sulla tua macchina ed effettuare la tua prima richiesta.
Nota bene: Se riscontri problemi, consulta la nostra documentazione per sviluppatori relativa all’endpoint a cui stai inviando la richiesta, la nostra sezione di supporto oppure chiedi aiuto alla community nei nostri forum. Ti aiuteremo a portare a termine la tua richiesta con successo!

​
Passaggio 3. Esamina la risposta

Dopo aver effettuato una richiesta con esito positivo, riceverai un payload con metadata relativi alla richiesta. Se hai utilizzato un endpoint che usa il metodo HTTP GET, riceverai metadata relativi alla risorsa (Post, utente, List, Space, ecc.) a cui hai indirizzato la richiesta, in formato JSON. Esamina i diversi fields restituiti e verifica se riesci a mappare le informazioni richieste al contenuto su X. Se hai utilizzato un endpoint che usa i metodi HTTP POST, PUT o DELETE, hai eseguito un’azione su X. Vai su X.com o sull’App mobile e verifica se riesci a risalire a tale azione.

​
Passaggio 4. Regola la tua richiesta utilizzando i parametri

Ogni endpoint dispone di un diverso insieme di parametri che puoi usare per modificare la tua richiesta. Ad esempio, puoi richiedere campi di metadata aggiuntivi quando utilizzi endpoint GET con i parametri fields ed expansions. Puoi anche sperimentare diversi strumenti di filtraggio con endpoint come search Posts, Post counts e filtered stream per restringere i data che ricevi ai soli Post di tuo interesse. Puoi trovare un elenco completo dei parametri di richiesta e dei fields nella API Reference dell’endpoint con cui stai lavorando, oltre a molte altre informazioni utili per l’integrazione nelle nostre guide all’integrazione e nelle pagine dei fondamenti. Puoi scoprire di più su tutti i materiali formativi che abbiamo messo a tua disposizione nella nostra guida Important resources.
⌘I