Skip to main content

​
Ricerca dei blocchi: Standard v1.1 rispetto a X API v2

Se hai lavorato con gli endpoint Standard v1.1 GET blocks/ids e GET blocks/list, l’obiettivo di questa guida è aiutarti a comprendere somiglianze e differenze tra gli endpoint di ricerca dei blocchi di Standard v1.1 e X API v2.
  • Somiglianze
    • Autenticazione
  • Differenze
    • URL degli endpoint
    • Limiti di utenti per richiesta
    • Requisiti di App e Project
    • Formati dei dati di risposta
    • Parametri della richiesta

​
Somiglianze

Autenticazione Sia gli endpoint di ricerca dei blocchi Standard v1.1 sia quelli di X API v2 utilizzano il Contesto utente OAuth 1.0a. Pertanto, se in precedenza utilizzavi uno degli endpoint di ricerca dei blocchi Standard v1.1, puoi continuare a usare lo stesso metodo di autenticazione se esegui la migrazione alla versione X API v2. 

​
Differenze

URL degli endpoint Limiti di utenti per richiesta Gli endpoint Standard v1.1 consentono di restituire fino a 5000 utenti per richiesta. I nuovi endpoint v2 consentono di restituire fino a 1000 utenti per richiesta. Per ottenere tutti i 1000 utenti, è necessario passare max_results=1000 come parametro di query; è quindi possibile passare il next_token restituito nel payload di risposta al parametro di query pagination_token nella richiesta successiva.   Requisiti di App e Project Gli endpoint X API v2 richiedono di utilizzare le credenziali di una developer App associata a un Project quando si autenticano le richieste. Tutti gli endpoint X API v1.1 possono utilizzare credenziali di App autonome o di App associate a un Project. Formato dei dati di risposta Una delle differenze più importanti tra Standard v1.1 e le versioni degli endpoint X API v2 riguarda il modo in cui si selezionano i campi da restituire nel payload. Per gli endpoint Standard, molti campi della risposta vengono restituiti per impostazione predefinita; è poi possibile utilizzare parametri per indicare quali campi o insiemi di campi includere nel payload. La versione X API v2 fornisce per impostazione predefinita solo i campi user id, name e username. Per richiedere campi o oggetti aggiuntivi, è necessario utilizzare i parametri fields e expansions. Qualsiasi campo utente richiesto da questo endpoint verrà restituito nell’oggetto utente primario. Qualsiasi Post object espanso e i relativi campi verranno restituiti in un oggetto includes all’interno della risposta. È quindi possibile associare gli oggetti espansi all’oggetto utente abbinando gli ID presenti sia nell’oggetto utente sia nel Post object espanso.  Ti invitiamo a leggere di più su questi nuovi parametri nelle rispettive guide o consultando la nostra guida su come usare fields ed expansions.  Abbiamo anche preparato una guida alla migrazione del formato dei dati che può aiutarti a mappare i campi Standard v1.1 ai nuovi campi v2. Questa guida ti fornirà anche gli specifici parametri di expansion e field che dovrai passare con la tua richiesta v2 per restituire campi specifici.    Oltre alle modifiche relative al modo in cui si richiedono determinati campi, X API v2 introduce anche nuovi design JSON per gli oggetti restituiti dalle API, inclusi gli oggetti Post e user.
  • Al livello root del JSON, gli endpoint Standard restituiscono Post object in un array statuses, mentre X API v2 restituisce un array data. 
  • Invece di fare riferimento a “statuses” Retweeted e Quoted, il JSON di X API v2 fa riferimento a Retweeted e Quoted Tweets. Molti campi legacy e deprecati, come contributors e user.translator_type, vengono rimossi. 
  • Invece di utilizzare sia favorites (nel Post object) sia favourites (nell’oggetto utente), X API v2 utilizza il termine like. 
  • X adotta la convenzione secondo cui i valori JSON senza valore (ad esempio null) non vengono scritti nel payload. Gli attributi di Post e user sono inclusi solo se hanno valori non null.   
Abbiamo inoltre introdotto un nuovo set di campi nel Post object, tra cui:
  • Un campo conversation_id
  • Due nuovi campi annotations, inclusi context ed entities
  • Diversi nuovi campi metrics 
  • Un nuovo campo reply_setting, che indica chi può rispondere a un determinato Post
Parametri della richiesta I seguenti parametri di richiesta Standard v1.1 accettavano due parametri query della richiesta (user_id o screen_name). La X API v2 accetta solo l’id utente numerico, che deve essere passato come parte del percorso dell’endpoint.
⌘I