Servizio File

Il servizio Files consente di caricare file in modo che possano essere referenziati nelle richieste API di Altium 365. Il caso d’uso tipico consiste nel caricare un file (ad esempio un’esportazione di libreria di componenti) e poi passare l’ID file restituito a una mutation API che accetta input di file.

Caricamento di un file

Invia una richiesta multipart/form-data POST all’endpoint files con il tuo token di accesso nell’Authorizationheader. Il corpo della risposta è l’ID del file.

curl:

curl --location 'https://{workspace-domain}/svc/napi/files/File/Upload' \
  --header 'Authorization: Bearer {your-access-token}' \
  --form 'file=@"components.zip"'

Python:

import requests

token = "your-access-token"
file_path = "components.zip"

with open(file_path, "rb") as f:
    response = requests.post(
        "https://{workspace-domain}/svc/napi/files/File/Upload",
        files={"file": (file_path, f, "application/zip")},
        headers={"Authorization": f"Bearer {token}"}
    )

file_id = response.text
print(file_id)

Passa file_id alla relativa mutation API come riferimento al file. Consulta lo schema API per sapere quali mutation accettano ID file.

Endpoint

Il percorso di upload è /File/Upload aggiunto all’URL di base del servizio files. Consulta Altium 365 API Endpoints per l’elenco completo dei Workspace e degli URL di base regionali.