النطاقات

إدارة النطاقات والتحقق وحالة DNS ومفاتيح الإعداد ومساحات عمل النطاق. تستخدم الأمثلة وضع الكود في A2A. يتيح MCP وضع الكود نفسه عبر أداة execute.

الوظائف

`domains.delete`

domains.delete(account_id: str, domain: str) -> {}

النطاقات: domains.delete.

الخاصية	القيمة	الخاصية	القيمة
الإذن المطلوب	`domain.delete`	المصادقة مطلوبة	`نعم`
وضع التنفيذ	`sync`	الصلاحية	`domain.delete`
نوع المورد	`account`	حقل معرف المورد	`account_id`
مسار API العام	`DELETE /v1/public/accounts/{account_id}/domains/{domain}`

الوسيطات

الاسم	النوع	مطلوب
`account_id`	`str`	نعم
`domain`	`str`	نعم

القيم المرجعة

الحقل	النوع	مطلوب
`result`	`{}`	نعم

مثال A2A

الطلب:

{
  "request_id": "example",
  "session_id": "session_123",
  "code": "domains.delete(account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", domain=\"example.com\")"
}

الاستجابة:

{
  "request_id": "example",
  "status": "completed",
  "result": {
    "last_value": {}
  },
  "responses": [
    {
      "index": 0,
      "function": "domains.delete",
      "status": "completed",
      "result": {}
    }
  ],
  "complexity_score": 1
}

مثال MCP

الطلب:

{
  "jsonrpc": "2.0",
  "id": "example",
  "method": "tools/call",
  "params": {
    "name": "hybridbox_execute",
    "arguments": {
      "code": "domains.delete(account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", domain=\"example.com\")"
    }
  }
}

الاستجابة:

{
  "jsonrpc": "2.0",
  "id": "example",
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{\n  \"request_id\": \"example\",\n  \"status\": \"completed\",\n  \"result\": {\n    \"last_value\": {}\n  },\n  \"responses\": [\n    {\n      \"index\": 0,\n      \"function\": \"domains.delete\",\n      \"status\": \"completed\",\n      \"result\": {}\n    }\n  ],\n  \"complexity_score\": 1\n}"
      }
    ],
    "isError": false
  }
}

`domains.get`

domains.get(account_id: str, domain: str) -> Domain

النطاقات: domains.get.

الخاصية	القيمة	الخاصية	القيمة
الإذن المطلوب	`domain.view`	المصادقة مطلوبة	`نعم`
وضع التنفيذ	`sync`	الصلاحية	`domain.view`
نوع المورد	`account`	حقل معرف المورد	`account_id`
مسار API العام	`GET /v1/public/accounts/{account_id}/domains/{domain}`

الوسيطات

الاسم	النوع	مطلوب
`account_id`	`str`	نعم
`domain`	`str`	نعم

القيم المرجعة

الحقل	النوع	مطلوب
`id`	`str`	نعم
`name`	`str`	نعم
`outbound_routing_ready`	`bool`	نعم
`status`	`str`	نعم
`workspace_id`	`str`	نعم
`auto_renew`	`bool`	لا
`created_at`	`str \| null`	لا
`dedicated_ip_id`	`str \| null`	لا
`dns_records`	`[{"id": int, "name": str, "ttl": int, "type": str, "value": str, "is_system_managed"?: bool, "priority"?: int \| null}]`	لا
`inbound_tenant_external_id`	`str \| null`	لا
`inbound_tenant_id`	`str \| null`	لا
`inbound_tenant_name`	`str \| null`	لا
`inbound_tenant_type`	`str \| null`	لا
`mailboxes`	`[{"active": bool, "email": str, "first_name": str, "id": str, "last_name": str}]`	لا
`redirect_mode`	`"301" \| "302" \| "iframe" \| null`	لا
`redirect_url`	`str \| null`	لا
`tags`	`[{"id": str, "name": str}]`	لا
`updated_at`	`str \| null`	لا

مثال A2A

الطلب:

{
  "request_id": "example",
  "session_id": "session_123",
  "code": "domains.get(account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", domain=\"example.com\")"
}

الاستجابة:

{
  "request_id": "example",
  "status": "completed",
  "result": {
    "last_value": true
  },
  "responses": [
    {
      "index": 0,
      "function": "domains.get",
      "status": "completed",
      "result": true
    }
  ],
  "complexity_score": 1
}

