Ry.hk Ry.hk

API

إدارة النطاقات من برنامج بدلاً من صفحة في المرة الواحدة.

التسجيل الإلكتروني، والتحقق من التوفر، وDNS، والإدارة في أنظمتك الخاصة: الطلب بالجملة، وعمليات المسح للتجديد، ولوحة تحكم لعملائك.

إن API هو نقطة دخول الجهاز إلى نفس العمليات التي توفرها منطقة العميل. ما يمكنك فعله على الصفحة، يمكنك كتابته.

استراحة HTTPS مع استجابات JSON
مفاتيح API تم إنشاؤها وإبطالها في منطقة العميل
تغطية كاملة نفس العمليات مثل منطقة العميل
قابلة للتدقيق يتم تسجيل المكالمات على الحساب

ما هو عليه

  • يتم تجميع نقاط النهاية حسب المورد - التوفر، والنطاقات، وخوادم الأسماء، وجهات الاتصال، والطلبات، والفواتير - وإرجاع JSON.
  • تستخدم المصادقة مفتاح API الذي تم إنشاؤه في منطقة العميل، والذي يمكن إبطاله واستبداله في أي وقت.
  • الاستخدامات النموذجية: التسجيل المجمع، وعمليات مسح انتهاء الصلاحية، ومزامنة حالة النطاق في نظامك الخاص، ولوحة الخدمة الذاتية للعملاء، وسير عمل الشهادات الآلية.
  • تنطبق نفس قواعد العمل كما هو الحال على الويب: لا يمكن تسجيل النطاق من فراغ، ولا تزال عملية النقل بحاجة إلى نطاق غير مؤمّن وأيام 60.

كيف يعمل

01

قم بإنشاء مفتاح

قم بإنشاء مفتاح API في منطقة العميل، مع تحديد نطاق ما يجب القيام به.

02

اقرأ الوثائق

نقاط النهاية والمعلمات وأشكال الاستجابة.

03

اختبار صغير

جرّب نقاط النهاية للقراءة فقط، أو بعض النطاقات، قبل التشغيل الآلي.

04

بدء البث المباشر مع التسجيل

قم بإضافة عمليات إعادة المحاولة والتسجيل قبل أن تصل إلى مرحلة الإنتاج.

التوفر والبحث

تحقق من العديد من الأسماء مرة واحدة للمراقبة والاختيار.

التسجيل والتجديد

الطلب والتجديد وقراءة حالة الطلب.

DNS وخوادم الأسماء

دفع السجلات وتغييرات خادم الأسماء بشكل جماعي.

إدارة الاتصال

قراءة وتحديث المسجل والمسؤول والتكنولوجيا والفواتير.

الطلبات والفواتير

قراءة الطلبات والفواتير وحالة الدفع.

دوران المفتاح

إبطال واستبدال المفاتيح؛ إبقاء كل نظام على مفتاحه الخاص.

ما يغطيه API

حسب الموارد

المواردما يمكنك القيام به
النطاقاتالتحقق من التوفر والتسجيل والتجديد وقراءة الحالة وانتهاء الصلاحية
DNSقراءة وتعيين خوادم الأسماء، والحفاظ على سجلات DNS
الخصوصية والاتصالاتقم بتعيين مستوى الخصوصية، وقم بتحديث جميع أدوار جهات الاتصال الأربعة
الطلبات والفواتيرقراءة الطلبات والفواتير وحالة الدفع
حساباقرأ الرصيد وتفاصيل الحساب الأساسية

ما يجب أن يكون في مكانه قبل الاتصال

