Altium 365 API

Updated: May 21, 2026

Altium 365 API è un’API GraphQL che fornisce accesso programmatico ai dati del tuo Workspace Altium 365. Supporta operazioni sia di lettura sia di scrittura su tutta l’ampiezza della piattaforma.

New to Altium 365 API? Inizia con la guida rapida per creare il tuo primo token ed effettuare la tua prima chiamata API in pochi minuti.

Come è organizzata l’API

L’API è strutturata attorno alle aree di dominio della piattaforma, note come bounded contexts. Ogni bounded context copre un’area specifica della piattaforma: le sue entità, operazioni e regole di business. I nomi dei tipi e delle query GraphQL seguono convenzioni di denominazione che riflettono l’area di dominio a cui appartengono, rendendo più semplice orientarsi nello schema una volta acquisita familiarità con la struttura.

Bounded context principali

Bounded Context	Cosa comprende
Design	Progetti PCB, schemi, varianti, release, pacchetti di produzione
Library	Componenti, simboli, footprint, parti, richieste di parti, datasheet
Procurement	Distinte base, voci BOM, parti alternative e sostitutive
Platform	Utenti, Workspace, organizzazioni, definizioni del ciclo di vita, nomenclatura delle revisioni
Collaboration	Commenti, thread di commenti, attività
Customization	Workflow, script, esecuzioni di script

Ulteriori bounded context coprono funzionalità più specializzate – modellazione dei dispositivi, aggiornamenti firmware over-the-air, gestione dei requisiti, software embedded e progettazione di sistema. Sono accessibili tramite la stessa API e seguono le stesse convenzioni.

Ogni bounded context avrà una propria sezione dedicata della documentazione man mano che la copertura si espande. Nel frattempo, il browser di schema integrato Voyager è un ottimo modo per esplorare l’intero grafo dei tipi.

Esplorazione dello schema

Altium 365 API è auto-documentata. Sono disponibili due strumenti integrati direttamente dall’URL del tuo Workspace:

Nitro – un IDE GraphQL basato su browser per scrivere ed eseguire query in modo interattivo:
```
https://{workspace-domain}/api/graphql/
```
Voyager – un grafico visivo dello schema completo, utile per comprendere le relazioni tra i tipi:
```
https://{workspace-domain}/api/voyager/
```

Endpoint

Endpoint del Workspace

Per la maggior parte delle integrazioni, utilizza l’endpoint del Workspace. È rivolto a un Workspace specifico ed è il punto di partenza consigliato:

	GraphQL	Servizio file
Workspace	`https://{workspace-domain}/api/graphql`	`https://{workspace-domain}/api/files`

Endpoint regionali

Utilizza un endpoint regionale quando non hai un Workspace nell’ambito dell’operazione – ad esempio, per elencare tutti i Workspace a cui un utente ha accesso – oppure quando lavori con dati globali come utenti e organizzazioni.

Regione	GraphQL	Servizio file
Europa	`https://eur.365.altium.com/api/graphql`	`https://eur.365.altium.com/api/files`
USA occidentali	`https://usw.365.altium.com/api/graphql`	`https://usw.365.altium.com/api/files`
USA orientali	`https://use.365.altium.com/api/graphql`	`https://use.365.altium.com/api/files`
Asia-Pacifico	`https://asp.365.altium.com/api/graphql`	`https://asp.365.altium.com/api/files`
Gov Cloud	`https://use.365-gov.altium.com/api/graphql`	`https://use.365-gov.altium.com/api/files`

Autenticazione

Tutte le richieste devono includere un token di accesso valido:

Authorization: Bearer {access-token}

Per i dettagli, vedi Uso di un token di accesso .

In questa sezione

Versione stampabile

Localizzato tramite A

Se trovi un problema, seleziona il testo/l’immagine e premi Ctrl + Invio per inviarci il tuo feedback.