مثال MCP

الطلب:

{
  "jsonrpc": "2.0",
  "id": "example",
  "method": "tools/call",
  "params": {
    "name": "hybridbox_execute",
    "arguments": {
      "code": "domains.get(account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", domain=\"example.com\")"
    }
  }
}

الاستجابة:

{
  "jsonrpc": "2.0",
  "id": "example",
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{\n  \"request_id\": \"example\",\n  \"status\": \"completed\",\n  \"result\": {\n    \"last_value\": true\n  },\n  \"responses\": [\n    {\n      \"index\": 0,\n      \"function\": \"domains.get\",\n      \"status\": \"completed\",\n      \"result\": true\n    }\n  ],\n  \"complexity_score\": 1\n}"
      }
    ],
    "isError": false
  }
}

`domains.health`

domains.health(account_id: str, domain: str, refresh?: bool) -> Domain

النطاقات: domains.health.

الخاصية	القيمة	الخاصية	القيمة
الإذن المطلوب	`domain.view`	المصادقة مطلوبة	`نعم`
وضع التنفيذ	`sync`	الصلاحية	`domain.view`
نوع المورد	`account`	حقل معرف المورد	`account_id`
مسار API العام	`GET /v1/public/accounts/{account_id}/domains/{domain}/health`

الوسيطات

الاسم	النوع	مطلوب
`account_id`	`str`	نعم
`domain`	`str`	نعم
`refresh`	`bool`	لا

القيم المرجعة

