> ## Documentation Index
> Fetch the complete documentation index at: https://docs.topsort.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Tipos de Clave API

> Comprenda los dos tipos de claves API en Topsort y cuándo usar cada una para diferentes endpoints.

export const LastUpdated = ({date, lang = "en"}) => {
  const translations = {
    en: "Last updated:",
    es: "Última actualización:",
    pt: "Última atualização:",
    fr: "Dernière mise à jour:",
    de: "Zuletzt aktualisiert:"
  };
  const label = translations[lang] || translations.en;
  return <>
<style>{`
.last-updated-component {
display: inline-flex;
align-items: center;
gap: 8px;
padding: 10px 16px;
border-radius: 8px;
margin-top: 12px;
margin-bottom: 16px;
font-size: 14px;
background-color: rgba(0, 0, 0, 0.05);
border: 1px solid rgba(0, 0, 0, 0.12);
color: rgba(0, 0, 0, 0.75);
line-height: 1;
}

        .last-updated-component svg {
          flex-shrink: 0;
          vertical-align: middle;
        }

        .last-updated-component span {
          display: inline-flex !important;
          align-items: center !important;
          line-height: 1 !important;
        }

        [data-theme="dark"] .last-updated-component {
          background-color: #3a3a3a;
          border: 2px solid #888888;
          color: #ffffff;
        }

        [data-theme="dark"] .last-updated-component svg {
          stroke: #ffffff;
        }
      `}</style>
      <div className="last-updated-component">
        <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round">
          <circle cx="12" cy="12" r="10" />
          <polyline points="12 6 12 12 16 14" />
        </svg>
        <span>
          <strong style={{
    fontWeight: 600
  }}>{label}</strong> 
          <time dateTime={date}>{date}</time>
        </span>
      </div>
    </>;
};

Topsort utiliza dos tipos de claves API para diferentes propósitos.

## Referencia Rápida

| Tipo de Clave           | Propósito                                                   |
| ----------------------- | ----------------------------------------------------------- |
| **Marketplace API Key** | Endpoints de subasta y evento                               |
| **Advanced API Key**    | Sincronización de catálogo, campañas, informes, facturación |

<Note>
  La mayoría de las integraciones necesitan **ambos** tipos de clave: una clave Advanced para la sincronización de catálogo, campañas e informes, y una clave Marketplace para subastas y eventos.
</Note>

## ¿Qué Clave Necesito?

| Endpoint                              | Tipo de Clave |
| ------------------------------------- | ------------- |
| `POST /v2/auctions`                   | Marketplace   |
| `POST /v2/events`                     | Marketplace   |
| `/public/v1/catalog-search-service/*` | Advanced      |
| `/public/v1/campaign-service/*`       | Advanced      |
| `/public/v1/reporting-service/*`      | Advanced      |
| `/public/v1/billing-service/*`        | Advanced      |

## Errores Comunes

### 401 Unauthorized

```json theme={null}
{
  "error": "Unauthorized",
  "message": "Invalid or missing API key"
}
```

**Causas:**

* Clave API no incluida en el encabezado `Authorization`
* La clave está mal formada o expirada
* Usando clave Advanced en un endpoint exclusivo de Marketplace

**Solución:** Verifique el formato del encabezado: `Authorization: Bearer YOUR_API_KEY`

### 403 Forbidden

```json theme={null}
{
  "error": "Forbidden", 
  "message": "Insufficient permissions"
}
```

**Causas:**

* Usando una clave Advanced en un endpoint que requiere una clave Marketplace
* Usando una clave Marketplace en un endpoint que requiere una clave Advanced

**Solución:** Use el tipo de clave que corresponda al endpoint — consulte [¿Qué Clave Necesito?](#qué-clave-necesito) arriba

## Cómo Obtener Sus Claves

### Marketplace API Key

<Steps>
  <Step title="Acceder a Topsort Admin">
    Inicie sesión en su panel de administración de Topsort
  </Step>

  <Step title="Navegar a Configuración de API">
    Vaya a **Configuración** → **Integración de API**
  </Step>

  <Step title="Crear Clave API">
    Haga clic en **"Generar clave API"** y seleccione **"Marketplace API key"**
  </Step>

  <Step title="Copiar y Almacenar">
    Copie la clave inmediatamente y guárdela de forma segura (solo se muestra una vez)
  </Step>
</Steps>

### Advanced API Key

<Steps>
  <Step title="Acceder a Topsort Admin">
    Inicie sesión en su panel de administración de Topsort
  </Step>

  <Step title="Navegar a Configuración de API">
    Vaya a **Configuración** → **Acceso a API**
  </Step>

  <Step title="Generar Clave">
    Haga clic en **"Generar Clave"** para crear su clave Advanced API
  </Step>

  <Step title="Copiar y Almacenar">
    Copie la clave y guárdela de forma segura en sus variables de entorno
  </Step>
</Steps>

## Mejores Prácticas de Seguridad

* **Nunca confirme claves en el control de versiones**
* **Almacene claves en variables de entorno**
* **Rote las claves regularmente**
* **Use claves diferentes para diferentes entornos (dev, staging, producción)**
* **Restrinja el acceso a las claves solo a los miembros del equipo necesarios**

<LastUpdated date="2026-06-12" />