Przewodnik szybkiego startu API Altium 365

Altium 365 API zapewnia programistyczny dostęp do danych w Twoim Workspace – projektów, BOM-ów, komponentów, symboli, footprintów i nie tylko. Jest to GraphQL API, co oznacza, że możesz pobrać dokładnie te dane, których potrzebujesz, w jednym żądaniu.

Ten przewodnik pozwoli Ci przejść od zera do pierwszego wywołania API w kilka minut.

Wymagania wstępne

• Workspace Altium 365

• Konto administratora Workspace

• Konto w Altium Developer Center – samoobsługowym portalu Altium dla deweloperów, gdzie możesz dołączyć do programów zapewniających dostęp do Altium 365 API, Altium Designer SDK, Embeddable Viewer i innych produktów dla deweloperów

Krok 1: Utwórz token

Aby autoryzować żądania API, potrzebujesz tokenu dostępu. Tokeny są tworzone w Twoim Workspace w sekcji Admin → Developer.

Podczas tworzenia tokenu możesz wybrać jedną z dwóch poniższych opcji.

Opcja A: Długowieczny token dostępu

Najprostszy sposób na rozpoczęcie pracy. Otrzymujesz pojedynczy token dostępu z konfigurowalnym czasem ważności (do 1 roku). Używasz go bezpośrednio w żądaniach API.

Dobre rozwiązanie do: szybkiego poznawania API, skryptów i integracji, w których priorytetem jest prostota.

Szczegóły znajdziesz w Using an Access token.

Opcja B: Refresh Token (zalecane dla środowiska produkcyjnego)

Bardziej bezpieczne podejście. Otrzymujesz refresh token wraz z client ID i client secret. Refresh token jest programowo wymieniany na krótkotrwały token dostępu, który następnie jest używany w żądaniach API. Sam refresh token ma konfigurowalny czas ważności (do 1 roku).

Dobre rozwiązanie do: zautomatyzowanych integracji, usług działających w tle oraz wszystkiego, co działa produkcyjnie 24/7.

Opis procesu wymiany znajdziesz w Using a Refresh Token.

Krok 2: Wykonaj swoje pierwsze żądanie API

Najszybszym sposobem na poznanie Altium 365 API jest skorzystanie z wbudowanego przeglądarkowego IDE (obsługiwanego przez Nitro). Przejdź do:

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

Zastąp {workspace-domain} swoim rzeczywistym adresem domeny Workspace (na przykład mycompany.altium.com).

Autoryzuj swoje żądanie

Wszystkie żądania API wymagają tokenu dostępu przekazanego w nagłówku HTTP Authorization z użyciem schematu Bearer:

Authorization: Bearer {access-token}

Uruchom swoje pierwsze zapytanie

Dobrym zapytaniem na początek jest wyświetlenie listy projektów w Twoim Workspace:

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

Wklej je do IDE, kliknij Run, a w odpowiedzi powinny pojawić się projekty z Twojego Workspace.

Możesz też wizualnie przeglądać pełny schemat API pod adresem:

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

Kolejne kroki

• Przejrzyj organizację GitHub AltiumDeveloper, aby znaleźć aplikacje demonstracyjne i przykładowe zapytania

• Zobacz Using an Access Token, aby dowiedzieć się, jak używać tokenów w kodzie i skryptach

• Zobacz Using a Refresh Token w kontekście zautomatyzowanych integracji