# Référence API

Créez des intégrations personnalisées avec l'API REST d'Anomalia. Tous les points d'accès nécessitent une authentification et retournent du JSON.

## URL de base

`https://anomalia.so/api/v1` 

## Authentification

Chaque requête nécessite un jeton `Bearer` dans l'en-tête `Authorization`.

### JWT Supabase (CLI / session web)

Obtenu via le flux de connexion de la CLI. Se renouvelle automatiquement. Expire après ~1 heure.

`Authorization: Bearer <jwt_token>`

### Clé API (intégrations)

Clé de longue durée générée depuis le [tableau de bord](/app/api-keys). Accès complet en lecture et écriture. Commence par `anomalia_`.

`Authorization: Bearer anomalia_live_...`

## Gestion des erreurs

Toutes les erreurs retournent un corps JSON cohérent :

`{ "error": "Human-readable message" }`

| Code | Signification |
| --- | --- |
| `401` | Non autorisé — jeton manquant ou invalide |
| `403` | Interdit — la clé API n'a pas accès à cette marque |
| `404` | Non trouvé |
| `405` | Méthode non autorisée |
| `500` | Erreur interne du serveur |

## Démarrage rapide

```
export TOKEN="anomalia_live_..."

# List brands
curl -H "Authorization: Bearer $TOKEN" https://anomalia.so/api/v1/brands

# Get posts
curl -H "Authorization: Bearer $TOKEN" \
  https://anomalia.so/api/v1/brands/my-brand/posts

# Approve a post
curl -X POST -H "Authorization: Bearer $TOKEN" \
  https://anomalia.so/api/v1/brands/my-brand/posts/ID/approve
```

[

Suivant →

Marques

](/fr/docs/api/brands)

---
Source: https://www.anomalia.so/fr/docs/api