Datei-Service

Mit dem Files Service können Sie Dateien hochladen, damit in Altium 365 API-Anfragen darauf verwiesen werden kann. Der typische Anwendungsfall besteht darin, eine Datei (z. B. einen Export einer Komponentenbibliothek) hochzuladen und dann die zurückgegebene Datei-ID an eine API-Mutation zu übergeben, die Dateieingaben akzeptiert.

Hochladen einer Datei

Senden Sie eine multipart/form-data POST-Anfrage an den Files-Endpunkt und übergeben Sie dabei Ihr Zugriffstoken im Authorization-Header. Der Antworttext enthält die Datei-ID.

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)

Übergeben Sie file_id als Dateiverweis an die entsprechende API-Mutation. Welche Mutationen Datei-IDs akzeptieren, finden Sie im API-Schema.

Endpunkte

Der Upload-Pfad ist /File/Upload, angehängt an die Basis-URL des Files Service. Eine vollständige Liste der Workspace- und regionalen Basis-URLs finden Sie unter Altium 365 API-Endpunkte.