Documentation API

Intégrez QRCode-CHR dans vos applications avec notre API REST.

🔐 Authentification

Toutes les requĂȘtes API nĂ©cessitent une authentification via Bearer Token.

Authorization: Bearer VOTRE_CLE_API

💡 Obtenez votre clĂ© API dans ParamĂštres → API

GET

/api/redirections

RécupÚre la liste de vos redirections.

ParamĂštres (query)

pageNuméro de page (défaut: 1)
limitNombre de résultats par page (défaut: 50, max: 100)

Exemple

curl -X GET "https://www.qrcode-chr.fr/api/redirections?limit=10" \
  -H "Authorization: Bearer VOTRE_CLE_API"

Réponse

{
  "success": true,
  "data": [
    {
      "id": "uuid",
      "short_code": "abc123",
      "original_url": "https://example.com",
      "title": "Mon lien",
      "clicks_count": 42,
      "is_active": true,
      "created_at": "2024-01-01T00:00:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 10,
    "total": 42,
    "total_pages": 5
  }
}
GET

/api/redirections/:id

RécupÚre les détails d'une redirection spécifique avec ses statistiques de clics.

Exemple

curl -X GET "https://www.qrcode-chr.fr/api/redirections/UUID" \
  -H "Authorization: Bearer VOTRE_CLE_API"
POST

/api/redirections

Crée une nouvelle redirection.

Corps de la requĂȘte

{
  "original_url": "https://example.com",
  "title": "Mon lien",
  "short_code": "custom123",  // optionnel
  "expires_at": "2024-12-31"  // optionnel
}

Exemple

curl -X POST "https://www.qrcode-chr.fr/api/redirections" \
  -H "Authorization: Bearer VOTRE_CLE_API" \
  -H "Content-Type: application/json" \
  -d '{
    "original_url": "https://example.com",
    "title": "Mon lien"
  }'

⚠ Codes d'erreur

401Non authentifié - Token manquant ou invalide
403AccÚs refusé - Limite atteinte ou permission manquante
404Ressource non trouvée
429Trop de requĂȘtes - Rate limit dĂ©passĂ©
500Erreur serveur

💬 Besoin d'aide ?

Contactez notre support via la page Support