الحقل	النوع	مطلوب
`cache_ttl_seconds`	`int`	نعم
`cached`	`bool`	نعم
`checked_at`	`str`	نعم
`checks`	{"dns": {"status": "healthy" \| "warning" \| "critical" \| "unknown", "a"?: {"status": "healthy" \| "warning" \| "critical" \| "unknown", "actual"?: [str] \| null, "code"?: str \| null, "days_remaining"?: int \| null, "error"?: str \| null, "expected"?: [str] \| null, "expires_at"?: str \| null, "issuer"?: str \| null, "record"?: str \| null, "records"?: [str] \| null, "status_code"?: int \| null} \| null, "dkim"?: {"status": "healthy" \| "warning" \| "critical" \| "unknown", "actual"?: [str] \| null, "code"?: str \| null, "days_remaining"?: int \| null, "error"?: str \| null, "expected"?: [str] \| null, "expires_at"?: str \| null, "issuer"?: str \| null, "record"?: str \| null, "records"?: [str] \| null, "status_code"?: int \| null} \| null, "dmarc"?: {"status": "healthy" \| "warning" \| "critical" \| "unknown", "actual"?: [str] \| null, "code"?: str \| null, "days_remaining"?: int \| null, "error"?: str \| null, "expected"?: [str] \| null, "expires_at"?: str \| null, "issuer"?: str \| null, "record"?: str \| null, "records"?: [str] \| null, "status_code"?: int \| null} \| null, "error"?: str \| null, "mx"?: {"status": "healthy" \| "warning" \| "critical" \| "unknown", "actual"?: [str] \| null, "code"?: str \| null, "days_remaining"?: int \| null, "error"?: str \| null, "expected"?: [str] \| null, "expires_at"?: str \| null, "issuer"?: str \| null, "record"?: str \| null, "records"?: [str] \| null, "status_code"?: int \| null} \| null, "ns"?: {"status": "healthy" \| "warning" \| "critical" \| "unknown", "actual"?: [str] \| null, "code"?: str \| null, "days_remaining"?: int \| null, "error"?: str \| null, "expected"?: [str] \| null, "expires_at"?: str \| null, "issuer"?: str \| null, "record"?: str \| null, "records"?: [str] \| null, "status_code"?: int \| null} \| null, "spf"?: {"status": "healthy" \| "warning" \| "critical" \| "unknown", "actual"?: [str] \| null, "code"?: str \| null, "days_remaining"?: int \| null, "error"?: str \| null, "expected"?: [str] \| null, "expires_at"?: str \| null, "issuer"?: str \| null, "record"?: str \| null, "records"?: [str] \| null, "status_code"?: int \| null} \| null}, "ports": {"status": "healthy" \| "warning" \| "critical" \| "unknown", "error"?: str \| null, "imap_143"?: {"status": "healthy" \| "warning" \| "critical" \| "unknown", "actual"?: [str] \| null, "code"?: str \| null, "days_remaining"?: int \| null, "error"?: str \| null, "expected"?: [str] \| null, "expires_at"?: str \| null, "issuer"?: str \| null, "record"?: str \| null, "records"?: [str] \| null, "status_code"?: int \| null} \| null, "imaps_993"?: {"status": "healthy" \| "warning" \| "critical" \| "unknown", "actual"?: [str] \| null, "code"?: str \| null, "days_remaining"?: int \| null, "error"?: str \| null, "expected"?: [str] \| null, "expires_at"?: str \| null, "issuer"?: str \| null, "record"?: str \| null, "records"?: [str] \| null, "status_code"?: int \| null} \| null, "smtp_25"?: {"status": "healthy" \| "warning" \| "critical" \| "unknown", "actual"?: [str] \| null, "code"?: str \| null, "days_remaining"?: int \| null, "error"?: str \| null, "expected"?: [str] \| null, "expires_at"?: str \| null, "issuer"?: str \| null, "record"?: str \| null, "records"?: [str] \| null, "status_code"?: int \| null} \| null, "submission_587"?: {"status": "healthy" \| "warning" \| "critical" \| "unknown", "actual"?: [str] \| null, "code"?: str \| null, "days_remaining"?: int \| null, "error"?: str \| null, "expected"?: [str] \| null, "expires_at"?: str \| null, "issuer"?: str \| null, "record"?: str \| null, "records"?: [str] \| null, "status_code"?: int \| null} \| null}, "ssl": {"status": "healthy" \| "warning" \| "critical" \| "unknown", "actual"?: [str] \| null, "code"?: str \| null, "days_remaining"?: int \| null, "error"?: str \| null, "expected"?: [str] \| null, "expires_at"?: str \| null, "issuer"?: str \| null, "record"?: str \| null, "records"?: [str] \| null, "status_code"?: int \| null}, "web": {"status": "healthy" \| "warning" \| "critical" \| "unknown", "error"?: str \| null, "http_root"?: {"status": "healthy" \| "warning" \| "critical" \| "unknown", "actual"?: [str] \| null, "code"?: str \| null, "days_remaining"?: int \| null, "error"?: str \| null, "expected"?: [str] \| null, "expires_at"?: str \| null, "issuer"?: str \| null, "record"?: str \| null, "records"?: [str] \| null, "status_code"?: int \| null} \| null, "http_www"?: {"status": "healthy" \| "warning" \| "critical" \| "unknown", "actual"?: [str] \| null, "code"?: str \| null, "days_remaining"?: int \| null, "error"?: str \| null, "expected"?: [str] \| null, "expires_at"?: str \| null, "issuer"?: str \| null, "record"?: str \| null, "records"?: [str] \| null, "status_code"?: int \| null} \| null, "https_root"?: {"status": "healthy" \| "warning" \| "critical" \| "unknown", "actual"?: [str] \| null, "code"?: str \| null, "days_remaining"?: int \| null, "error"?: str \| null, "expected"?: [str] \| null, "expires_at"?: str \| null, "issuer"?: str \| null, "record"?: str \| null, "records"?: [str] \| null, "status_code"?: int \| null} \| null, "https_www"?: {"status": "healthy" \| "warning" \| "critical" \| "unknown", "actual"?: [str] \| null, "code"?: str \| null, "days_remaining"?: int \| null, "error"?: str \| null, "expected"?: [str] \| null, "expires_at"?: str \| null, "issuer"?: str \| null, "record"?: str \| null, "records"?: [str] \| null, "status_code"?: int \| null} \| null}}	نعم
`domain_id`	`str`	نعم
`domain_name`	`str`	نعم
`summary_status`	`"healthy" \| "warning" \| "critical" \| "unknown"`	نعم
`timings_ms`	`{}`	نعم

مثال A2A

الطلب:

{
  "request_id": "example",
  "session_id": "session_123",
  "code": "domains.health(account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", domain=\"example.com\", refresh=true)"
}

الاستجابة:

