API REST

Créez, modifiez et mesurez vos QR codes depuis vos propres outils. Disponible à partir du plan Pro.

Authentification

Chaque espace de travail peut créer des clés API depuis ses paramètres. La clé n'est affichée qu'une fois. Envoyez-la dans l'en-tête Authorization.

curl -H "Authorization: Bearer sc_xxxxxxxx…" https://www.scanolo.com/api/v1/codes

Points d'accès

Méthode	Chemin	Description
`GET`	`/api/v1/codes`	Liste des codes de l'espace de travail (paginée).
`POST`	`/api/v1/codes`	Crée un code. Corps JSON : name, kind, mode, payload, design.
`GET`	`/api/v1/codes/{id}`	Détail d'un code, adresse courte incluse.
`PATCH`	`/api/v1/codes/{id}`	Modifie le nom, la destination, le design ou le statut.
`DELETE`	`/api/v1/codes/{id}`	Supprime un code (il cesse de rediriger après confirmation explicite).
`GET`	`/api/v1/codes/{id}/image.svg`	Image du code en SVG ou PNG (paramètre size pour le PNG).
`GET`	`/api/v1/codes/{id}/stats`	Statistiques de scans entre deux dates.
`POST`	`/api/v1/render`	Rendu d'un code statique sans le stocker.

Exemple

curl -X POST https://www.scanolo.com/api/v1/codes \
  -H "Authorization: Bearer sc_xxxxxxxx…" \
  -H "Content-Type: application/json" \
  -d '{"name": "Menu terrasse", "kind": "url", "mode": "dynamic",
       "payload": {"url": "https://example.com/menu"},
       "design": {"fg": "#10211F", "module": "rounded"}}'

{"id": 42, "slug": "k7Hp3Qz", "short_url": "https://www.scanolo.com/r/k7Hp3Qz",
 "kind": "url", "mode": "dynamic", "status": "active", "safety_status": "safe",
 "scans_total": 0, "created_at": "2026-09-06T10:00:00Z"}

Limites

Pro : 60 requêtes par minute. Business : 300. Au-delà, la réponse est 429 avec un en-tête Retry-After. Les quotas de codes dynamiques du plan s'appliquent aussi par API.

Obtenir une clé API