Aller au contenu

Migrer depuis RapidAPI

Si vous appelez l'API Signet QR via RapidAPI, rien ne casse. Le canal marketplace reste exactement tel quel : même URL, même en-tête d'authentification, même structure JSON, même SLA.

Ce qui a changé, c'est que le même moteur alimente désormais aussi un site grand public, qr-branding.com, avec des packs de crédits à achat unique. Vous pouvez rester sur la marketplace, changer, ou utiliser les deux.

Ce qui ne change pas

  • URL : api.qr-branding.com (CNAME vers la même Azure Function App signetqr-core).
  • Authentification : en-tête X-RapidAPI-Proxy-Secret.
  • Endpoints : tous les chemins que vous appeliez.
  • Structure des corps de requête : QrConfig et AiQrRequest sont inchangés.
  • Structure des réponses : identique.
  • Limites de débit : mêmes plafonds de plan RapidAPI.
  • Facturation : toujours via l'abonnement mensuel / le paiement à l'appel de RapidAPI.

Ce qui est nouveau

  • Une seconde voie d'authentification pour le site grand public : des en-têtes internes signés en HMAC (X-Internal-Service-Secret + X-Internal-Signature). Vous ne les verrez pas : ils sont définis côté serveur par le BFF Next.js.
  • Un endpoint IA côté serveur, /api/qr/ai/generate/server, qui ne vous demande pas de fournir votre propre llmApiKey. Réservé aux clients du site grand public. Les clients de la marketplace continuent d'utiliser /api/qr/ai/generate avec leur clé.
  • Un cache de prompts de 30 jours (Upstash Redis). Relancer les mêmes prompt + provider + model + creativity + style + strict renvoie la configuration en cache : aucun appel au LLM, aucun coût en tokens.

Quand passer aux crédits grand public

Vous avez probablement intérêt à migrer si :

  • Vous faites moins de 200 générations IA par mois (Starter à 9 $ une fois coûte moins cher qu'un plan mensuel).
  • Vous en avez assez d'apporter vos propres clés LLM et voulez un LLM côté serveur avec un prix fixe par crédit.
  • Vous voulez des QR dynamiques avec statistiques (dès 1 gratuit avec un compte) ou un accès API inclus (uniquement avec Studio).

Vous avez probablement intérêt à rester sur la marketplace si :

  • Vous faites plus de 1500 générations IA par mois avec un volume régulier (l'abonnement est plus avantageux que les packs).
  • Vous avez une intégration RapidAPI existante avec son outillage, son rapprochement de facturation, etc.
  • Vous voulez choisir entre OpenAI/Anthropic/Cohere/Mistral : l'endpoint de la marketplace vous laisse le choix.

Utilisation en parallèle

Rien ne vous empêche d'utiliser les deux canaux en parallèle. Les appels marketplace passent par api.qr-branding.com, le parcours du site grand public par qr-branding.com/api/internal/.... Même moteur, deux compteurs de facturation, aucune interférence.

Si vous hésitez à migrer, répondez à votre dernier reçu : le message nous parvient directement.