{
  "request_id": "example",
  "status": "completed",
  "result": {
    "last_value": 123
  },
  "responses": [
    {
      "index": 0,
      "function": "domains.health",
      "status": "completed",
      "result": 123
    }
  ],
  "complexity_score": 1
}

مثال MCP

الطلب:

{
  "jsonrpc": "2.0",
  "id": "example",
  "method": "tools/call",
  "params": {
    "name": "hybridbox_execute",
    "arguments": {
      "code": "domains.health(account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", domain=\"example.com\", refresh=true)"
    }
  }
}

الاستجابة:

{
  "jsonrpc": "2.0",
  "id": "example",
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{\n  \"request_id\": \"example\",\n  \"status\": \"completed\",\n  \"result\": {\n    \"last_value\": 123\n  },\n  \"responses\": [\n    {\n      \"index\": 0,\n      \"function\": \"domains.health\",\n      \"status\": \"completed\",\n      \"result\": 123\n    }\n  ],\n  \"complexity_score\": 1\n}"
      }
    ],
    "isError": false
  }
}

`domains.list`

domains.list(account_id: str, page?: int, page_size?: int, search?: str | null, workspace_id?: str | null) -> Page[Domain]

النطاقات: domains.list.

الخاصية	القيمة	الخاصية	القيمة
الإذن المطلوب	`domain.view`	المصادقة مطلوبة	`نعم`
وضع التنفيذ	`sync`	الصلاحية	`domain.view`
نوع المورد	`account`	حقل معرف المورد	`account_id`
مسار API العام	`GET /v1/public/accounts/{account_id}/domains`

الوسيطات

الاسم	النوع	مطلوب
`account_id`	`str`	نعم
`page`	`int`	لا
`page_size`	`int`	لا
`search`	`str \| null`	لا
`workspace_id`	`str \| null`	لا

القيم المرجعة

الحقل	النوع	مطلوب
`items`	`[{"id": str, "name": str, "outbound_routing_ready": bool, "status": str, "workspace_id": str, "auto_renew"?: bool, "created_at"?: str \| null, "dedicated_ip_id"?: str \| null, "inbound_tenant_external_id"?: str \| null, "inbound_tenant_id"?: str \| null, "inbound_tenant_name"?: str \| null, "inbound_tenant_type"?: str \| null, "redirect_mode"?: "301" \| "302" \| "iframe" \| null, "redirect_url"?: str \| null, "tags"?: [{"id": str, "name": str}], "updated_at"?: str \| null}]`	نعم
`page`	`int`	نعم
`page_size`	`int`	نعم
`total`	`int`	نعم

مثال A2A

الطلب:

{
  "request_id": "example",
  "session_id": "session_123",
  "code": "domains.list(account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", page=123, page_size=123, search=\"<string>\", workspace_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\")"
}

الاستجابة:

{
  "request_id": "example",
  "status": "completed",
  "result": {
    "last_value": true
  },
  "responses": [
    {
      "index": 0,
      "function": "domains.list",
      "status": "completed",
      "result": true
    }
  ],
  "complexity_score": 1
}

مثال MCP

الطلب:

{
  "jsonrpc": "2.0",
  "id": "example",
  "method": "tools/call",
  "params": {
    "name": "hybridbox_execute",
    "arguments": {
      "code": "domains.list(account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", page=123, page_size=123, search=\"<string>\", workspace_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\")"
    }
  }
}

الاستجابة:

{
  "jsonrpc": "2.0",
  "id": "example",
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{\n  \"request_id\": \"example\",\n  \"status\": \"completed\",\n  \"result\": {\n    \"last_value\": true\n  },\n  \"responses\": [\n    {\n      \"index\": 0,\n      \"function\": \"domains.list\",\n      \"status\": \"completed\",\n      \"result\": true\n    }\n  ],\n  \"complexity_score\": 1\n}"
      }
    ],
    "isError": false
  }
}

`domains.move`

domains.move(account_id: str, domain: str, target_workspace_id: str) -> Domain

النطاقات: domains.move.

الخاصية	القيمة	الخاصية	القيمة
الإذن المطلوب	`domain.move`	المصادقة مطلوبة	`نعم`
وضع التنفيذ	`sync`	الصلاحية	`domain.move`
نوع المورد	`workspace`	حقل معرف المورد	`target_workspace_id`
مسار API العام	`POST /v1/public/accounts/{account_id}/domains/{domain}/move`

