> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hybridbox.io/llms.txt
> Use this file to discover all available pages before exploring further.
# النطاقات
> إدارة النطاقات والتحقق وحالة DNS ومفاتيح الإعداد ومساحات عمل النطاق.
# النطاقات
إدارة النطاقات والتحقق وحالة DNS ومفاتيح الإعداد ومساحات عمل النطاق.
تستخدم الأمثلة وضع الكود في A2A. يتيح MCP وضع الكود نفسه عبر أداة `execute`.
## الوظائف
### `domains.delete`
```text theme={null}
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` | `{}` | نعم |
الطلب:
```json theme={null}
{
"request_id": "example",
"session_id": "session_123",
"code": "domains.delete(account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", domain=\"example.com\")"
}
```
الاستجابة:
```json theme={null}
{
"request_id": "example",
"status": "completed",
"result": {
"last_value": {}
},
"responses": [
{
"index": 0,
"function": "domains.delete",
"status": "completed",
"result": {}
}
],
"complexity_score": 1
}
```
الطلب:
```json theme={null}
{
"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\")"
}
}
}
```
الاستجابة:
```json theme={null}
{
"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`
```text theme={null}
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` | لا |
الطلب:
```json theme={null}
{
"request_id": "example",
"session_id": "session_123",
"code": "domains.get(account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", domain=\"example.com\")"
}
```
الاستجابة:
```json theme={null}
{
"request_id": "example",
"status": "completed",
"result": {
"last_value": true
},
"responses": [
{
"index": 0,
"function": "domains.get",
"status": "completed",
"result": true
}
],
"complexity_score": 1
}
```
الطلب:
```json theme={null}
{
"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\")"
}
}
}
```
الاستجابة:
```json theme={null}
{
"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`
```text theme={null}
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` | `{}` | نعم |
الطلب:
```json theme={null}
{
"request_id": "example",
"session_id": "session_123",
"code": "domains.health(account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", domain=\"example.com\", refresh=true)"
}
```
الاستجابة:
```json theme={null}
{
"request_id": "example",
"status": "completed",
"result": {
"last_value": 123
},
"responses": [
{
"index": 0,
"function": "domains.health",
"status": "completed",
"result": 123
}
],
"complexity_score": 1
}
```
الطلب:
```json theme={null}
{
"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)"
}
}
}
```
الاستجابة:
```json theme={null}
{
"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`
```text theme={null}
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` | نعم |
الطلب:
```json theme={null}
{
"request_id": "example",
"session_id": "session_123",
"code": "domains.list(account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", page=123, page_size=123, search=\"\", workspace_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\")"
}
```
الاستجابة:
```json theme={null}
{
"request_id": "example",
"status": "completed",
"result": {
"last_value": true
},
"responses": [
{
"index": 0,
"function": "domains.list",
"status": "completed",
"result": true
}
],
"complexity_score": 1
}
```
الطلب:
```json theme={null}
{
"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=\"\", workspace_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\")"
}
}
}
```
الاستجابة:
```json theme={null}
{
"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`
```text theme={null}
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` | لا |
الطلب:
```json theme={null}
{
"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\")"
}
```
الاستجابة:
```json theme={null}
{
"request_id": "example",
"status": "completed",
"result": {
"last_value": 123
},
"responses": [
{
"index": 0,
"function": "domains.move",
"status": "completed",
"result": 123
}
],
"complexity_score": 1
}
```
الطلب:
```json theme={null}
{
"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\")"
}
}
}
```
الاستجابة:
```json theme={null}
{
"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`
```text theme={null}
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` | لا |
الطلب:
```json theme={null}
{
"request_id": "example",
"session_id": "session_123",
"code": "domains.purchase(account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", contact_info=\"\", domains=\"example.com\", workspace_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\")"
}
```
الاستجابة:
```json theme={null}
{
"request_id": "example",
"status": "completed",
"result": {
"last_value": ""
},
"responses": [
{
"index": 0,
"function": "domains.purchase",
"status": "completed",
"result": ""
}
],
"complexity_score": 1
}
```
الطلب:
```json theme={null}
{
"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=\"\", domains=\"example.com\", workspace_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\")"
}
}
}
```
الاستجابة:
```json theme={null}
{
"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.purchase\",\n \"status\": \"completed\",\n \"result\": \"\"\n }\n ],\n \"complexity_score\": 1\n}"
}
],
"isError": false
}
}
```
### `domains.search`
```text theme={null}
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` | لا |
الطلب:
```json theme={null}
{
"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\")"
}
```
الاستجابة:
```json theme={null}
{
"request_id": "example",
"status": "completed",
"result": {
"last_value": true
},
"responses": [
{
"index": 0,
"function": "domains.search",
"status": "completed",
"result": true
}
],
"complexity_score": 1
}
```
الطلب:
```json theme={null}
{
"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\")"
}
}
}
```
الاستجابة:
```json theme={null}
{
"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`
```text theme={null}
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` | لا |
الطلب:
```json theme={null}
{
"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=\"\", redirect_url=\"\", workspace_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\")"
}
```
الاستجابة:
```json theme={null}
{
"request_id": "example",
"status": "completed",
"result": {
"last_value": true
},
"responses": [
{
"index": 0,
"function": "domains.update",
"status": "completed",
"result": true
}
],
"complexity_score": 1
}
```
الطلب:
```json theme={null}
{
"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=\"\", redirect_url=\"\", workspace_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\")"
}
}
}
```
الاستجابة:
```json theme={null}
{
"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`
```text theme={null}
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]` | لا |
الطلب:
```json theme={null}
{
"request_id": "example",
"session_id": "session_123",
"code": "domains.verify(account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", domain=\"example.com\")"
}
```
الاستجابة:
```json theme={null}
{
"request_id": "example",
"status": "completed",
"result": {
"last_value": true
},
"responses": [
{
"index": 0,
"function": "domains.verify",
"status": "completed",
"result": true
}
],
"complexity_score": 1
}
```
الطلب:
```json theme={null}
{
"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\")"
}
}
}
```
الاستجابة:
```json theme={null}
{
"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
}
}
```