تُعرض هذه الصفحة بلغة جهازك.عرض بالإنجليزية

المطورون

ابنِ باستخدام Register.gy

دَع مساعدي الذكاء الاصطناعي وتطبيقاتك الخاصة يتحققون من نطاقات .gy ويربطونها بالمواقع الإلكترونية. واجهة REST API، وخادم MCP لـ Claude وChatGPT وCursor، وتسجيل دخول عبر OAuth. مجانًا لكل عملاء Register.gy.

نظرة عامة

Register.gy مسجِّل نطاقات .gy معتمد. تتيح منصة المطورين الأدوات نفسها التي يستخدمها العملاء في منطقة العملاء، بحيث يمكن لمساعد أو تطبيق أن:

  • يتحقق من توفر أسماء .gy و.com.gy و.co.gy و.net.gy و.org.gy، مع السعر ورابط التسجيل. دون الحاجة إلى تسجيل الدخول.
  • يعرض نطاقات العميل ويقرأ سجلات DNS الخاصة بها.
  • يربط موقعًا إلكترونيًا: يرسل السجلات التي تعرضها منصة إنشاء المواقع (Lovable وBolt وReplit وv0 وNetlify وShopify…)، ويحصل على معاينة، ثم يطبّقها. يمكن التراجع عن كل تغيير خلال 7 أيام.
  • يتحقق من أن الموقع يعمل: ظهور DNS وhttps.

صُممت المنصة بحيث لا تغيّر أبدًا سجلات البريد الإلكتروني (MX) أو خوادم الأسماء، ولا تنقل النطاقات ولا تتعامل مع المدفوعات. يطبّق فريق Register.gy التغييرات على مستوى السجل.

عنوان URL الأساسي لـ RESThttps://register.gy/wp-json/rgy/v1
خادم MCPhttps://register.gy/wp-json/rgy/v1/mcp
OpenAPIhttps://register.gy/wp-json/rgy/v1/openapi.json
بيانات OAuth الوصفيةhttps://register.gy/.well-known/oauth-authorization-server
ملخص لأدوات الذكاء الاصطناعيhttps://register.gy/llms.txt

البدء السريع

1. تحقق من اسم (دون مفتاح)

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

2. أنشئ مفتاح API

سجّل الدخول إلى منطقة العملاء، وافتح API ومساعدو الذكاء الاصطناعي وانقر على إنشاء مفتاح API. يُعرض مرة واحدة فقط.

3. اعرض نطاقاتك

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

4. عاين، ثم اربط موقعًا

curl -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=…"}]}'

إذا بدت المعاينة صحيحة، فأرسل المحتوى نفسه إلى /connect/apply. تراجع باستخدام /connect/undo خلال 7 أيام.

ربط مساعد ذكاء اصطناعي

يشغّل Register.gy خادم MCP عن بُعد (الطريقة المعيارية التي تستخدم بها المساعدات أدوات خارجية). المساعدات التي تدعم تسجيل الدخول ستفتح نافذة Register.gy: يُدخل العميل بريده الإلكتروني، ويكتب الرمز المكوّن من 6 أرقام الذي نرسله، ويوافق على ما يُسمح للمساعد بفعله.

Claude

أضف موصلًا مخصصًا (custom connector) بهذا العنوان، ثم سجّل الدخول:

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

ChatGPT

حيث يتيح لك ChatGPT إضافة موصل أو تطبيق مخصص (وضع المطور)، استخدم العنوان نفسه واختر تسجيل الدخول عبر OAuth:

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

Claude Code

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

ثم شغّل /mcp في Claude Code لتسجيل الدخول. أو تخطَّ تسجيل الدخول باستخدام مفتاح: أضف --header "Authorization: Bearer rgy_live_YOUR_KEY".

Cursor وعملاء MCP الآخرون

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

يمكن للعملاء الذين يدعمون OAuth حذف headers وتسجيل الدخول بدلًا من ذلك.

ثم اسأل مثلًا: "Is mybakery.gy available?" أو "Connect my Lovable site to mybakery.gy." يعرض المساعد التغييرات المخطط لها ويستأذنك قبل تطبيقها.