الوسيطات

الاسم	النوع	مطلوب
`account_id`	`str`	نعم
`domain`	`str`	نعم
`target_workspace_id`	`str`	نعم

القيم المرجعة

الحقل	النوع	مطلوب
`account_id`	`str`	نعم
`domain_id`	`str`	نعم
`domain_name`	`str`	نعم
`from_workspace_id`	`str`	نعم
`reconciled`	`{"linked_records_changed"?: int}`	نعم
`to_workspace_id`	`str`	نعم
`status`	`str`	لا

مثال A2A

الطلب:

{
  "request_id": "example",
  "session_id": "session_123",
  "code": "domains.move(account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", domain=\"example.com\", target_workspace_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\")"
}

الاستجابة:

{
  "request_id": "example",
  "status": "completed",
  "result": {
    "last_value": 123
  },
  "responses": [
    {
      "index": 0,
      "function": "domains.move",
      "status": "completed",
      "result": 123
    }
  ],
  "complexity_score": 1
}

مثال MCP

الطلب:

{
  "jsonrpc": "2.0",
  "id": "example",
  "method": "tools/call",
  "params": {
    "name": "hybridbox_execute",
    "arguments": {
      "code": "domains.move(account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", domain=\"example.com\", target_workspace_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\")"
    }
  }
}

الاستجابة:

{
  "jsonrpc": "2.0",
  "id": "example",
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{\n  \"request_id\": \"example\",\n  \"status\": \"completed\",\n  \"result\": {\n    \"last_value\": 123\n  },\n  \"responses\": [\n    {\n      \"index\": 0,\n      \"function\": \"domains.move\",\n      \"status\": \"completed\",\n      \"result\": 123\n    }\n  ],\n  \"complexity_score\": 1\n}"
      }
    ],
    "isError": false
  }
}

`domains.purchase`

domains.purchase(account_id: str, contact_info: {"address_1": str, "city": str, "country": str, "email": str, "first_name": str, "last_name": str, "organization": str, "phone": str, "state": str, "zip": str}, domains: [str], workspace_id: str) -> Domain

النطاقات: domains.purchase.

الخاصية	القيمة	الخاصية	القيمة
الإذن المطلوب	`domain.purchase`	المصادقة مطلوبة	`نعم`
وضع التنفيذ	`sync`	الصلاحية	`domain.purchase`
نوع المورد	`account`	حقل معرف المورد	`account_id`
مسار API العام	`POST /v1/public/accounts/{account_id}/domains/purchase`

الوسيطات

الاسم	النوع	مطلوب
`account_id`	`str`	نعم
`contact_info`	`{"address_1": str, "city": str, "country": str, "email": str, "first_name": str, "last_name": str, "organization": str, "phone": str, "state": str, "zip": str}`	نعم
`domains`	`[str]`	نعم
`workspace_id`	`str`	نعم

القيم المرجعة

الحقل	النوع	مطلوب
`results`	`[{"domain_name": str, "status": str, "error"?: str \| null, "error_code"?: str \| null, "id"?: str \| null}]`	نعم
`currency`	`str \| null`	لا
`estimated_total`	`str \| null`	لا
`failed_count`	`int`	لا
`payment_url`	`str \| null`	لا
`purchase_batch_id`	`str \| null`	لا
`successful_count`	`int`	لا

مثال A2A

الطلب:

{
  "request_id": "example",
  "session_id": "session_123",
  "code": "domains.purchase(account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", contact_info=\"<string>\", domains=\"example.com\", workspace_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\")"
}

الاستجابة:

{
  "request_id": "example",
  "status": "completed",
  "result": {
    "last_value": "<string>"
  },
  "responses": [
    {
      "index": 0,
      "function": "domains.purchase",
      "status": "completed",
      "result": "<string>"
    }
  ],
  "complexity_score": 1
}

مثال MCP

الطلب:

{
  "jsonrpc": "2.0",
  "id": "example",
  "method": "tools/call",
  "params": {
    "name": "hybridbox_execute",
    "arguments": {
      "code": "domains.purchase(account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", contact_info=\"<string>\", domains=\"example.com\", workspace_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\")"
    }
  }
}

الاستجابة:

