نظرة عامة
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 الأساسي لـ REST | https://register.gy/wp-json/rgy/v1 |
|---|---|
| خادم MCP | https://register.gy/wp-json/rgy/v1/mcp |
| OpenAPI | https://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/mcpChatGPT
حيث يتيح لك ChatGPT إضافة موصل أو تطبيق مخصص (وضع المطور)، استخدم العنوان نفسه واختر تسجيل الدخول عبر OAuth:
https://register.gy/wp-json/rgy/v1/mcpClaude 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:read | See your .gy domains and their DNS records |
websites:write | Connect 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_domain | Check 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_reopens | Use 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_domains | List the user's .gy domains at Register.gy, with expiry date and whether each can be connected to a website now. | لا |
get_dns_records | Show the current DNS records of one of the user's .gy domains. | لا |
connect_website | Point 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_live | Check whether the website records of a .gy domain are visible on the internet and whether https works yet. | لا |
undo_last_change | Put 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 | /availability | Is a .gy domain available? | لا شيء |
| GET | /status | Are .gy registrations open or paused right now? | لا شيء |
| POST | /notify | While registrations are paused: email me when they reopen | لا شيء |
| GET | /health | Service status for uptime monitors | لا شيء |
| GET | /me | Who this key belongs to | مفتاح أو رمز وصول |
| GET | /domains | Your .gy domains | مفتاح أو رمز وصول |
| GET | /domains/{domain} | One domain | مفتاح أو رمز وصول |
| GET | /domains/{domain}/records | Current DNS records | مفتاح أو رمز وصول |
| POST | /domains/{domain}/connect/preview | Preview connecting a website (changes nothing) | مفتاح أو رمز وصول |
| POST | /domains/{domain}/connect/apply | Connect a website (after the user confirms the preview) | مفتاح أو رمز وصول |
| POST | /domains/{domain}/connect/undo | Undo the last connect | مفتاح أو رمز وصول |
| GET | /domains/{domain}/live | Is the site live (DNS + https)? | مفتاح أو رمز وصول |
| POST | /mcp | MCP 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.