Octopart API クイックスタートガイド

Octopart API は、電子部品のサプライチェーンデータ向けの GraphQL API です。これにより、Octopart データベース内の部品、価格、在庫レベル、販売代理店のオファー、工場リードタイムなどに、プログラムからアクセスできます。対象は、世界中の何千ものメーカーや販売代理店が扱う数百万点のコンポーネントにおよびます。

このガイドでは、ゼロから数分で最初の Octopart API クエリを実行できるようになります。

前提条件

Altium Developer Center のアカウント – 開発者向けの Altium セルフサービスポータルです。ここでは、Altium 365 API、Octopart API、Altium Designer SDK、Embeddable Viewer、そのほかの開発者向け製品にアクセスするためのプログラムに登録できます

ステップ 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 を使用します。詳しくは Octopart API のページネーション を参照してください。

ブラウザで試す

GraphQL エンドポイントで直接利用できる Nitro IDE では、クエリを対話的に実行して調べることができます。

https://api.nexar.com/graphql

スキーマを視覚的に確認するには、Voyager ブラウザを開きます。

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

次のステップ

• Authorization – トークンの有効期限、トークンの再取得、認証情報の管理

• Search – MPN マッチング、キーワード検索、フィルター、地域、通貨

• Example Queries – 一般的なユースケース向けの、そのまま実行できるクエリ