Développer avec Register.gy

Vue d’ensemble

Register.gy est un bureau d’enregistrement de domaines .gy accrédité. La plateforme pour développeurs donne accès aux mêmes outils que ceux que les clients utilisent dans l’Espace client, afin qu’un assistant ou une application puisse :

• Vérifier la disponibilité des noms en .gy, .com.gy, .co.gy, .net.gy et .org.gy, avec le prix et un lien d’enregistrement. Aucune connexion requise.
• Lister les domaines d’un client et lire leurs enregistrements DNS.
• Connecter un site web : envoyez les enregistrements affichés par un créateur de sites (Lovable, Bolt, Replit, v0, Netlify, Shopify…), obtenez un aperçu, puis appliquez. Chaque modification peut être annulée pendant 7 jours.
• Vérifier qu’un site est en ligne : visibilité DNS et https.

Par conception, la plateforme ne modifie jamais les enregistrements e-mail (MX) ni les serveurs de noms, ne transfère pas de domaines et ne touche pas aux paiements. Les modifications au niveau du registre sont effectuées par l’équipe Register.gy.

Démarrage rapide

1. Vérifier un nom (sans clé)

Copiercurl "https://register.gy/wp-json/rgy/v1/availability?domain=mybakery.gy"

2. Créer une clé API

Connectez-vous à l’Espace client, ouvrez API et assistants IA et cliquez sur Créer une clé API. Elle ne s’affiche qu’une seule fois.

3. Lister vos domaines

Copiercurl -H "Authorization: Bearer rgy_live_YOUR_KEY" https://register.gy/wp-json/rgy/v1/domains

4. Prévisualiser, puis connecter un site web

Copiercurl -X POST https://register.gy/wp-json/rgy/v1/domains/mybakery.gy/connect/preview \
  -H "Authorization: Bearer rgy_live_YOUR_KEY" -H "Content-Type: application/json" \
  -d '{"records":[{"type":"A","name":"@","value":"185.158.133.1"},{"type":"TXT","name":"_lovable","value":"lovable_verify=…"}]}'

Si l’aperçu vous convient, envoyez le même corps à /connect/apply. Annulez avec /connect/undo dans un délai de 7 jours.

Connecter un assistant IA

Register.gy exploite un serveur MCP distant (la méthode standard permettant aux assistants d’utiliser des outils externes). Les assistants qui prennent en charge la connexion ouvrent une fenêtre Register.gy : le client saisit son e-mail, tape le code à 6 chiffres que nous lui envoyons et approuve ce que l’assistant est autorisé à faire.

Copierhttps://register.gy/wp-json/rgy/v1/mcp

Copierhttps://register.gy/wp-json/rgy/v1/mcp

Copierclaude mcp add --transport http register-gy https://register.gy/wp-json/rgy/v1/mcp

Copier{
  "mcpServers": {
    "register-gy": {
      "url": "https://register.gy/wp-json/rgy/v1/mcp",
      "headers": { "Authorization": "Bearer rgy_live_YOUR_KEY" }
    }
  }
}

Demandez ensuite, par exemple : « mybakery.gy est-il disponible ? » ou « Connecte mon site Lovable à mybakery.gy. » L’assistant affiche les modifications prévues et demande votre accord avant de les appliquer.

Point de terminaison public, limité à la recherche (sans connexion) : https://register.gy/wp-json/rgy/v1/mcp/public

Authentification

OAuth 2.1 (recommandé pour les assistants et les applications utilisés par d’autres personnes)

• Flux par code d’autorisation avec PKCE (S256 uniquement). Clients publics et confidentiels.
• Enregistrement dynamique des clients (RFC 7591) sur https://register.gy/oauth/register. Les URI de redirection doivent être en https, ou en http sur localhost.
• Découverte : /.well-known/oauth-authorization-server (RFC 8414) et /.well-known/oauth-protected-resource (RFC 9728). Le point de terminaison MCP répond aux requêtes non authentifiées par un 401 et un en-tête WWW-Authenticate pointant vers les métadonnées de la ressource.
• Les jetons d’accès sont valables 1 heure ; les jetons d’actualisation 30 jours, avec rotation à chaque utilisation. La réutilisation d’un ancien jeton d’actualisation met fin à toute la connexion.
• Révocation : https://register.gy/oauth/revoke (RFC 7009). Les clients peuvent aussi déconnecter des applications dans l’Espace client.

Clés API (vos propres scripts et outils)

Créez jusqu’à 5 clés dans l’Espace client. Envoyez-les sous la forme Authorization: Bearer rgy_live_… ou X-API-Key: rgy_live_…. Les clés disposent des deux portées. Elles sont stockées sous forme hachée, et le titulaire reçoit un e-mail lorsqu’une clé est créée.

Serveur MCP

Transport HTTP en streaming (Streamable HTTP), réponses JSON (sans flux d’événements), versions du protocole 2025-06-18, 2025-03-26, 2024-11-05.

REST API

URL de base https://register.gy/wp-json/rgy/v1. JSON en entrée, JSON en sortie. Les erreurs se présentent ainsi : {"error":{"code":"not_found","message":"…"}}.

Corps de la requête de connexion

Soit une liste d’enregistrements, soit le texte brut affiché par votre outil (un tableau ou une liste). Seuls les enregistrements A, AAAA, CNAME (ALIAS) et TXT sont configurés ; tout le reste est listé sous skipped avec la raison.

Copier{
  "records": [
    { "type": "A", "name": "@", "value": "185.158.133.1" },
    { "type": "CNAME", "name": "www", "value": "mysite.netlify.app" }
  ]
}

Limites et erreurs

Sécurité

• Les clés et les jetons sont stockés uniquement sous forme de hachages SHA-256. Les codes de connexion sont à usage unique, expirent au bout de 10 minutes et sont soumis à une limite de fréquence.
• Chaque clé ou connexion ne voit que les domaines du client qui l’a créée.
• Chaque modification effectuée via l’API est journalisée et peut être annulée pendant 7 jours. Les enregistrements de site web sont configurés en DNS uniquement, afin que les outils puissent émettre leurs certificats https.
• Vous avez trouvé un problème de sécurité ? Écrivez à [email protected] avec « Security » dans l’objet. Merci de nous laisser le temps de le corriger avant d’en parler à d’autres.

Journal des modifications

• 8 octobre 2026 Connexion OAuth 2.1 (PKCE, enregistrement dynamique des clients, rotation des jetons d’actualisation), applications connectées dans l’Espace client, point de terminaison MCP public limité à la recherche.
• 8 octobre 2026 Lancement de l’API REST et du serveur MCP : disponibilité, domaines, enregistrements, aperçu/application/annulation de connexion, vérification de mise en ligne. Clés API dans l’Espace client.

Assistance et conditions

Questions, idées ou demandes de partenariat : [email protected] ou +592-623-1721.

L’utilisation de l’API est régie par notre politique de confidentialité. Des conditions spécifiques à l’API sont en cours de finalisation.