Guida rapida

​

Guida introduttiva agli endpoint di lookup dei Post

Questa guida di Avvio rapido ti aiuterà a inviare la tua prima richiesta agli endpoint di lookup dei Post con un set di fields specificati utilizzando Postman.

Se desideri consultare esempi di codice in diverse lingue, visita il nostro repository GitHub X API v2 sample code.

​

Prerequisiti

Per completare questa guida, avrai bisogno di 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 una App sviluppatore 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 GET /tweets

​

Primo passaggio: iniziare con uno strumento o una libreria

Esistono diversi strumenti, esempi di codice e librerie che puoi utilizzare per inviare una richiesta a questo endpoint, ma qui useremo Postman per semplificare il processo.

Per caricare la collection X API v2 di Postman nel tuo ambiente, fai clic sul pulsante qui sotto:

Aggiungi X API v2 a Postman

Una volta caricata in Postman la collection X API v2, vai alla richiesta “Post Lookup > Multiple Posts”.

​

Passaggio due: Autentica la richiesta

Per inviare correttamente una richiesta alla X API, devi assicurarti di avere l’autorizzazione. Puoi autenticare la richiesta con:

• OAuth 2.0 App-Only
• OAuth 2.0 Authorization Code con PKCE
• Contesto utente OAuth 1.0a

Per semplicità, useremo OAuth 2.0 App-Only per questa richiesta; tuttavia, se vuoi ottenere metriche o Post privati, dovrai usare uno degli altri metodi di autenticazione.

Per utilizzare OAuth 2.0 App-Only, devi aggiungere le tue chiavi e token (in particolare l’App Access Token, noto anche come App-only Bearer Token) a Postman selezionando l’ambiente denominato “X API v2” (nell’angolo in alto a destra di Postman) e inserendo le tue chiavi e token nei campi “initial value” e “current value” (facendo clic sull’icona a forma di occhio accanto al menu a discesa dell’ambiente).

Se hai eseguito correttamente questa operazione, queste variabili verranno automaticamente richiamate nella scheda di autorizzazione della richiesta.

​

Passaggio tre: identifica e specifica quali Post desideri recuperare

Devi specificare un Post o un insieme di Post che desideri ricevere nella richiesta. Puoi trovare l’ID del Post navigando su X.com, facendo clic su un Post e poi guardando l’URL. Ad esempio, l’ID del Post del seguente URL è 1228393702244134912.

https://x.com/TwitterDev/status/1228393702244134912

In Postman, vai alla scheda “Params” e inserisci questo ID, oppure una stringa di ID del Post separati da virgole, nella colonna “Value” del parametro ids.

Key	Value
ids	1228393702244134912,1227640996038684673,1199786642791452673

---

​

Passaggio quattro: identifica e specifica quali fields desideri recuperare

Se fai clic sul pulsante “Send” dopo il passaggio tre, riceverai i campi dell’Oggetto Post predefiniti nella risposta: id, text e edit_history_tweet_ids.

Per questo esercizio richiederemo tre set aggiuntivi e distinti di fields da oggetti diversi:

• Il tweet.created_at field aggiuntivo negli oggetti Post principali.
• I campi predefiniti dell’oggetto utente degli autori associati per i Post restituiti: id, name e username
• Il user.created_at field aggiuntivo negli oggetti utente associati.

In Postman, vai alla scheda “Params” e aggiungi la seguente coppia key:value alla tabella “Query Params”:

Key	Value	Returned fields
tweet.fields	created_at	tweets.created_at
expansions	author_id	includes.users.id, includes.users.name, includes.users.username
user.fields	created_at	includes.users.created_at

Dovresti vedere questo URL accanto al pulsante “Send”:

https://api.x.com/2/tweets?ids=1228393702244134912,1227640996038684673,1199786642791452673&tweet.fields=created_at&expansions=author_id&user.fields=created_at

​

Passaggio cinque: invia la richiesta e verifica la risposta

Una volta configurato tutto, fai clic sul pulsante “Send” e riceverai la seguente risposta:

{
    "data": [
        {
            "edit_history_tweet_ids": [
                "1228393702244134912"
            ],
            "text": "Cosa ha scritto lo sviluppatore nel biglietto di San Valentino?\n  \nwhile(true) {\n    I = Love(You);  \n}",
            "id": "1228393702244134912",
            "created_at": "2020-02-14T19:00:55.000Z",
            "author_id": "2244994945"
        },
        {
            "edit_history_tweet_ids": [
                "1227640996038684673"
            ],
            "text": "Dottori: Cercare roba su Google non ti rende un dottore\n\nSviluppatori: https://t.co/mrju5ypPkb",
            "id": "1227640996038684673",
            "created_at": "2020-02-12T17:09:56.000Z",
            "author_id": "2244994945"
        },
        {
            "edit_history_tweet_ids": [
                "1199786642791452673"
            ],
            "text": "C#",
            "id": "1199786642791452673",
            "created_at": "2019-11-27T20:26:41.000Z",
            "author_id": "2244994945"
        }
    ],
    "includes": {
        "users": [
            {
                "name": "Sviluppatori",
                "created_at": "2013-12-14T04:35:55.000Z",
                "id": "2244994945",
                "username": "XDevelopers"
            }
        ]
    }
}