파일 서비스

Files Service를 사용하면 파일을 업로드하여 Altium 365 API 요청에서 참조할 수 있습니다. 일반적인 사용 사례는 파일(예: 컴포넌트 라이브러리 내보내기 파일)을 업로드한 다음, 파일 입력을 받는 API mutation에 반환된 파일 ID를 전달하는 것입니다.

파일 업로드

multipart/form-data 헤더에 액세스 토큰을 포함하여 files 엔드포인트로 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 mutation에 전달하세요. 어떤 mutation이 파일 ID를 허용하는지는 API 스키마를 참조하세요.

엔드포인트

업로드 경로는 files service 기본 URL에 /File/Upload을(를) 덧붙인 것입니다. Workspace 및 지역별 기본 URL의 전체 목록은 Altium 365 API Endpoints를 참조하세요.