توثيق API

استخدم نقاط نهاية موثوقة ومنخفضة زمن الاستجابة في تطبيقاتك.

API الوقت

الحصول على الوقت الحالي بعدة تنسيقات.

https://api.c.nf/time
التنسيق: ISO 8601
نوع الاستجابة: JSON
📅

API الطابع الزمني

الحصول على طابع Unix الزمني الحالي لقياس الوقت بدقة.

https://api.c.nf/timestamp
التنسيق: Unix Timestamp
نوع الاستجابة: JSON
🌐

API عنوان IP

الحصول على عنوان IP للعميل الذي أرسل الطلب.

https://api.c.nf/ip
التنسيق: IPv4/IPv6
نوع الاستجابة: Plain Text
🗺️

API الموقع الجغرافي لعنوان IP

الحصول على بيانات موقع تقريبية لعنوان IP.

https://api.c.nf/ip-geolocation
التنسيق: Country Code
نوع الاستجابة: JSON
💱

API أسعار الصرف

الحصول على أسعار صرف العملات الحالية. عملة الأساس اختيارية وتكون USD افتراضيًا.

https://api.c.nf/fx/rate?base=CNY
التنسيق: Currency Pairs
نوع الاستجابة: JSON
v1

API إدارة DNS ‏(v1)

إدارة مناطق DNS وسجلاتها على c.nf باستخدام مصادقة رمز Bearer وعزل صارم لكل مستخدم.

https://api.c.nf/v1
التنسيق: REST
نوع الاستجابة: JSON

بدء الاستخدام

نقاط نهاية الأدوات العامة، مثل الوقت وعنوان IP وأسعار الصرف، مجانية ولا تتطلب مصادقة.

تتطلب واجهة إدارة DNS عند /v1 رمز Bearer من الحساب ← مفاتيح API. ولا يمكن للرمز الوصول إلا إلى مناطق DNS التي تحقّق مالكه من ملكيتها.

نقطة نهاية عامة

fetch('https://api.c.nf/time')
  .then(response => response.json())
  .then(data => console.log(data));

نقطة نهاية DNS v1 مصادَق عليها

fetch('https://api.c.nf/v1/dns/zones', {
  headers: { 'Authorization': 'Bearer cnf_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx' }
})
  .then(r => r.json())
  .then(data => console.log(data));