Octopart API 빠른 시작 가이드

Octopart API는 전자 부품 공급망 데이터를 위한 GraphQL API입니다. 이 API를 사용하면 전 세계 수천 개 제조사와 유통업체의 수백만 개 부품에 대해 부품, 가격, 재고 수준, 유통업체 오퍼, 제조 리드 타임 등 Octopart 데이터베이스에 프로그래밍 방식으로 접근할 수 있습니다.

이 가이드는 몇 분 안에 처음 Octopart API 쿼리를 실행할 수 있도록 처음부터 안내합니다.

사전 요구 사항

Altium Developer Center 계정 – 개발자가 Altium 365 API, Octopart API, Altium Designer SDK, Embeddable Viewer 및 기타 개발자 제품에 접근할 수 있도록 프로그램에 등록하는 Altium의 셀프서비스 포털입니다.

1단계: 자격 증명 받기

1. portal.nexar.com에 로그인합니다.

2. 새 애플리케이션을 생성합니다.

3. Client ID 및 Client Secret 를 복사합니다. – 토큰을 요청하려면 둘 다 필요합니다.

2단계: 액세스 토큰 받기

OAuth 2.0 client_credentials grant를 사용해 자격 증명을 액세스 토큰으로 교환합니다:

curl -X POST https://identity.nexar.com/connect/token \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=client_credentials" \
  -d "client_id=CLIENT_ID" \
  -d "client_secret=CLIENT_SECRET" \
  -d "scope=supply.domain"

성공적인 응답은 다음과 같습니다:

{
  "access_token": "eyJhbGci...",
  "expires_in": 86400,
  "token_type": "Bearer"
}

access_token 값을 복사하세요. 토큰은 1시간 후 만료됩니다. 애플리케이션에서 토큰 갱신을 처리하는 방법은 Authentication을 참조하세요.

3단계: 첫 번째 쿼리 실행

Authorization 헤더에 토큰을 넣어 엔드포인트로 GraphQL 쿼리를 전송합니다:

curl -X POST https://api.nexar.com/graphql \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "query { supSearchMpn(q: \"LM358\", limit: 3) { hits results { part { mpn manufacturer { name } } } } }"
  }'

성공적인 응답은 일치하는 부품을 반환합니다:

{
  "data": {
    "supSearchMpn": {
      "hits": 42,
      "results": [
        {
          "part": {
            "mpn": "LM358DR",
            "manufacturer": { "name": "Texas Instruments" }
          }
        }
      ]
    }
  }
}

hits 필드는 일치한 부품 수를 보여줍니다. limit 및 start를 사용해 결과를 페이지 단위로 조회하세요. 자세한 내용은 Pagination in Octopart API를 참조하세요.

브라우저에서 사용해 보기

GraphQL 엔드포인트에서 직접 제공되는 Nitro IDE에서 대화형으로 쿼리를 실행하고 탐색할 수 있습니다:

https://api.nexar.com/graphql

스키마를 시각적으로 탐색하려면 Voyager 브라우저를 여세요:

https://api.nexar.com/ui/voyager

다음 단계

• Authorization – 토큰 만료, 토큰 재요청, 자격 증명 관리

• Search – MPN 매칭, 키워드 검색, 필터, 지역 및 통화

• Example Queries – 일반적인 사용 사례를 위한 바로 실행 가능한 쿼리