Guía de inicio rápido de la API de Octopart

La API de Octopart es una API de GraphQL para datos de la cadena de suministro de componentes electrónicos. Le proporciona acceso programático a la base de datos de Octopart —piezas, precios, niveles de inventario, ofertas de distribuidores, plazos de entrega de fábrica y más— en millones de componentes de miles de fabricantes y distribuidores de todo el mundo.

Esta guía le lleva desde cero hasta su primera consulta a la API de Octopart en cuestión de minutos.

Requisitos previos

Una cuenta en Altium Developer Center – el portal de autoservicio de Altium para desarrolladores, donde puede inscribirse en programas para acceder a Altium 365 API, Octopart API, Altium Designer SDK, Embeddable Viewer y otros productos para desarrolladores

Paso 1: Obtener credenciales

1. Inicie sesión en portal.nexar.com.

2. Cree una nueva aplicación.

3. Copie el Client ID y el Client Secret – necesitará ambos para solicitar un token.

Paso 2: Obtener un token de acceso

Intercambie sus credenciales por un token de acceso usando la concesión 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"

Una respuesta correcta tiene este aspecto:

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

Copie el valor de access_token. Los tokens caducan después de una hora; consulte Authentication para saber cómo gestionar la renovación del token en su aplicación.

Paso 3: Ejecute su primera consulta

Envíe una consulta GraphQL al endpoint usando su token en el encabezado 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 } } } } }"
  }'

Una respuesta correcta devuelve las piezas coincidentes:

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

El campo hits muestra cuántas piezas coincidieron. Use limit y start para paginar los resultados; consulte Paginación en Octopart API.

Pruébelo en el navegador

Puede ejecutar y explorar consultas de forma interactiva en Nitro IDE, disponible directamente en el endpoint de GraphQL:

https://api.nexar.com/graphql

Para explorar el esquema visualmente, abra el navegador Voyager:

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

Siguientes pasos

• Authorization – caducidad del token, nueva solicitud de tokens y gestión de credenciales

• Search – coincidencia de MPN, búsqueda por palabras clave, filtros, región y moneda

• Example Queries – consultas listas para usar para casos de uso comunes