Guide de démarrage rapide de l’API Octopart

L’API Octopart est une API GraphQL dédiée aux données de chaîne d’approvisionnement des composants électroniques. Elle vous donne un accès programmatique à la base de données Octopart – pièces, prix, niveaux de stock, offres des distributeurs, délais usine, et bien plus encore – sur des millions de composants provenant de milliers de fabricants et de distributeurs dans le monde entier.

Ce guide vous permet de passer de zéro à votre première requête Octopart API en quelques minutes.

Prérequis

Un compte sur Altium Developer Center – le portail en libre-service d’Altium pour les développeurs, où vous pouvez vous inscrire à des programmes afin d’accéder à l’API Altium 365, à l’API Octopart, au SDK Altium Designer, à Embeddable Viewer et à d’autres produits pour développeurs

Étape 1 : Obtenir les identifiants

1. Connectez-vous à portal.nexar.com.

2. Créez une nouvelle application.

3. Copiez le Client ID et le Client Secret – vous aurez besoin des deux pour demander un jeton.

Étape 2 : Obtenir un jeton d’accès

Échangez vos identifiants contre un jeton d’accès à l’aide du flux OAuth 2.0 client_credentials :

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"

Une réponse réussie ressemble à ceci :

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

Copiez la valeur access_token. Les jetons expirent après une heure – voir Authentification pour savoir comment gérer l’actualisation du jeton dans votre application.

Étape 3 : Exécuter votre première requête

Envoyez une requête GraphQL au point de terminaison en utilisant votre jeton dans l’en-tête Authorization :

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 } } } } }"
  }'

Une réponse réussie renvoie les pièces correspondantes :

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

Le champ hits indique combien de pièces correspondent. Utilisez limit et start pour parcourir les résultats par pages – voir Pagination dans l’API Octopart.

Essayez-le dans le navigateur

Vous pouvez exécuter et explorer les requêtes de manière interactive dans l’IDE Nitro, disponible directement au point de terminaison GraphQL :

https://api.nexar.com/graphql

Pour explorer visuellement le schéma, ouvrez le navigateur Voyager :

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

Étapes suivantes

• Autorisation – expiration des jetons, nouvelle demande de jetons et gestion des identifiants

• Recherche – correspondance MPN, recherche par mot-clé, filtres, région et devise

• Exemples de requêtes – requêtes prêtes à l’emploi pour les cas d’usage courants