Vai al contenuto principale

Introduzione

I Project ti consentono di organizzare il lavoro in base a come intendi utilizzare la X API, così da gestire efficacemente l’accesso all’API e monitorarne l’utilizzo. Ogni Project può contenere una o più App a seconda del tuo livello di accesso (descritto più avanti in questa pagina). Userai queste App per generare credenziali di autenticazione come API Key e Secret, Access Tokens utente e App Access Token. Sebbene tu possa utilizzare queste chiavi e token da qualsiasi App per accedere alla X API o alla X Ads API (devi richiedere accesso aggiuntivo per utilizzare la X Ads API), devi utilizzare chiavi e token di un’App associata a un Project per poter utilizzare gli endpoint di X API v2. Se disponi di un account sviluppatore, puoi visualizzare e gestire i tuoi Project nella pagina Projects & Apps all’interno del developer portal. Iscriviti per ottenere un account se non ne hai già uno.

Project e livelli di accesso alla X API

Al momento sono disponibili 4 diversi livelli di accesso applicati a livello di Project:
  • Free
  • Basic
  • Pro
  • Enterprise
Per maggiori informazioni su cosa offre ciascuno di questi livelli di accesso, visita la pagina about X API. Puoi avere un solo Project con uno tra Free, Basic o Pro. Di seguito descriviamo alcune differenze specifiche del Project:

Gratuito

Questo livello di accesso è disponibile per chiunque abbia effettuato l’iscrizione a un account sviluppatore. Numero di App all’interno di quel Project: 1 Tweet consumption cap: 1.500 Tweet al mese Metodi di autenticazione:

Basic

Questo livello di accesso è disponibile per chiunque abbia sottoscritto l’accesso Basic tramite il developer portal. Numero di App all’interno di quel Project: 2 Tweet consumption cap: 10.000 Tweet al mese Metodi di autenticazione:

Pro

Questo livello di accesso è disponibile per chiunque abbia sottoscritto l’accesso Pro tramite il developer portal. Numero di App all’interno di quel Project: 3 Limite di consumo dei Tweet: 1 milione di Tweet al mese Metodi di autenticazione:

Enterprise

Questo livello di accesso è disponibile per chi ha richiesto Enterprise, è stato approvato dal nostro team e ha firmato un contratto mensile con rinnovo automatico tramite un account manager di X. Invia la richiesta qui. Numero di App all’interno di tale Project: 3+ Limite di consumo dei Tweet: oltre 50 milioni di Tweet al mese Metodi di autenticazione:

Limiti ai Tweet e Project

I limiti di consumo dei Tweet si applicano a livello di Project, limitando di fatto il volume di Tweet che puoi recuperare da determinati endpoint della X API v2 in un determinato mese. Scopri di più sui limiti dei Tweet.

Configurazione dei Project

Creazione di un Project

Per creare un Project, fai clic su “New Project” nel tuo dashboard o nella pagina Projects & Apps del developer portal. Questa opzione è visibile solo se non hai già creato un Project. Ti verrà chiesto di fornire un nome per il Project, una descrizione e un caso d’uso. Ti verrà anche chiesto di creare una nuova App o collegare un’App autonoma esistente.

Creare o collegare un’App al tuo Project

Se il tuo Project non include un’App, puoi aggiungerne una facendo clic sul nome del Project nella dashboard. Da lì puoi creare una nuova App oppure selezionare un’App standalone esistente da collegare al tuo Project. Nell’App puoi generare le chiavi e i token di autenticazione elencati all’inizio di questa guida.

Modificare un Project

Per modificare un Project, fai clic sul nome del tuo Project dalla dashboard o dalla pagina Projects & Apps nel developer portal. Da lì vedrai i dettagli del tuo Project e potrai selezionare “Edit” per apportare modifiche.

App autonome

Le App autonome sono App che esistono al di fuori della struttura del Project. Le credenziali di autenticazione associate a queste App autonome possono effettuare richieste riuscite alle API di X Standard v1.1, Premium v1.1, Enterprise o alla X Ads API. Le App autonome genereranno errori quando tenteranno di effettuare richieste agli endpoint della X API v2, a meno che non vengano collegate a un Project. Se hai creato un’App prima di agosto 2020, sarà visibile nella sezione “Standalone Apps” del developer portal, in Projects & Apps. Il numero totale di App sarà limitato a dieci, incluse quelle collegate al tuo Project. Se fai parte di un account di team, vedrai le App di cui sei proprietario in Standalone Apps. Se un membro del team è proprietario di un’App che fa parte di un Project, potrai vedere il nome dell’App e le informazioni sul proprietario, ma non potrai modificarne le impostazioni, accedere alle sue chiavi e token o rigenerarli. Dovresti contattare il proprietario dell’App per apportare qualsiasi modifica alla sua App.
I