> ## 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.

# Démarrage rapide

> Créez une clé d'API et faites votre premier appel.

**1. Créer une clé d'API**

Dans StockShift, ouvrez **Paramètres > Accès > Clés d'API** et appuyez sur **Nouvelle clé d'API**. Nommez-la d'après le système qui l'utilisera, cochez `catalog:read` et appuyez sur **Créer la clé**.

Copiez la clé tout de suite. Elle n'est affichée qu'une seule fois.

**2. Lister vos articles**

Envoyez la clé comme jeton de type Bearer. Les chemins sont relatifs à `https://app.stockshift.io/api/v1`, et les requêtes et les réponses sont en 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. Lire la réponse**

Une liste revient une page à la fois, avec un curseur pour la page suivante :

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

Renvoyez `next_cursor` comme `after` pour obtenir la page suivante. Les SDK le font pour vous. Consultez [Pagination](https://docs.stockshift.io/fr-ca/guides/pagination.md).

## Et ensuite

* Ne donnez à chaque clé que les portées dont sa tâche a besoin. [Autorisations et portées](https://docs.stockshift.io/fr-ca/guides/permissions-and-scopes.md) explique les deux vérifications que chaque appel doit passer.
* Basez votre logique sur le `code` d'une erreur, pas sur son texte. Consultez [Erreurs](https://docs.stockshift.io/fr-ca/guides/errors.md).
* Plutôt que d'interroger l'API pour repérer les changements, [abonnez-vous aux webhooks](https://docs.stockshift.io/fr-ca/guides/webhooks.md).


## Related topics

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


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