أربعة أشياء صغيرة توفر معظم عمليات التصحيح

  • الرصيد أو طريقة الدفع العاملة: التسجيل والتجديد عبارة عن طلبات حقيقية، وستفشل المكالمة في خطوة الطلب بدون أموال.
  • إعادة المحاولات ومعالجة الأخطاء: تحدث تقلبات الشبكة وحدود المعدلات والتأخيرات الأولية. إعادة محاولة القراءات العاجزة؛ للطلبات، أرسل مرجعًا فريدًا وتحقق قبل الكتابة مرة أخرى.
  • التسجيل: سجل المرجع والنطاق ورمز الاستجابة. عندما يتم الاعتراض على شيء ما لاحقًا، فإن هذه السجلات هي الدليل الوحيد على حدوث الإجراء.
  • الامتياز الأقل: لا تستخدم مفتاحًا قابلاً للكتابة لمهمة للقراءة فقط، وأعط كل نظام مفتاحه الخاص بحيث يمكن إبطال أحد المفاتيح دون تعطيل الآخرين.

مفتاح API يعادل كلمة مرور الحساب. احتفظ بها في متغير البيئة من جانب الخادم أو مدير الأسرار، وليس في كود الواجهة الأمامية أبدًا، ولا في المستودع أبدًا.

كيف يستخدمه الناس

الأنماط الشائعة

  • المسجل المجمع: قم بإرسال تحديد للتسجيل ثم قم بكتابة النتائج مرة أخرى في الواجهة الخلفية الخاصة بك.
  • عمليات التجديد: اسحب النطاقات التي تقترب من انتهاء الصلاحية كل ليلة وقم برفع مهام التذكير أو التجديد الخاصة بك.
  • لوحات العلامات البيضاء: اسمح لعملائك بإدارة النطاقات داخل منتجك، دون تسجيل الدخول هنا.
  • التسوية: اسحب بيانات النطاق واطلبها وفقًا لجدول زمني وقم بمطابقتها مع دفتر الأستاذ الخاص بك.

ما يتضمنه كل أمر

إدارة المفاتيح API

إنشاء وإلغاء وفصل المفاتيح حسب الغرض.

التوثيق

نقاط النهاية والمعلمات والاستجابات.

النطاق ونقاط النهاية DNS

بحث، تسجيل، تجديد، DNS وخوادم الأسماء.

نقاط النهاية للطلب والفواتير

الطلبات والفواتير وحالة الدفع.

سجل المكالمات

تم تسجيله ضد الحساب لاستكشاف الأخطاء وإصلاحها.

الدعم

افتح تذكرة إذا حدث خطأ في عملية التكامل.

الأسئلة الشائعة

هل هناك رسوم إضافية على API؟

لا يتم شحن API نفسه بشكل منفصل؛ أنت تدفع مقابل العمليات التجارية التي تقوم بها. هناك حد معقول للمعدل لمنع الاستخدام العرضي أو المسيء.

هل هناك SDK؟

إن API هو HTTPS وJSON القياسي، لذا فإن أي عميل HTTP يعمل. تتضمن الوثائق أمثلة للطلبات التي يمكن تعديلها مباشرة.

ماذا لو تسرب المفتاح؟

قم بإلغائها في منطقة العميل وإنشاء واحدة جديدة. يصبح الإلغاء ساري المفعول على الفور ويتم رفض الطلبات التي تستخدم المفتاح القديم.

هل الاختبار يكلف شيئا؟

المكالمات للقراءة فقط لا تكلف شيئًا. التسجيل والتجديد عبارة عن أوامر حقيقية وتكلف أموالاً، لذا تحقق من صحة المنطق على عدد صغير من النطاقات أولاً.

هل يستطيع API إدارة النطاقات المسجلة في مكان آخر؟

لا، فهو يعمل على النطاقات الموجودة في هذا الحساب، تمامًا كما تفعل منطقة العميل.

يرجى الملاحظة

  • احتفظ بمفاتيح API على الخادم. المفتاح الذي يتم شحنه في رمز المتصفح أو حزمة الهاتف المحمول هو مفتاح منشور.
  • لطلب نقاط النهاية، أرسل مرجع طلب فريدًا وتحقق قبل الكتابة، حتى لا يتم تسجيل إعادة محاولة الشبكة أو فرض رسوم عليها مرتين.

هل أنت مستعد للبدء؟

افتح الصفحة الخاصة بهذه الخدمة وقم بإنهائها ببضع خطوات. إذا كنت تفضل السؤال أولاً، تصل التذكرة إلى الشخص.