{
  "jsonrpc": "2.0",
  "id": "example",
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{\n  \"request_id\": \"example\",\n  \"status\": \"completed\",\n  \"result\": {\n    \"last_value\": \"<string>\"\n  },\n  \"responses\": [\n    {\n      \"index\": 0,\n      \"function\": \"domains.purchase\",\n      \"status\": \"completed\",\n      \"result\": \"<string>\"\n    }\n  ],\n  \"complexity_score\": 1\n}"
      }
    ],
    "isError": false
  }
}

`domains.search`

domains.search(account_id: str, domains: [str], workspace_id: str) -> list[Domain]

النطاقات: domains.search.

الخاصية	القيمة	الخاصية	القيمة
الإذن المطلوب	`domain.create`	المصادقة مطلوبة	`نعم`
وضع التنفيذ	`sync`	الصلاحية	`domain.create`
نوع المورد	`account`	حقل معرف المورد	`account_id`
مسار API العام	`GET /v1/public/accounts/{account_id}/domains/search`

الوسيطات

الاسم	النوع	مطلوب
`account_id`	`str`	نعم
`domains`	`[str]`	نعم
`workspace_id`	`str`	نعم

القيم المرجعة

الحقل	النوع	مطلوب
`available`	`bool`	نعم
`domain`	`str`	نعم
`price`	`str`	نعم
`alternatives`	`[{"domain": str, "price": str, "available"?: bool, "currency"?: str, "is_premium"?: bool, "is_suggestion"?: bool}]`	لا
`currency`	`str`	لا
`is_premium`	`bool`	لا
`is_suggestion`	`bool`	لا
`unavailable_reason`	`str \| null`	لا

مثال A2A

الطلب:

{
  "request_id": "example",
  "session_id": "session_123",
  "code": "domains.search(account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", domains=\"example.com\", workspace_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\")"
}

الاستجابة:

{
  "request_id": "example",
  "status": "completed",
  "result": {
    "last_value": true
  },
  "responses": [
    {
      "index": 0,
      "function": "domains.search",
      "status": "completed",
      "result": true
    }
  ],
  "complexity_score": 1
}

مثال MCP

الطلب:

{
  "jsonrpc": "2.0",
  "id": "example",
  "method": "tools/call",
  "params": {
    "name": "hybridbox_execute",
    "arguments": {
      "code": "domains.search(account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", domains=\"example.com\", workspace_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\")"
    }
  }
}

الاستجابة:

{
  "jsonrpc": "2.0",
  "id": "example",
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{\n  \"request_id\": \"example\",\n  \"status\": \"completed\",\n  \"result\": {\n    \"last_value\": true\n  },\n  \"responses\": [\n    {\n      \"index\": 0,\n      \"function\": \"domains.search\",\n      \"status\": \"completed\",\n      \"result\": true\n    }\n  ],\n  \"complexity_score\": 1\n}"
      }
    ],
    "isError": false
  }
}

`domains.update`

domains.update(account_id: str, domain: str, auto_renew?: bool | null, redirect_mode?: "301" | "302" | "iframe" | null, redirect_url?: str | null, workspace_id?: str | null) -> Domain

النطاقات: domains.update.

الخاصية	القيمة	الخاصية	القيمة
الإذن المطلوب	`domain.update`	المصادقة مطلوبة	`نعم`
وضع التنفيذ	`sync`	الصلاحية	`domain.update`
نوع المورد	`account`	حقل معرف المورد	`account_id`
مسار API العام	`PATCH /v1/public/accounts/{account_id}/domains/{domain}`

الوسيطات

الاسم	النوع	مطلوب
`account_id`	`str`	نعم
`domain`	`str`	نعم
`auto_renew`	`bool \| null`	لا
`redirect_mode`	`"301" \| "302" \| "iframe" \| null`	لا
`redirect_url`	`str \| null`	لا
`workspace_id`	`str \| null`	لا

القيم المرجعة

الحقل	النوع	مطلوب
`auto_renew`	`bool`	نعم
`id`	`str`	نعم
`workspace_id`	`str`	نعم
`redirect_mode`	`"301" \| "302" \| "iframe" \| null`	لا
`redirect_url`	`str \| null`	لا

مثال A2A

الطلب:

{
  "request_id": "example",
  "session_id": "session_123",
  "code": "domains.update(account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", domain=\"example.com\", auto_renew=true, redirect_mode=\"<string>\", redirect_url=\"<string>\", workspace_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\")"
}