نقطة نهاية عامة للبحث فقط (دون تسجيل دخول): https://register.gy/wp-json/rgy/v1/mcp/public

المصادقة

OAuth 2.1 (موصى به للمساعدات والتطبيقات التي يستخدمها أشخاص آخرون)

  • تدفق رمز التفويض (Authorization code) مع PKCE (S256 فقط). للعملاء العامين والسريين.
  • التسجيل الديناميكي للعملاء (RFC 7591) على https://register.gy/oauth/register. يجب أن تكون عناوين إعادة التوجيه (Redirect URIs) بـ https، أو http على localhost.
  • الاكتشاف: /.well-known/oauth-authorization-server (RFC 8414) و/.well-known/oauth-protected-resource (RFC 9728). تردّ نقطة نهاية MCP على الطلبات غير المصادَق عليها بـ 401 وترويسة WWW-Authenticate تشير إلى البيانات الوصفية للمورد.
  • تدوم رموز الوصول (access tokens) ساعة واحدة؛ ورموز التحديث (refresh tokens) 30 يومًا وتتجدد مع كل استخدام. إعادة استخدام رمز تحديث قديم تُنهي الاتصال بالكامل.
  • الإبطال: https://register.gy/oauth/revoke (RFC 7009). يمكن للعملاء أيضًا فصل التطبيقات من منطقة العملاء.
النطاق (Scope)يسمح بـ
domains:readSee your .gy domains and their DNS records
websites:writeConnect your websites (change website records only, with 7-day undo)

مفاتيح API (لبرامجك النصية وأدواتك الخاصة)

أنشئ ما يصل إلى 5 مفاتيح في منطقة العملاء. أرسلها بصيغة Authorization: Bearer rgy_live_… أو X-API-Key: rgy_live_…. تملك المفاتيح كلا النطاقين (scopes). تُخزَّن مُجزّأة (hashed)، ويُرسَل بريد إلكتروني إلى المالك عند إنشاء أي مفتاح.

خادم MCP

نقل Streamable HTTP، واستجابات JSON (دون تدفق أحداث)، وإصدارات البروتوكول 2025-06-18, 2025-03-26, 2024-11-05.

الأداةوظيفتهاهل تغيّر البيانات؟
search_domainCheck whether a .gy domain (.gy, .com.gy, .co.gy, .net.gy or .org.gy) is available at Register.gy, with the yearly price and a link to register it.لا
notify_when_registration_reopensUse only when search_domain says new .gy registrations are paused. Adds the user to Register.gy's notify list: Register.gy checks the domain again and emails them a link to register it as soon as registration reopens (usually within about an hour). Only call with the user's permission and their own email address.نعم، بعد التأكيد
list_my_domainsList the user's .gy domains at Register.gy, with expiry date and whether each can be connected to a website now.لا
get_dns_recordsShow the current DNS records of one of the user's .gy domains.لا
connect_websitePoint one of the user's .gy domains at their website by setting the DNS records their website builder (Lovable, Bolt, Replit, v0/Vercel, Netlify, Webflow, Shopify…) shows on its custom-domain screen. Use the builder's real values, never guesses. ALWAYS call with apply=false first and show the user the preview; call again with apply=true only after the user clearly confirms. Email (MX) and nameserver records are never changed. The change can be undone for 7 days.نعم، بعد التأكيد
check_liveCheck whether the website records of a .gy domain are visible on the internet and whether https works yet.لا
undo_last_changePut back the website records that were in place before the last connect_website change on this domain (available for 7 days). Ask the user first.نعم، بعد التأكيد

REST API

عنوان URL الأساسي https://register.gy/wp-json/rgy/v1. إدخال JSON وإخراج JSON. تبدو الأخطاء هكذا: {"error":{"code":"not_found","message":"…"}}.

