Краткое руководство по началу работы с API Altium 365

Altium 365 API предоставляет программный доступ к данным вашего Workspace — проектам, BOM, компонентам, символам, посадочным местам и многому другому. Это GraphQL API, то есть вы можете запрашивать именно те данные, которые вам нужны, одним запросом.

Это руководство поможет вам с нуля сделать свой первый API-вызов за считанные минуты.

Предварительные требования

• Workspace в Altium 365

• Учетная запись администратора Workspace

• Учетная запись в Altium Developer Center – портал самообслуживания Altium для разработчиков, где можно присоединиться к программам для доступа к Altium 365 API, Altium Designer SDK, Embeddable Viewer и другим продуктам для разработчиков

Шаг 1: Создайте токен

Чтобы авторизовать API-запросы, вам нужен токен доступа. Токены создаются в вашем Workspace в разделе Admin → Developer.

При создании токена вы можете выбрать один из двух следующих вариантов.

Вариант A: долгоживущий токен доступа

Самый простой способ начать работу. Вы получаете один токен доступа с настраиваемым сроком действия (до 1 года). Используйте его напрямую в API-запросах.

Подходит для: быстрого изучения, скриптов и интеграций, где приоритетом является простота.

Подробнее см. в Using an Access token.

Вариант B: Refresh Token (рекомендуется для production)

Более безопасный подход. Вы получаете refresh token вместе с client ID и client secret. Refresh token программно обменивается на краткоживущий токен доступа, который затем используется в API-запросах. Сам refresh token также имеет настраиваемый срок действия (до 1 года).

Подходит для: автоматизированных интеграций, фоновых сервисов и всего, что работает в production 24/7.

Подробнее о процессе обмена см. в Using a Refresh Token.

Шаг 2: Выполните свой первый API-запрос

Самый быстрый способ изучить Altium 365 API — использовать встроенную browser IDE (на базе Nitro). Перейдите по адресу:

https://{workspace-domain}.altium.com/api/graphql/

Замените {workspace-domain} на фактический домен вашего Workspace (например, mycompany.altium.com).

Авторизуйте запрос

Для всех API-запросов требуется токен доступа, передаваемый в HTTP-заголовке Authorization по схеме Bearer:

Authorization: Bearer {access-token}

Выполните свой первый запрос

Для начала хорошо подойдет запрос на получение списка проектов вашего Workspace:

query {
  desProjects(first: 10) {
    nodes {
      id
      name
      description
    }
  }
}

Вставьте его в IDE, нажмите Run, и в ответе вы должны увидеть проекты своего Workspace.

Вы также можете визуально просмотреть полную схему API по адресу:

https://{workspace-domain}.altium.com/api/voyager

Следующие шаги

• Перейдите в организацию GitHub AltiumDeveloper, чтобы найти демонстрационные приложения и примеры запросов

• См. Using an Access Token, чтобы узнать, как использовать токены в коде и скриптах

• См. Using a Refresh Token для автоматизированных интеграций