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

# Inicio rápido

> Crea una clave de API y haz tu primera llamada.

**1. Crea una clave de API**

En StockShift, abre **Configuración > Acceso > Claves de API** y presiona **Nueva clave de API**. Ponle el nombre del sistema que la va a usar, marca `catalog:read` y presiona **Crear clave**.

Copia la clave de inmediato. Se muestra una sola vez y nunca más.

**2. Lista tus artículos**

Envía la clave como token bearer. Las rutas son relativas a `https://app.stockshift.io/api/v1`, y las solicitudes y respuestas son JSON.

```bash curl theme={null}
curl https://app.stockshift.io/api/v1/catalog/items \
  -H "Authorization: Bearer $STOCKSHIFT_TOKEN" \
  -H "Accept: application/json"
```

```ts TypeScript theme={null}
import { StockShift } from "@stockshift/sdk";

const stockshift = new StockShift({ token: process.env.STOCKSHIFT_TOKEN! });

for await (const item of stockshift.paginate("/catalog/items")) {
  console.log(item.sku, item.name);
}
```

```python Python theme={null}
import os

from stockshift import StockShift

with StockShift(token=os.environ["STOCKSHIFT_TOKEN"]) as stockshift:
    for item in stockshift.catalog.iter_items():
        print(item.sku, item.name)
```

```php PHP theme={null}
use StockShift\Sdk\StockShift;

$stockshift = new StockShift(getenv('STOCKSHIFT_TOKEN'));

$page = $stockshift->catalog()->listItems();
```

**3. Lee la respuesta**

Una lista llega una página a la vez, con un cursor para la página siguiente:

```json theme={null}
{
  "data": {
    "items": [{ "id": "01J8QZ4M...", "sku": "BOLT-M4", "name": "M4 hex bolt" }],
    "next_cursor": "eyJpZCI6IjAxSjhRWjRN..."
  }
}
```

Envía `next_cursor` de vuelta como `after` para obtener la página siguiente. Los SDK lo hacen por ti. Consulta [Paginación](https://docs.stockshift.io/es/guides/pagination.md).

## Siguientes pasos

* Dale a cada clave solo los alcances que necesita para su trabajo. [Permisos y alcances](https://docs.stockshift.io/es/guides/permissions-and-scopes.md) explica las dos comprobaciones que pasa cada llamada.
* Decide según el `code` de un error, no según su texto. Consulta [Errores](https://docs.stockshift.io/es/guides/errors.md).
* En lugar de consultar periódicamente si hay cambios, [suscríbete a los webhooks](https://docs.stockshift.io/es/guides/webhooks.md).


## Related topics

- [.NET](https://docs.stockshift.io/es/sdks/dotnet.md)
- [Go](https://docs.stockshift.io/es/sdks/go.md)
- [PHP](https://docs.stockshift.io/es/sdks/php.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.