الطريقة (Method)المسارالوصفالمصادقة
GET/availabilityIs a .gy domain available?لا شيء
GET/statusAre .gy registrations open or paused right now?لا شيء
POST/notifyWhile registrations are paused: email me when they reopenلا شيء
GET/healthService status for uptime monitorsلا شيء
GET/meWho this key belongs toمفتاح أو رمز وصول
GET/domainsYour .gy domainsمفتاح أو رمز وصول
GET/domains/{domain}One domainمفتاح أو رمز وصول
GET/domains/{domain}/recordsCurrent DNS recordsمفتاح أو رمز وصول
POST/domains/{domain}/connect/previewPreview connecting a website (changes nothing)مفتاح أو رمز وصول
POST/domains/{domain}/connect/applyConnect a website (after the user confirms the preview)مفتاح أو رمز وصول
POST/domains/{domain}/connect/undoUndo the last connectمفتاح أو رمز وصول
GET/domains/{domain}/liveIs the site live (DNS + https)?مفتاح أو رمز وصول
POST/mcpMCP endpoint for AI assistants (JSON-RPC 2.0, Streamable HTTP)مفتاح أو رمز وصول

محتوى طلب الربط

إما قائمة بالسجلات، أو النص الخام الذي تعرضه منصتك (جدول أو قائمة). لا يُضبط إلا A وAAAA وCNAME (ALIAS) وTXT؛ وأي شيء آخر يُدرج ضمن skipped مع السبب.

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

الحدود والأخطاء

الطلبات300 لكل مفتاح أو اتصال كل 10 دقائق
التغييرات60 كل 10 دقائق لكل عميل (مشتركة مع منطقة العملاء)
التوفر30 عملية تحقق في الدقيقة لكل عنوان IP
السجلات في كل عملية ربط15
الحالةالمعنى
400طلب غير صالح (توضح الرسالة ما يجب إصلاحه)
401مفتاح أو رمز وصول مفقود أو غير صالح أو منتهي الصلاحية
403غير مسموح (مثل اتصال للقراءة فقط يحاول تغيير السجلات، أو نطاق يديره فريقنا)
404ليس في هذا الحساب، أو نقطة نهاية غير معروفة
429طلبات كثيرة جدًا؛ انتظر ثم أعد المحاولة
503إحدى الخدمات المعتمَد عليها (DNS أو التحقق من التوفر) لا تستجيب؛ أعد المحاولة لاحقًا

الأمان

  • تُخزَّن المفاتيح ورموز الوصول بصيغة تجزئة SHA-256 فقط. رموز تسجيل الدخول تُستخدم مرة واحدة، وتنتهي صلاحيتها خلال 10 دقائق، ويخضع طلبها لحدود معدّل.
  • لا يرى كل مفتاح أو اتصال إلا نطاقات العميل الذي أنشأه.
  • يُسجَّل كل تغيير عبر API ويمكن التراجع عنه خلال 7 أيام. تُضبط سجلات المواقع على وضع DNS فقط حتى تتمكن المنصات من إصدار شهادات https الخاصة بها.
  • هل وجدت مشكلة أمنية؟ راسل [email protected] واكتب "Security" في الموضوع. يُرجى منحنا فرصة لإصلاحها قبل إخبار الآخرين.

سجل التغييرات

  • ٨ أكتوبر ٢٠٢٦ تسجيل الدخول عبر OAuth 2.1 (PKCE، والتسجيل الديناميكي للعملاء، وتجديد رموز التحديث)، والتطبيقات المتصلة في منطقة العملاء، ونقطة نهاية MCP عامة للبحث فقط.
  • ٨ أكتوبر ٢٠٢٦ إطلاق REST API وخادم MCP: التوفر، والنطاقات، والسجلات، ومعاينة الربط/تطبيقه/التراجع عنه، والتحقق من عمل الموقع. مفاتيح API في منطقة العملاء.

الدعم والشروط

للأسئلة أو الأفكار أو طلبات الشراكة: [email protected] أو +592-623-1721.

يخضع استخدام API لـ سياسة الخصوصية الخاصة بنا. يجري حاليًا وضع اللمسات الأخيرة على شروط مخصصة لـ API.