Bouwen met Register.gy

Overzicht

Register.gy is een erkende .gy-domeinregistrar. Het ontwikkelaarsplatform biedt dezelfde tools die klanten in het Klantenportaal gebruiken, zodat een assistent of een app het volgende kan:

• Beschikbaarheid controleren van .gy-, .com.gy-, .co.gy-, .net.gy- en .org.gy-namen, met prijs en een registratielink. Inloggen is niet nodig.
• De domeinen van een klant tonen en hun DNS-records lezen.
• Een website koppelen: stuur de records die een websitebouwer toont (Lovable, Bolt, Replit, v0, Netlify, Shopify…), bekijk een voorbeeld en pas ze daarna toe. Elke wijziging kan 7 dagen lang ongedaan worden gemaakt.
• Controleren of een site live staat: DNS-zichtbaarheid en https.

Het platform is zo ontworpen dat het nooit e-mailrecords (MX) of nameservers wijzigt, geen domeinen verhuist en niet aan betalingen komt. Wijzigingen op registryniveau worden door het Register.gy-team doorgevoerd.

Snel aan de slag

1. Een naam controleren (geen sleutel)

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

2. Een API-sleutel aanmaken

Log in op het Klantenportaal, open API en AI-assistenten en klik op API-sleutel aanmaken. Hij wordt maar één keer getoond.

3. Je domeinen opvragen

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

4. Voorbeeld bekijken en dan een website koppelen

Kopiërencurl -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=…"}]}'

Ziet het voorbeeld er goed uit? Stuur dan dezelfde body naar /connect/apply. Ongedaan maken kan binnen 7 dagen met /connect/undo.

Een AI-assistent koppelen

Register.gy draait een externe MCP-server (de standaardmanier waarop assistenten externe tools gebruiken). Assistenten die inloggen ondersteunen, openen een Register.gy-venster: de klant vult zijn e-mailadres in, typt de 6-cijferige code die we sturen en keurt goed wat de assistent mag doen.

Kopiërenhttps://register.gy/wp-json/rgy/v1/mcp

Kopiërenhttps://register.gy/wp-json/rgy/v1/mcp

Kopiërenclaude mcp add --transport http register-gy https://register.gy/wp-json/rgy/v1/mcp

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

Vraag dan bijvoorbeeld: "Is mybakery.gy beschikbaar?" of "Koppel mijn Lovable-site aan mybakery.gy." De assistent toont de geplande wijzigingen en vraagt toestemming voordat hij ze toepast.

Openbaar endpoint, alleen voor zoeken (zonder inloggen): https://register.gy/wp-json/rgy/v1/mcp/public

Authenticatie

OAuth 2.1 (aanbevolen voor assistenten en apps die door anderen worden gebruikt)

• Authorization code flow met PKCE (alleen S256). Publieke en vertrouwelijke clients.
• Dynamische clientregistratie (RFC 7591) op https://register.gy/oauth/register. Redirect-URI's moeten https zijn, of http op localhost.
• Discovery: /.well-known/oauth-authorization-server (RFC 8414) en /.well-known/oauth-protected-resource (RFC 9728). Het MCP-endpoint beantwoordt niet-geauthenticeerde verzoeken met 401 en een WWW-Authenticate-header die naar de resource-metadata verwijst.
• Access tokens zijn 1 uur geldig; refresh tokens 30 dagen, en die worden bij elk gebruik vervangen. Wie een oud refresh token opnieuw gebruikt, beëindigt de hele verbinding.
• Intrekken: https://register.gy/oauth/revoke (RFC 7009). Klanten kunnen apps ook loskoppelen in het Klantenportaal.

API-sleutels (je eigen scripts en tools)

Maak maximaal 5 sleutels aan in het Klantenportaal. Stuur ze mee als Authorization: Bearer rgy_live_… of X-API-Key: rgy_live_…. Sleutels hebben beide scopes. Ze worden gehasht opgeslagen en de eigenaar krijgt een e-mail wanneer er een wordt aangemaakt.

MCP-server

Streamable HTTP-transport, JSON-antwoorden (geen event stream), protocolversies 2025-06-18, 2025-03-26, 2024-11-05.

REST API

Basis-URL https://register.gy/wp-json/rgy/v1. JSON erin, JSON eruit. Fouten zien eruit als {"error":{"code":"not_found","message":"…"}}.

Body van het connect-verzoek

Een lijst met records, of de ruwe tekst die je websitebouwer toont (een tabel of lijst). Alleen A, AAAA, CNAME (ALIAS) en TXT worden ingesteld; al het andere staat onder skipped, met de reden.

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

Limieten en fouten

Beveiliging

• Sleutels en tokens worden alleen als SHA-256-hashes opgeslagen. Inlogcodes zijn eenmalig, verlopen na 10 minuten en hebben een limiet.
• Elke sleutel of verbinding ziet alleen de domeinen van de klant die hem heeft aangemaakt.
• Elke wijziging via de API wordt gelogd en kan 7 dagen lang ongedaan worden gemaakt. Websiterecords worden als DNS-only ingesteld, zodat websitebouwers hun https-certificaten kunnen uitgeven.
• Een beveiligingsprobleem gevonden? Mail [email protected] met "Security" in het onderwerp. Geef ons de kans het op te lossen voordat je het anderen vertelt.

Wijzigingslogboek

• 8 oktober 2026 Inloggen via OAuth 2.1 (PKCE, dynamische clientregistratie, refresh-rotatie), gekoppelde apps in het Klantenportaal, openbaar MCP-endpoint alleen voor zoeken.
• 8 oktober 2026 REST API en MCP-server gelanceerd: beschikbaarheid, domeinen, records, koppelen met voorbeeld/toepassen/ongedaan maken, live-controle. API-sleutels in het Klantenportaal.

Support en voorwaarden

Vragen, ideeën of verzoeken voor samenwerking: [email protected] of +592-623-1721.

Voor het gebruik van de API geldt ons privacybeleid. Aparte API-voorwaarden worden nog afgerond.