Serviço de Arquivos

O Files Service permite fazer upload de arquivos para que eles possam ser referenciados em solicitações de API do Altium 365. O caso de uso típico é fazer upload de um arquivo (como uma exportação de biblioteca de componentes) e, em seguida, passar o ID de arquivo retornado para uma mutação de API que aceita entrada de arquivo.

Fazendo upload de um arquivo

Envie uma solicitação multipart/form-data POST para o endpoint de arquivos com seu token de acesso no cabeçalho Authorization. O corpo da resposta é o ID do arquivo.

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)

Passe file_id para a mutação de API relevante como referência do arquivo. Consulte o schema da API para saber quais mutações aceitam IDs de arquivo.

Endpoints

O caminho de upload é /File/Upload anexado à URL base do serviço de arquivos. Consulte Altium 365 API Endpoints para ver a lista completa de URLs base do Workspace e regionais.