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 una libreria di componenti) e quindi passare l’ID file restituito a una mutation API che accetta un file come input.

Caricamento di un file

Invia una richiesta multipart/form-data POST all’endpoint files con il tuo access token nell’header Authorization. Il corpo della risposta contiene 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.