الاستجابة:

{
  "request_id": "example",
  "status": "completed",
  "result": {
    "last_value": true
  },
  "responses": [
    {
      "index": 0,
      "function": "domains.update",
      "status": "completed",
      "result": true
    }
  ],
  "complexity_score": 1
}

مثال MCP

الطلب:

{
  "jsonrpc": "2.0",
  "id": "example",
  "method": "tools/call",
  "params": {
    "name": "hybridbox_execute",
    "arguments": {
      "code": "domains.update(account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", domain=\"example.com\", auto_renew=true, redirect_mode=\"<string>\", redirect_url=\"<string>\", workspace_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\")"
    }
  }
}

الاستجابة:

{
  "jsonrpc": "2.0",
  "id": "example",
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{\n  \"request_id\": \"example\",\n  \"status\": \"completed\",\n  \"result\": {\n    \"last_value\": true\n  },\n  \"responses\": [\n    {\n      \"index\": 0,\n      \"function\": \"domains.update\",\n      \"status\": \"completed\",\n      \"result\": true\n    }\n  ],\n  \"complexity_score\": 1\n}"
      }
    ],
    "isError": false
  }
}

`domains.verify`

domains.verify(account_id: str, domain: str) -> Domain

النطاقات: domains.verify.

الخاصية	القيمة	الخاصية	القيمة
الإذن المطلوب	`domain.verify`	المصادقة مطلوبة	`نعم`
وضع التنفيذ	`sync`	الصلاحية	`domain.verify`
نوع المورد	`account`	حقل معرف المورد	`account_id`
مسار API العام	`POST /v1/public/accounts/{account_id}/domains/{domain}/verify`

الوسيطات

الاسم	النوع	مطلوب
`account_id`	`str`	نعم
`domain`	`str`	نعم

القيم المرجعة

الحقل	النوع	مطلوب
`actual_nameservers`	`[str]`	نعم
`domain_id`	`str`	نعم
`expected_nameservers`	`[str]`	نعم
`message`	`str`	نعم
`status`	`str`	نعم
`verified`	`bool`	نعم
`missing_nameservers`	`[str]`	لا
`unexpected_nameservers`	`[str]`	لا

مثال A2A

الطلب:

{
  "request_id": "example",
  "session_id": "session_123",
  "code": "domains.verify(account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", domain=\"example.com\")"
}

الاستجابة:

{
  "request_id": "example",
  "status": "completed",
  "result": {
    "last_value": true
  },
  "responses": [
    {
      "index": 0,
      "function": "domains.verify",
      "status": "completed",
      "result": true
    }
  ],
  "complexity_score": 1
}

مثال MCP

الطلب:

{
  "jsonrpc": "2.0",
  "id": "example",
  "method": "tools/call",
  "params": {
    "name": "hybridbox_execute",
    "arguments": {
      "code": "domains.verify(account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", domain=\"example.com\")"
    }
  }
}

الاستجابة:

{
  "jsonrpc": "2.0",
  "id": "example",
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{\n  \"request_id\": \"example\",\n  \"status\": \"completed\",\n  \"result\": {\n    \"last_value\": true\n  },\n  \"responses\": [\n    {\n      \"index\": 0,\n      \"function\": \"domains.verify\",\n      \"status\": \"completed\",\n      \"result\": true\n    }\n  ],\n  \"complexity_score\": 1\n}"
      }
    ],
    "isError": false
  }
}

واجهة API للوكلاء / أدوات الذكاء الاصطناعي

كتالوج الدوال

النطاقات

النطاقات

الوظائف

`domains.delete`

`domains.get`

`domains.health`

`domains.list`

`domains.move`

`domains.purchase`

`domains.search`

`domains.update`

`domains.verify`

واجهة API للوكلاء / أدوات الذكاء الاصطناعي

كتالوج الدوال

Documentation Index

​النطاقات

​الوظائف

​domains.delete

​domains.get

​domains.health

​domains.list

​domains.move

​domains.purchase

​domains.search

​domains.update

​domains.verify

النطاقات

الوظائف

`domains.delete`

`domains.get`

`domains.health`

`domains.list`

`domains.move`

`domains.purchase`

`domains.search`

`domains.update`

`domains.verify`