Aller au contenu

Développeurs

Développez sur Route Royal

Le SDK, l’API, les webhooks, les apps OAuth et le serveur MCP, pour vos propres sites, apps et agents. Les outils développeur se trouvent dans le portail, ouvert aux organisations auxquelles nous avons donné l’accès.

Se connecter au portail développeurDemander l’accès développeur

  1. Un développeur avec accès

  2. ConnectéVotre compte Route Royal
  3. Votre organisationL’accès lui appartient
  4. Votre rôleGérer l’espace développeur ?
  5. Accès développeurAccordé à votre organisation
  6. Portail développeurAutorisé

Tous les contrôles sont passés : les clés, les apps et les webhooks sont à vous de les gérer.

Avec quoi développer

Cinq points d’entrée

Chacun travaille avec les données de votre organisation et les autorisations que vous accordez.

  • SDK Next.js

    Des hooks typés pour le navigateur et des clients pour le serveur : authentification, annonces, réservations, demandes, articles, commerce et analytics pour sites headless. Ce site tourne dessus.

  • API REST

    Lisez et écrivez les données de votre organisation sur api.routeroyal.com, avec des clés limitées à ce dont chaque intégration a besoin.

  • Webhooks

    Des événements pour les contacts, affaires, biens, produits, commandes, paiements et plus encore, signés en HMAC-SHA256 pour vérifier qu’ils viennent bien de nous.

  • Apps OAuth

    Laissez vos utilisateurs se connecter avec Route Royal et agissez pour eux via OAuth 2.0 : codes d’autorisation, jetons et révocation.

  • Serveur MCP

    Donnez à vos propres agents les outils de Route Royal via le Model Context Protocol, dans la limite des autorisations que vous accordez.

Obtenir l’accès

De la demande aux clés de production

  1. 1

    Demandez l’accès

    Dites-nous ce que vous développez, et pour quelle organisation.

  2. 2

    Nous l’activons

    Nous activons l’accès développeur pour votre organisation, selon des conditions convenues avec vous.

  3. 3

    Créez vos clés

    Connectez-vous, enregistrez votre domaine, vérifiez-le par DNS et créez une clé publiable et une clé secrète.

  4. 4

    Passez en production

    Développez avec des clés de test, puis passez aux clés de production au lancement.

Clés

Deux clés, bien séparées

Chaque clé du SDK appartient à un domaine que vous avez vérifié. La clé complète n’est affichée qu’une fois, et nous n’en conservons que l’empreinte.

  • Les clés publiables (pk_) ne font que lire : elles ne risquent rien dans le navigateur.
  • Les clés secrètes (sk_) peuvent écrire : elles restent sur votre serveur.
  • Chaque clé est liée à un domaine vérifié et peut avoir une date d’expiration et une liste d’IP autorisées.
  • Les requêtes sont limitées en débit, pour qu’aucune intégration n’accapare les ressources des autres.
.env.local
NEXT_PUBLIC_ROUTEROYAL_DOMAIN=www.example.com
NEXT_PUBLIC_ROUTEROYAL_PUBLIC_KEY=pk_test_…

# Serveur uniquement : jamais dans le code navigateur
ROUTEROYAL_SECRET_KEY=sk_test_…

Questions

Ce que demandent les développeurs

Qui peut obtenir l’accès développeur ?

Les organisations présentes sur Route Royal. Nous l’accordons par organisation et, au sein de celle-ci, les personnes dont le rôle permet de gérer les paramètres développeur peuvent s’en servir.

L’accès développeur est-il payant en plus ?

Nous convenons des conditions avec chaque organisation lorsque nous accordons l’accès. Posez-nous la question et nous vous dirons ce qui s’applique à votre projet.

Où trouver la documentation ?

Elle est fournie avec l’accès. Le SDK est un paquet privé qui inclut son guide, et nous accompagnons chaque nouvelle intégration avec l’équipe qui la développe.

Faut-il l’accès développeur pour utiliser Claude ou ChatGPT avec Route Royal ?

Non. Connecter Claude ou ChatGPT à votre organisation fait partie d’IA et Q. L’accès développeur sert à créer vos propres sites, apps et agents.

Y a-t-il des limites de débit ?

Oui. Chaque clé et chaque jeton est limité en débit, et les agents IA ont leurs propres limites par minute et par session. Nous vous indiquons les limites applicables lorsque nous accordons l’accès.

Existe-t-il déjà quelque chose de construit dessus ?

Ce site web. Ses actualités sont des articles Route Royal lus via le SDK, comme votre site lirait vos annonces, réservations ou articles.

Accès développeur

Faites votre premier appel à Route Royal

L’accès développeur est accordé par organisation. Dites-nous ce que vous construisez et pour quelle organisation. Une fois l’accès activé, vous créez vos clés dans le portail et passez cet appel avec les vôtres.

Demander l’accès développeurSe connecter au portail développeur

Les demandes se font par e-mail à support@routeroyal.com.

lib/news.ts
Sortie

Deux articles, lus sur votre serveur avec une clé publiable : c’est ainsi que ce site lit ses actualités.

Clés et données d’exemple