Vai al contenuto principale

​
Introduzione agli endpoint per la gestione dei follow

Questa guida di Avvio rapido ti aiuterà a inviare la tua prima richiesta agli endpoint per la gestione dei follow utilizzando Postman. Se desideri vedere esempi di codice in varie 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 tua richiesta. Puoi generare queste chiavi e token seguendo questi passaggi:

​
Passaggi per creare una richiesta di gestione dei follow

​
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 importare la raccolta X API v2 di Postman nel tuo ambiente, fai clic sul pulsante seguente:
Dopo aver caricato la raccolta X API v2 in Postman, vai alla cartella “Follows” e seleziona “Follow a user ID”.  

​
Secondo passaggio: 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 richiesta utilizzando OAuth 1.0a User Context oppure OAuth 2.0 Authorization Code con 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 Secret API 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 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 Authorization della richiesta se hai configurato tutto correttamente.  

​
Passaggio tre: specificare chi segue chi

Gli endpoint di gestione dei follow accettano due ID: uno per l’utente di origine (l’utente che desidera seguire o smettere di seguire un altro utente) e uno per l’utente di destinazione (l’utente che verrà seguito o non più seguito). L’ID dell’utente di origine deve corrispondere all’ID utente dell’utente autenticato. In questo caso, puoi specificare l’ID del tuo account. Puoi trovare il tuo ID in due modi:
  1. Utilizzando l’endpoint user lookup by username, puoi passare un nome utente e ricevere il campo id.
  2. Verificando il tuo Access Token, noterai che la parte numerica corrisponde al tuo ID utente.
L’ID di destinazione può essere qualsiasi ID utente valido. Ad esempio, l’ID utente di @XDevelopers è 2244994945. In Postman, vai alla scheda “Params” e inserisci il tuo ID nella colonna “Value” della variabile di percorso id. Vai alla scheda “Body” e inserisci 2244994945 (l’ID utente di @XDevelopers) come valore per il parametro target_user_id, assicurandoti di non includere spazi prima o dopo alcun ID.
KeyValue
id(il tuo ID utente)
target_user_id2244994945
Se fai clic sul pulsante “Send”, riceverai un oggetto di risposta contenente lo stato della relazione:
  • Se ricevi “following”: true, allora l’id sta seguendo correttamente il target_user_id.
  • Se ricevi “pending”: true, allora il target_user_id è protetto e deve accettare la tua richiesta di follow.

​

Fase quattro: invia la richiesta e verifica la risposta Una volta completata la configurazione, fai clic sul pulsante “Send” e riceverai la seguente risposta: 
    "data": {
        "following": true,
        "pending_follow": false
    }
}
Allo stesso modo, se volessi smettere di seguire un utente, useresti la richiesta “Unfollow a user ID” all’interno della stessa raccolta Postman. Tuttavia, i parametri source_user_id e target_user_id devono essere passati come variabili di percorso utilizzando l’endpoint di unfollow.
⌘I