توثيق API

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

PUB

خدمات عامة

نقاط صغيرة موثوقة لا تحتاج حسابًا: الوقت والعنوان والبلد وأسعار الصرف والبصمات.

GET /v1/public/time
GET /v1/public/timestamp
GET /v1/public/ip
GET /v1/public/geo
GET /v1/public/fx
GET /v1/public/hash
نقاط النهاية: ٦
النطاق: عام
جرّب الآن
ME

الحساب

لمن يعود الرمز، وما الذي يسمح به.

GET /v1/account/me
GET /v1/account/sessions
POST /v1/account/sessions/revoke
POST /v1/account/sessions/revoke-all
POST /v1/account/profile
نقاط النهاية: ٥
النطاق: Bearer
المرجع
DNS

DNS

طالِب بنطاق، وأثبت أنك تتحكم فيه، ثم أدر سجلاته.

GET /v1/dns/zones
POST /v1/dns/zones
GET /v1/dns/zones/{zone}
POST /v1/dns/zones/{zone}/verify
DELETE /v1/dns/zones/{zone}
GET /v1/dns/zones/{zone}/records
POST /v1/dns/zones/{zone}/records
GET /v1/dns/zones/{zone}/records/{id}
PATCH /v1/dns/zones/{zone}/records/{id}
DELETE /v1/dns/zones/{zone}/records/{id}
نقاط النهاية: ١٠
النطاق: Bearer
المرجع
KEY

بيانات الاعتماد

مخزن بيانات الاعتماد الخاص وراء أداة بيانات الاعتماد.

GET /v1/cred
POST /v1/cred
نقاط النهاية: ٢
النطاق: Bearer
المرجع
FILE

الملفات

تخزين شخصي للملفات: عرض ورفع وتحرير ومشاركة وحذف.

GET /v1/files
GET /v1/files/{id}
GET /v1/files/download
POST /v1/files/upload
POST /v1/files/update
POST /v1/files/rename
POST /v1/files/delete
POST /v1/files/upload-chunk
POST /v1/files/upload-finalize
نقاط النهاية: ٩
النطاق: Bearer
المرجع
API

CDN

التخزين المؤقت على الحافة وحركة البيانات لملفاتك المشتركة.

GET /v1/cdn/stats
POST /v1/cdn/config
POST /v1/cdn/purge
نقاط النهاية: ٣
النطاق: Bearer
المرجع
API

تحويل الرسائل

الرسائل المُحوَّلة من هاتفك، والمفاتيح التي تسمح بها.

GET /v1/sms/messages
GET /v1/sms/keys
POST /v1/sms/keys
DELETE /v1/sms/keys
نقاط النهاية: ٤
النطاق: Bearer
المرجع
API

المواقع الثابتة

ارفع ملف zip واحصل على موقع.

GET /v1/sites
POST /v1/sites/deploy
POST /v1/sites/delete
نقاط النهاية: ٣
النطاق: Bearer
المرجع
API

عمليات النشر

نقاط النماذج وWebhook والروابط المختصرة التي نشرتها.

GET /v1/deployments
POST /v1/deployments/toggle
POST /v1/deployments/delete
نقاط النهاية: ٣
النطاق: Bearer
المرجع
API

النطاقات

محفظة نطاقاتك وبيانات تسجيلها.

GET /v1/domains
POST /v1/domains/whois-sync
نقاط النهاية: ٢
النطاق: Bearer
المرجع
PKG

الحزم

انشر الإصدارات واقرأ نسخها وأعداد تنزيلاتها.

GET /v1/packages
GET /v1/packages/{slug}
POST /v1/packages/publish
POST /v1/packages/update
POST /v1/packages/delete
نقاط النهاية: ٥
النطاق: Bearer
المرجع
WHO

WHOIS

بيانات تسجيل النطاق، مخزّنة مؤقتًا ومشتركة مع أدوات النطاقات.

GET /v1/whois
نقاط النهاية: ١
النطاق: Bearer
المرجع

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

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

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

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

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

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

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

لوكلاء الذكاء الاصطناعي

وجِّه الوكيل إلى /v1/ai للحصول على ملخص مكتوب ليُلصق مباشرة في المُوجّه، أو إلى /v1/ai?format=json للحصول على النقاط نفسها كتعريفات أدوات. و/v1/openapi.json هو عقد OpenAPI 3.1 الكامل، و/llms.txt خريطة للزواحف. الأربعة تُولَّد من جدول المسارات نفسه الذي تستخدمه هذه الصفحة، فلا يمكن لأي منها أن يصف نقطة غير موجودة.