Questions fréquentes

Pourquoi v1 apparaît-t-il deux fois dans l’URL ?

Le premier /v1 appartient à la passerelle Supabase Edge Functions. Le second versionne le contrat Orbit : /functions/v1/api/v1/interests/search.

Puis-je appeler Orbit depuis React ou Expo ?

Pas directement. Une clé Orbit est un secret serveur. React ou Expo appelle votre backend, qui appelle ensuite Orbit.

Ai-je besoin d’une clé Supabase ?

Non. Le consommateur utilise uniquement la base URL Orbit et sa clé Orbit. L’infrastructure Supabase reste interne au service.

Puis-je télécharger tout le catalogue ?

Non. La v1 expose une recherche top-N non paginée, pas un export exhaustif.

Que dois-je stocker ?

L’UUID Orbit, accompagné du dernier libellé et de la catégorie sélectionnés. Le texte saisi ou la position d’un résultat ne constitue pas une identité.

Faut-il maintenir une table d’alias ou un cache complet ?

Non pour les sélections d’utilisateurs. resolve indique si un UUID est résolu, remplacé, indisponible ou inconnu.

Les libellés sont-ils toujours français ?

Non. La v1 ne fournit pas encore de langues ou traductions distinctes ; un libellé canonique peut être français ou anglais.

Y a-t-il des images ou des descriptions ?

Non. La v1 se limite aux identifiants, libellés et catégories dont le périmètre de redistribution est établi.

not_found est-il une erreur HTTP ?

Non. Dans une réponse de résolution valide, not_found est un résultat métier retourné avec HTTP 200.

Comment obtenir une clé ou payer en ligne ?

Le parcours a été validé sur une Preview avec un compte créé par l’opérateur : un accès Gratuit révèle sa première clé une seule fois, puis Stripe permet de tester Pro à 9 €/mois exclusivement en mode test. L’abonnement porte le plafond mensuel de 10 000 à 50 000 réponses réussies sans changer la clé et sans dépassement facturé. L’inscription publique et le paiement autonome restent fermés en production ; les clients approuvés reçoivent actuellement leur accès par intégration manuelle.