ファイルサービス

Files Service では、Altium 365 API リクエスト内で参照できるようにファイルをアップロードできます。一般的な使用例としては、ファイル（コンポーネント ライブラリのエクスポートなど）をアップロードし、その後、返されたファイル ID をファイル入力を受け付ける API ミューテーションに渡します。

ファイルのアップロード

multipart/form-data ヘッダーにアクセストークンを指定し、files エンドポイントに Authorization POST リクエストを送信します。レスポンス本文はファイル 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)

file_id をファイル参照として、該当する API ミューテーションに渡します。どのミューテーションがファイル ID を受け付けるかについては、API スキーマを参照してください。

エンドポイント

アップロード パスは、Files Service のベース URL に追加される /File/Upload です。Workspace および各リージョンのベース URL の一覧については、Altium 365 API Endpoints を参照してください。