Vai al contenuto principale

​
Introduzione agli endpoint di gestione dei Post**

Questa guida di Avvio rapido ti aiuterà a inviare la tua prima richiesta agli endpoint di gestione dei Post utilizzando Postman. Visita il nostro repository X API v2 sample code su GitHub per vedere esempi di codice in diverse lingue.
PrerequisitiPer completare questa guida, ti servirà un set di chiavi e token per autenticare la richiesta. Puoi generare queste chiavi e token seguendo questi passaggi:

​
Passaggi per creare richieste di gestione dei Post

Primo passaggio: iniziare con uno strumento o una libreria Esistono diversi strumenti, esempi di codice e librerie che puoi utilizzare per effettuare una richiesta a questo endpoint, ma qui useremo lo strumento Postman per semplificare il processo. Per caricare la raccolta Postman di X API v2 nel tuo ambiente, fai clic sul seguente pulsante:
Una volta caricata la raccolta X API v2 in Postman, vai alla cartella “Manage Posts” e seleziona “Create a Post”.   Secondo passaggio: autentica la tua richiesta Per effettuare correttamente una richiesta alla X API, devi verificare di avere l’autorizzazione per farlo. Per farlo con gli endpoint di gestione dei Post, devi autenticare la tua richiesta usando OAuth 1.0a User Context oppure OAuth 2.0 Authorization Code with 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 API Secret Key, l’Access Token utente OAuth 1.0a e l’Access Token Secret utente OAuth 1.0a) a 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). Se l’hai fatto correttamente, queste variabili verranno automaticamente inserite nella scheda di autorizzazione della richiesta. Terzo passaggio: specifica il testo del Post Quando crei un nuovo Post con questo endpoint, il testo o i media del Post sono i parametri obbligatori del body. In Postman, vai alla scheda “Body” e inserisci il testo del Post come valore per il parametro text. Inoltre, se desideri aggiungere parametri per elementi come sondaggi, rispondere a un ID del Post o aggiungere impostazioni di risposta, puoi farlo qui. Puoi saperne di più su ciò che è disponibile nella nostra guida di riferimento all’API.
KeyValueParameter type
textHello world!body
Quarto passaggio: identifica e specifica quali fields desideri recuperare Una volta configurato tutto, premi il pulsante “Send” e riceverai una risposta simile al seguente esempio di risposta: 
{
  "data": {
    "id": "1445880548472328192",
    "text": "Ciao mondo!"
  }
}
Se l’oggetto di risposta contiene un id e il text del tuo Post, hai creato correttamente un Post.   Passaggio cinque: elimina il tuo Post Per eliminare un Post, seleziona la richiesta “Delete a Post” presente anche nella cartella “Manage Posts” della raccolta X API v2 caricata in Postman. Questo endpoint richiede l’ID del Post che desideri eliminare. Quindi, nella scheda “Params”, inserisci l’ID del Post che desideri eliminare come valore per la colonna id.  Se la richiesta di eliminazione va a buon fine, riceverai una risposta simile al seguente esempio: 
{
   "data": {
       "deleted" : true
   }
}
Prossimi passaggi Riferimento API Richiedi supporto Esempio di codice
⌘I