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

# Introduction

> Référence de l'API Vinkit

## API Vinkit

L'API Vinkit vous permet de gérer votre blog par programmation : créer des articles, gérer les tags, récupérer vos contenus et recevoir des notifications via webhooks.

### URL de base

```
https://api.vinkit.co/v1
```

### Authentification

Toutes les requêtes API nécessitent un token Bearer. Générez votre clé API depuis **Paramètres > API** dans votre tableau de bord.

```bash theme={null}
curl -H "Authorization: Bearer VOTRE_CLE_API" \
  https://api.vinkit.co/v1/posts
```

<Warning>Ne partagez jamais votre clé API. Si elle est compromise, régénérez-la immédiatement depuis votre tableau de bord.</Warning>

### Format des réponses

L'API retourne des réponses au format JSON. Les erreurs suivent ce format :

```json theme={null}
{
  "error": 400,
  "message": "Description de l'erreur"
}
```

### Codes de statut

| Code  | Description                   |
| ----- | ----------------------------- |
| `200` | Succès                        |
| `201` | Ressource créée               |
| `204` | Suppression réussie           |
| `400` | Requête invalide              |
| `401` | Non authentifié               |
| `404` | Ressource non trouvée         |
| `429` | Trop de requêtes (rate limit) |

### Rate limiting

L'API est limitée à **100 requêtes par minute** par clé API. Les en-têtes de réponse incluent :

* `X-RateLimit-Limit` — nombre maximum de requêtes
* `X-RateLimit-Remaining` — requêtes restantes
* `X-RateLimit-Reset` — timestamp de réinitialisation

<Card title="Spécification OpenAPI" icon="file-code" href="https://github.com/vinkit/docs/blob/main/api-reference/openapi.json">
  Consultez la spécification OpenAPI complète
</Card>