پرش به محتوای اصلی
همه چیز در حال کار است
ایران‌کلاد
ورود ثبت‌نام
آغاز محتوای اصلی
بازگشت به مستندات

dns

9 endpoint

GET /api/v1/dns/zones scope: dns:read

List your DNS zones (domains)

پارامترهای Query
  • limit — Max items (1-200, default 50)
  • offset — Skip first N items
پاسخ‌ها
  • 200 — List of zones
  • 401 — Missing or invalid token
نمونه cURL 
curl -X GET -H "Authorization: Bearer ic_pat_…" \
  https://iranclaud.ir/api/v1/dns/zones
POST /api/v1/dns/zones scope: dns:write

Create a DNS zone for a domain

بدنه درخواست (JSON) 
{
    "domain": "example.com"
}
پاسخ‌ها
  • 201 — Zone created; assign the returned nameservers at your registrar
  • 409 — Zone already exists
  • 422 — Invalid domain
نمونه cURL 
curl -X POST -H "Authorization: Bearer ic_pat_…" \
  -H "Content-Type: application/json" \
    -d '{"domain":"example.com"}' \
  https://iranclaud.ir/api/v1/dns/zones
GET /api/v1/dns/zones/{uuid} scope: dns:read

Get a DNS zone

پارامترهای مسیر
  • uuid — Zone UUID
پاسخ‌ها
  • 200 — Zone detail
  • 404 — Not found
نمونه cURL 
curl -X GET -H "Authorization: Bearer ic_pat_…" \
  https://iranclaud.ir/api/v1/dns/zones/{uuid}
GET /api/v1/dns/zones/{uuid}/export scope: dns:read

Export a zone as a BIND zonefile (for backup/automation)

پارامترهای مسیر
  • uuid — Zone UUID
پاسخ‌ها
  • 200 — BIND zonefile
نمونه cURL 
curl -X GET -H "Authorization: Bearer ic_pat_…" \
  https://iranclaud.ir/api/v1/dns/zones/{uuid}/export
DELETE /api/v1/dns/zones/{uuid} scope: dns:write

Delete a DNS zone

پارامترهای مسیر
  • uuid — Zone UUID
پاسخ‌ها
  • 204 — Deleted
  • 404 — Not found
نمونه cURL 
curl -X DELETE -H "Authorization: Bearer ic_pat_…" \
  https://iranclaud.ir/api/v1/dns/zones/{uuid}
GET /api/v1/dns/zones/{uuid}/records scope: dns:read

List records in a zone (subdomains)

پارامترهای مسیر
  • uuid — Zone UUID
پارامترهای Query
  • type — Filter by record type: A|AAAA|CNAME|MX|TXT|NS|SRV|CAA
پاسخ‌ها
  • 200 — Records
نمونه cURL 
curl -X GET -H "Authorization: Bearer ic_pat_…" \
  https://iranclaud.ir/api/v1/dns/zones/{uuid}/records
POST /api/v1/dns/zones/{uuid}/records scope: dns:write

Add a record (subdomain) to a zone

پارامترهای مسیر
  • uuid — Zone UUID
بدنه درخواست (JSON) 
{
    "type": "A",
    "name": "shop",
    "content": "203.0.113.10",
    "ttl": 3600
}
پاسخ‌ها
  • 201 — Record created
  • 422 — Invalid record
نمونه cURL 
curl -X POST -H "Authorization: Bearer ic_pat_…" \
  -H "Content-Type: application/json" \
    -d '{"type":"A","name":"shop","content":"203.0.113.10","ttl":3600}' \
  https://iranclaud.ir/api/v1/dns/zones/{uuid}/records
PUT /api/v1/dns/zones/{uuid}/records/{rid} scope: dns:write

Update a record

پارامترهای مسیر
  • uuid — Zone UUID
  • rid — Record ID
بدنه درخواست (JSON) 
{
    "content": "203.0.113.20",
    "ttl": 1800
}
پاسخ‌ها
  • 200 — Updated record
نمونه cURL 
curl -X PUT -H "Authorization: Bearer ic_pat_…" \
  -H "Content-Type: application/json" \
    -d '{"content":"203.0.113.20","ttl":1800}' \
  https://iranclaud.ir/api/v1/dns/zones/{uuid}/records/{rid}
DELETE /api/v1/dns/zones/{uuid}/records/{rid} scope: dns:write

Delete a record

پارامترهای مسیر
  • uuid — Zone UUID
  • rid — Record ID
پاسخ‌ها
  • 204 — Deleted
نمونه cURL 
curl -X DELETE -H "Authorization: Bearer ic_pat_…" \
  https://iranclaud.ir/api/v1/dns/zones/{uuid}/records/{rid}