Serpo.one

API สำหรับนักพัฒนา

จัดการโปรเจกต์ เป้าหมาย การตรวจสอบ กำหนดการ และข้อมูลรับรองผ่าน REST หรือ MCP

OpenAPI 3.1 JSON · การดำเนินการ · ข้อผิดพลาด · MCP

การยืนยันตัวตน

สร้างโทเค็นที่มีวันหมดอายุใน API และ MCP ด้วยรหัสผ่านปัจจุบัน คัดลอกครั้งเดียวและเก็บเป็นความลับ ส่ง Authorization: Bearer TOKEN และ Accept: application/json ทุกคำขอ คุกกี้เซสชันใช้ยืนยันตัวตน API นี้ไม่ได้ การเพิกถอนมีผลทันที บัญชีต้องใช้งานอยู่และยืนยันอีเมลแล้ว ผู้ดูแลระบบไม่สามารถเข้าในนามผู้ใช้ผ่าน API

curl 'https://serpo.one/api/v1/projects' \
  -H 'Authorization: Bearer TOKEN' -H 'Accept: application/json'

JSON ที่สำเร็จอยู่ใน {"data": ...} ชุดข้อมูลใช้การแบ่งหน้า Laravel ภายใน data: data.data, data.current_page, data.last_page, data.total กำหนด page ≥ 1 และ per_page ตั้งแต่ 1 ถึง 100 (เริ่มต้น 25) ID บัญชีอื่นตอบ 404 รับข้อมูลลับผ่าน PUT ข้อมูลรับรองเท่านั้นและไม่ส่งกลับ ยอดคงเหลือถูกแคช การรีเฟรชจะเข้าคิวอัปเดตเบื้องหลังที่จำกัดขอบเขต

การตรวจสอบแบบมีค่าใช้จ่ายและการลองใหม่

การสร้างรอบต้องใช้ confirm_paid: true และส่วนหัว Idempotency-Key ที่ไม่ซ้ำหรือฟิลด์ idempotency_key ใช้คีย์และเนื้อหาเดิมเพื่อรับการตอบกลับอีกครั้งโดยไม่สร้างรอบใหม่ หากเปลี่ยนเนื้อหาแต่ใช้คีย์เดิมจะได้ 409 คีย์เป็นของบัญชีและเก็บไว้จนลบบัญชี รอบจะตรึงเป้าหมายและการตั้งค่า ผู้ให้บริการอาจคิดค่าบริการ การทำคำขอที่ไม่แน่นอนต่อจำเป็นต้องมี retry_uncertain: true เพื่อยอมรับโอกาสถูกคิดค่าบริการซ้ำ การสร้างกำหนดการต้องมี confirm_paid: true และคีย์ป้องกันการทำซ้ำเช่นกัน

curl -X POST 'https://serpo.one/api/v1/projects/1/runs' \
  -H 'Authorization: Bearer TOKEN' -H 'Content-Type: application/json' \
  -H 'Accept: application/json' -H 'Idempotency-Key: check-2026-11-20-001' \
  -d '{"confirm_paid":true,"settings":{"depth":10}}'

การส่งออก CSV แบ่งหน้า X-Total-Pages ระบุจำนวนหน้า ต้องขอทุกหน้าเพื่อส่งออกครบ เซลล์ที่คล้ายสูตรจะถูกเอสเคป วันที่ใช้ ISO 8601 UTC เวลาท้องถิ่นในกำหนดการใช้เขตเวลา IANA ที่ระบุชัดเจน วัน ISO เริ่มจันทร์=1 ถึงอาทิตย์=7 เวลาซ้ำที่ไม่มีอยู่หรือกำกวมจากการปรับเวลาออมแสงจะถูกข้าม กำหนดการครั้งเดียวที่กำกวมต้องระบุออฟเซ็ต

การดำเนินการ

GET /api/v1/frequency — frequency.list

สิทธิ์: frequency:read

POST /api/v1/frequency — frequency.create

สิทธิ์: frequency:write

{
    "type": "object",
    "properties": {
        "queries": {
            "type": "array",
            "items": {
                "type": "string",
                "maxLength": 400
            },
            "minItems": 1,
            "maxItems": 1000
        },
        "project": {
            "type": "integer",
            "minimum": 1
        },
        "keyword_ids": {
            "type": "array",
            "items": {
                "type": "integer",
                "minimum": 1
            },
            "minItems": 1,
            "maxItems": 1000,
            "uniqueItems": true
        },
        "provider": {
            "enum": [
                "xmlriver",
                "xmlstock"
            ]
        },
        "modes": {
            "type": "array",
            "items": {
                "enum": [
                    "broad",
                    "phrase",
                    "exact"
                ]
            },
            "minItems": 1,
            "maxItems": 3,
            "uniqueItems": true
        },
        "region": {
            "type": [
                "integer",
                "null"
            ],
            "minimum": 0,
            "maximum": 2147483647
        },
        "device": {
            "enum": [
                "all",
                "desktop",
                "phone",
                "tablet"
            ]
        },
        "period": {
            "enum": [
                "month",
                "week",
                "day"
            ]
        },
        "start": {
            "type": [
                "string",
                "null"
            ],
            "format": "date"
        },
        "end": {
            "type": [
                "string",
                "null"
            ],
            "format": "date"
        },
        "threads": {
            "type": "integer",
            "minimum": 1,
            "maximum": 10
        },
        "confirm_paid": {
            "type": "boolean",
            "const": true
        },
        "idempotency_key": {
            "type": "string",
            "maxLength": 100,
            "pattern": "^[a-zA-Z0-9._:-]+$"
        }
    },
    "required": [
        "modes",
        "confirm_paid"
    ],
    "additionalProperties": false
}
GET /api/v1/frequency/{batch} — frequency.show

สิทธิ์: frequency:read

GET /api/v1/frequency/{batch}/results — frequency.results

สิทธิ์: frequency:read

GET /api/v1/frequency/{batch}/export — frequency.export

สิทธิ์: frequency:read

POST /api/v1/frequency/{batch}/cancel — frequency.cancel

สิทธิ์: frequency:write

POST /api/v1/frequency/{batch}/retry — frequency.retry

สิทธิ์: frequency:write

{
    "type": "object",
    "properties": {
        "confirm_paid": {
            "type": "boolean",
            "const": true
        },
        "retry_uncertain": {
            "type": "boolean",
            "const": true
        },
        "idempotency_key": {
            "type": "string",
            "maxLength": 100,
            "pattern": "^[a-zA-Z0-9._:-]+$"
        }
    },
    "required": [
        "confirm_paid"
    ],
    "additionalProperties": false
}
POST /api/v1/account/password — account.password

สิทธิ์: account:write

{
    "type": "object",
    "properties": {
        "current_password": {
            "type": "string",
            "maxLength": 72,
            "writeOnly": true
        },
        "password": {
            "type": "string",
            "maxLength": 72,
            "writeOnly": true,
            "minLength": 12
        },
        "password_confirmation": {
            "type": "string",
            "maxLength": 72,
            "writeOnly": true
        },
        "revoke_other_tokens": {
            "type": "boolean",
            "default": false
        }
    },
    "required": [
        "current_password",
        "password",
        "password_confirmation"
    ],
    "additionalProperties": false
}
GET /api/v1/tokens — tokens.list

สิทธิ์: tokens:read

POST /api/v1/tokens — tokens.issue

สิทธิ์:

{
    "type": "object",
    "properties": {
        "email": {
            "type": "string",
            "format": "email",
            "maxLength": 255
        },
        "password": {
            "type": "string",
            "maxLength": 72,
            "writeOnly": true
        },
        "name": {
            "type": "string",
            "maxLength": 100
        },
        "abilities": {
            "type": "array",
            "items": {
                "enum": [
                    "account:read",
                    "account:write",
                    "admin:read",
                    "admin:write",
                    "frequency:read",
                    "frequency:write",
                    "nullable|regex:/^[+-]\\d{2}:\\d{2}$/",
                    "nullable|string|max:2048",
                    "projects:read",
                    "projects:write",
                    "providers:read",
                    "providers:write",
                    "required|array|min:1|max:100",
                    "required|array|min:1|max:1000",
                    "required|array|min:1|max:20",
                    "required|integer|min:1|distinct",
                    "required|integer|min:1|max:365",
                    "required|string|max:100",
                    "required|string|max:30",
                    "required|string|max:400",
                    "runs:read",
                    "runs:write",
                    "schedules:read",
                    "schedules:write",
                    "sometimes|array|min:1|max:100",
                    "sometimes|integer|min:1|max:100",
                    "sometimes|integer|min:1|max:100000",
                    "sometimes|nullable|string|max:255",
                    "sometimes|required|string|max:120",
                    "tokens:read",
                    "tokens:write"
                ]
            },
            "minItems": 1,
            "maxItems": 20,
            "uniqueItems": true
        },
        "expires_in_days": {
            "type": "integer",
            "minimum": 1,
            "maximum": 365
        }
    },
    "required": [
        "email",
        "password",
        "name",
        "abilities",
        "expires_in_days"
    ],
    "additionalProperties": false
}
DELETE /api/v1/tokens/{token} — tokens.revoke

สิทธิ์: tokens:write

GET /api/v1/admin/settings — admin.settings

สิทธิ์: admin:read

PATCH /api/v1/admin/settings — admin.settings_update

สิทธิ์: admin:write

{
    "type": "object",
    "properties": {
        "enabled": {
            "type": "boolean"
        },
        "start": {
            "type": "string",
            "pattern": "^([01][0-9]|2[0-3]):[0-5][0-9]$"
        },
        "end": {
            "type": "string",
            "pattern": "^([01][0-9]|2[0-3]):[0-5][0-9]$"
        }
    },
    "required": [],
    "additionalProperties": false,
    "minProperties": 1
}
GET /api/v1/admin/users — admin.users

สิทธิ์: admin:read

GET /api/v1/admin/users/{user} — admin.user

สิทธิ์: admin:read

PATCH /api/v1/admin/users/{user}/status — admin.status

สิทธิ์: admin:write

{
    "type": "object",
    "properties": {
        "is_active": {
            "type": "boolean"
        }
    },
    "required": [
        "is_active"
    ],
    "additionalProperties": false
}
GET /api/v1/admin/statistics — admin.statistics

สิทธิ์: admin:read

GET /api/v1/admin/users/{user}/balances — admin.balances

สิทธิ์: admin:read

GET /api/v1/runs/{run}/download — runs.download

สิทธิ์: runs:read

GET /api/v1/account — account.show

สิทธิ์: account:read

PATCH /api/v1/account — account.update

สิทธิ์: account:write

{
    "type": "object",
    "properties": {
        "name": {
            "type": "string",
            "maxLength": 120
        },
        "locale": {
            "enum": [
                "en",
                "ru",
                "kk",
                "es",
                "pt",
                "de",
                "fr",
                "it",
                "pl",
                "tr",
                "uk",
                "zh",
                "ja",
                "ko",
                "ar",
                "hi",
                "id",
                "vi",
                "th",
                "nl",
                "bn",
                "ur",
                "fa",
                "cs"
            ]
        },
        "timezone": {
            "type": "string",
            "maxLength": 80
        },
        "settings": {
            "$ref": "#/components/schemas/RankSettings"
        }
    },
    "required": [],
    "additionalProperties": false
}

ตัวอย่างเนื้อหาคำขอ:

{
    "locale": "en",
    "timezone": "Europe/Moscow"
}
GET /api/v1/projects — projects.list

สิทธิ์: projects:read

POST /api/v1/projects — projects.create

สิทธิ์: projects:write

{
    "type": "object",
    "properties": {
        "name": {
            "type": "string",
            "maxLength": 120
        },
        "settings": {
            "$ref": "#/components/schemas/RankSettings"
        }
    },
    "required": [
        "name"
    ],
    "additionalProperties": false
}

ตัวอย่างเนื้อหาคำขอ:

{
    "name": "Example",
    "settings": {
        "depth": 10
    }
}
GET /api/v1/projects/{project} — projects.show

สิทธิ์: projects:read

PATCH /api/v1/projects/{project} — projects.update

สิทธิ์: projects:write

{
    "type": "object",
    "properties": {
        "name": {
            "type": "string",
            "maxLength": 120
        },
        "settings": {
            "$ref": "#/components/schemas/RankSettings"
        }
    },
    "required": [],
    "additionalProperties": false
}
DELETE /api/v1/projects/{project} — projects.delete

สิทธิ์: projects:write

POST /api/v1/projects/{project}/domains/import — domains.import

สิทธิ์: projects:write

{
    "type": "object",
    "properties": {
        "format": {
            "enum": [
                "txt",
                "csv",
                "json"
            ]
        },
        "mode": {
            "enum": [
                "append",
                "replace"
            ]
        },
        "content": {
            "type": "string",
            "maxLength": 2000000
        }
    },
    "required": [
        "format",
        "mode",
        "content"
    ],
    "additionalProperties": false
}
POST /api/v1/projects/{project}/domains/bulk-delete — domains.bulk_delete

สิทธิ์: projects:write

{
    "type": "object",
    "properties": {
        "ids": {
            "type": "array",
            "items": {
                "type": "integer",
                "minimum": 1
            },
            "minItems": 1,
            "maxItems": 1000,
            "uniqueItems": true
        }
    },
    "required": [
        "ids"
    ],
    "additionalProperties": false
}
POST /api/v1/projects/{project}/keywords/import — keywords.import

สิทธิ์: projects:write

{
    "type": "object",
    "properties": {
        "format": {
            "enum": [
                "txt",
                "csv",
                "json"
            ]
        },
        "mode": {
            "enum": [
                "append",
                "replace"
            ]
        },
        "content": {
            "type": "string",
            "maxLength": 2000000
        }
    },
    "required": [
        "format",
        "mode",
        "content"
    ],
    "additionalProperties": false
}
POST /api/v1/projects/{project}/keywords/bulk-delete — keywords.bulk_delete

สิทธิ์: projects:write

{
    "type": "object",
    "properties": {
        "ids": {
            "type": "array",
            "items": {
                "type": "integer",
                "minimum": 1
            },
            "minItems": 1,
            "maxItems": 1000,
            "uniqueItems": true
        }
    },
    "required": [
        "ids"
    ],
    "additionalProperties": false
}
GET /api/v1/projects/{project}/domains — domains.list

สิทธิ์: projects:read

POST /api/v1/projects/{project}/domains — domains.create

สิทธิ์: projects:write

{
    "type": "object",
    "properties": {
        "domain": {
            "type": "string",
            "maxLength": 2048
        },
        "group": {
            "type": "string",
            "maxLength": 255
        }
    },
    "required": [
        "domain"
    ],
    "additionalProperties": false
}

ตัวอย่างเนื้อหาคำขอ:

{
    "domain": "example.com"
}
PATCH /api/v1/projects/{project}/domains/{item} — domains.update

สิทธิ์: projects:write

{
    "type": "object",
    "properties": {
        "domain": {
            "type": "string",
            "maxLength": 2048
        },
        "group": {
            "type": "string",
            "maxLength": 255
        }
    },
    "required": [
        "domain"
    ],
    "additionalProperties": false
}
DELETE /api/v1/projects/{project}/domains/{item} — domains.delete

สิทธิ์: projects:write

GET /api/v1/projects/{project}/keywords — keywords.list

สิทธิ์: projects:read

POST /api/v1/projects/{project}/keywords — keywords.create

สิทธิ์: projects:write

{
    "type": "object",
    "properties": {
        "query": {
            "type": "string",
            "maxLength": 400
        },
        "domain": {
            "type": [
                "string",
                "null"
            ],
            "maxLength": 2048
        },
        "group": {
            "type": "string",
            "maxLength": 255
        }
    },
    "required": [
        "query"
    ],
    "additionalProperties": false
}

ตัวอย่างเนื้อหาคำขอ:

{
    "query": "example search",
    "group": "Primary"
}
PATCH /api/v1/projects/{project}/keywords/{item} — keywords.update

สิทธิ์: projects:write

{
    "type": "object",
    "properties": {
        "query": {
            "type": "string",
            "maxLength": 400
        },
        "domain": {
            "type": [
                "string",
                "null"
            ],
            "maxLength": 2048
        },
        "group": {
            "type": "string",
            "maxLength": 255
        }
    },
    "required": [
        "query"
    ],
    "additionalProperties": false
}
DELETE /api/v1/projects/{project}/keywords/{item} — keywords.delete

สิทธิ์: projects:write

GET /api/v1/providers — providers.list

สิทธิ์: providers:read

PUT /api/v1/providers/{provider}/credentials — credentials.put

สิทธิ์: providers:write

{
    "type": "object",
    "properties": {
        "provider_user": {
            "type": "string",
            "maxLength": 255,
            "writeOnly": true
        },
        "api_key": {
            "type": "string",
            "maxLength": 2000,
            "writeOnly": true
        },
        "frequency_api_key": {
            "type": "string",
            "maxLength": 2000,
            "writeOnly": true,
            "deprecated": true,
            "description": "Deprecated compatibility alias for api_key for both providers; conflicting values return 422."
        },
        "balance_api_key": {
            "type": "string",
            "maxLength": 2000,
            "writeOnly": true,
            "deprecated": true,
            "description": "Deprecated compatibility alias for api_key for both providers; conflicting values return 422; never returned."
        }
    },
    "required": [],
    "additionalProperties": false,
    "description": "Both XMLRiver and XMLStock use one api_key for SERP, Wordstat and balance. Legacy frequency_api_key and balance_api_key are aliases only; conflicting values and masked placeholders return 422. Blank or omitted keys preserve the saved primary key. provider_user is required for first connection; blank or omitted provider_user preserves the saved ID. Masked IDs are rejected."
}

ตัวอย่างเนื้อหาคำขอ:

{
    "provider_user": "123",
    "api_key": "REPLACE_WITH_PROVIDER_KEY"
}
DELETE /api/v1/providers/{provider}/credentials — credentials.delete

สิทธิ์: providers:write

GET /api/v1/balances — balances.list

สิทธิ์: providers:read

POST /api/v1/balances/refresh — balances.refresh

สิทธิ์: providers:write

GET /api/v1/runs — runs.list

สิทธิ์: runs:read

POST /api/v1/projects/{project}/runs — runs.create

สิทธิ์: runs:write

{
    "type": "object",
    "properties": {
        "confirm_paid": {
            "type": "boolean",
            "const": true
        },
        "idempotency_key": {
            "type": "string",
            "maxLength": 100,
            "pattern": "^[a-zA-Z0-9._:-]+$"
        },
        "settings": {
            "$ref": "#/components/schemas/RankSettings"
        },
        "keyword_id": {
            "type": "integer",
            "minimum": 1
        },
        "domain_ids": {
            "type": "array",
            "items": {
                "type": "integer",
                "minimum": 1
            },
            "minItems": 1,
            "maxItems": 100,
            "uniqueItems": true
        }
    },
    "required": [
        "confirm_paid"
    ],
    "additionalProperties": false
}

ตัวอย่างเนื้อหาคำขอ:

{
    "confirm_paid": true,
    "idempotency_key": "check-001",
    "settings": {
        "depth": 10
    }
}
GET /api/v1/runs/{run} — runs.show

สิทธิ์: runs:read

GET /api/v1/runs/{run}/results — runs.results

สิทธิ์: runs:read

GET /api/v1/runs/{run}/export — runs.export

สิทธิ์: runs:read

POST /api/v1/runs/{run}/pause — runs.pause

สิทธิ์: runs:write

POST /api/v1/runs/{run}/resume — runs.resume

สิทธิ์: runs:write

{
    "type": "object",
    "properties": {
        "retry_uncertain": {
            "type": "boolean",
            "const": true
        }
    },
    "required": [],
    "additionalProperties": false
}

ตัวอย่างเนื้อหาคำขอ:

{
    "retry_uncertain": true
}
POST /api/v1/runs/{run}/cancel — runs.cancel

สิทธิ์: runs:write

GET /api/v1/schedules — schedules.list

สิทธิ์: schedules:read

POST /api/v1/schedules — schedules.create

สิทธิ์: schedules:write

{
    "type": "object",
    "properties": {
        "project_ids": {
            "type": "array",
            "items": {
                "type": "integer",
                "minimum": 1
            },
            "minItems": 1,
            "maxItems": 100,
            "uniqueItems": true
        },
        "domain_ids": {
            "type": "object",
            "additionalProperties": {
                "type": "array",
                "items": {
                    "type": "integer",
                    "minimum": 1
                },
                "minItems": 1,
                "maxItems": 100,
                "uniqueItems": true
            }
        },
        "settings": {
            "$ref": "#/components/schemas/RankSettings"
        },
        "frequency": {
            "enum": [
                "daily",
                "weekly"
            ]
        },
        "weekdays": {
            "type": "array",
            "items": {
                "type": "integer",
                "minimum": 1,
                "maximum": 7
            },
            "uniqueItems": true
        },
        "local_time": {
            "type": "string",
            "pattern": "^\\d{2}:\\d{2}$"
        },
        "timezone": {
            "type": "string",
            "maxLength": 80
        },
        "enabled": {
            "type": "boolean"
        },
        "confirm_paid": {
            "type": "boolean",
            "const": true
        },
        "idempotency_key": {
            "type": "string",
            "maxLength": 100,
            "pattern": "^[a-zA-Z0-9._:-]+$"
        }
    },
    "required": [
        "project_ids",
        "frequency",
        "local_time",
        "timezone",
        "confirm_paid"
    ],
    "additionalProperties": false
}

ตัวอย่างเนื้อหาคำขอ:

{
    "idempotency_key": "schedule-001",
    "project_ids": [
        1
    ],
    "frequency": "weekly",
    "weekdays": [
        1,
        3,
        5
    ],
    "local_time": "09:00",
    "timezone": "Europe/Moscow",
    "enabled": true,
    "confirm_paid": true
}
GET /api/v1/schedules/once — schedules.once_list

สิทธิ์: schedules:read

POST /api/v1/schedules/once — schedules.once

สิทธิ์: schedules:write

{
    "type": "object",
    "properties": {
        "project_ids": {
            "type": "array",
            "items": {
                "type": "integer",
                "minimum": 1
            },
            "minItems": 1,
            "maxItems": 100,
            "uniqueItems": true
        },
        "settings": {
            "$ref": "#/components/schemas/RankSettings"
        },
        "scheduled_for": {
            "type": "string",
            "maxLength": 30
        },
        "timezone": {
            "type": "string",
            "maxLength": 80
        },
        "offset": {
            "type": "string",
            "pattern": "^[+-]\\d{2}:\\d{2}$"
        },
        "confirm_paid": {
            "type": "boolean",
            "const": true
        },
        "idempotency_key": {
            "type": "string",
            "maxLength": 100,
            "pattern": "^[a-zA-Z0-9._:-]+$"
        }
    },
    "required": [
        "project_ids",
        "scheduled_for",
        "timezone",
        "confirm_paid"
    ],
    "additionalProperties": false
}

ตัวอย่างเนื้อหาคำขอ:

{
    "idempotency_key": "once-001",
    "project_ids": [
        1
    ],
    "scheduled_for": "2027-01-20T09:00",
    "timezone": "Europe/Moscow",
    "confirm_paid": true
}
GET /api/v1/schedules/once/{schedule} — schedules.once_show

สิทธิ์: schedules:read

PATCH /api/v1/schedules/once/{schedule} — schedules.once_update

สิทธิ์: schedules:write

{
    "type": "object",
    "properties": {
        "scheduled_for": {
            "type": "string",
            "maxLength": 30
        },
        "timezone": {
            "type": "string",
            "maxLength": 80
        },
        "offset": {
            "type": "string",
            "pattern": "^[+-]\\d{2}:\\d{2}$"
        }
    },
    "required": [
        "scheduled_for",
        "timezone"
    ],
    "additionalProperties": false
}
DELETE /api/v1/schedules/once/{schedule} — schedules.once_delete

สิทธิ์: schedules:write

GET /api/v1/schedules/{schedule} — schedules.show

สิทธิ์: schedules:read

PATCH /api/v1/schedules/{schedule} — schedules.update

สิทธิ์: schedules:write

{
    "type": "object",
    "properties": {
        "project_ids": {
            "type": "array",
            "items": {
                "type": "integer",
                "minimum": 1
            },
            "minItems": 1,
            "maxItems": 100,
            "uniqueItems": true
        },
        "domain_ids": {
            "type": "object",
            "additionalProperties": {
                "type": "array",
                "items": {
                    "type": "integer",
                    "minimum": 1
                },
                "minItems": 1,
                "maxItems": 100,
                "uniqueItems": true
            }
        },
        "settings": {
            "$ref": "#/components/schemas/RankSettings"
        },
        "frequency": {
            "enum": [
                "daily",
                "weekly"
            ]
        },
        "weekdays": {
            "type": "array",
            "items": {
                "type": "integer",
                "minimum": 1,
                "maximum": 7
            },
            "uniqueItems": true
        },
        "local_time": {
            "type": "string",
            "pattern": "^\\d{2}:\\d{2}$"
        },
        "timezone": {
            "type": "string",
            "maxLength": 80
        },
        "enabled": {
            "type": "boolean"
        },
        "confirm_paid": {
            "type": "boolean",
            "const": true
        },
        "idempotency_key": {
            "type": "string",
            "maxLength": 100,
            "pattern": "^[a-zA-Z0-9._:-]+$"
        }
    },
    "required": [],
    "additionalProperties": false
}
DELETE /api/v1/schedules/{schedule} — schedules.delete

สิทธิ์: schedules:write

GET /api/v1/healthz — health.show

สิทธิ์:

ข้อผิดพลาดและขีดจำกัด

401: ไม่มีโทเค็น Bearer หมดอายุ หรือถูกเพิกถอน 403: สิทธิ์ไม่พอหรือบัญชีไม่ใช้งาน/ไม่ยืนยัน 404: ทรัพยากรไม่พร้อมใช้ รวมของบัญชีอื่น 409: คีย์ป้องกันการทำซ้ำขัดแย้ง 422: ข้อมูลไม่ถูกต้อง errors แยกตามฟิลด์ 429: เกินขีดจำกัด ให้ทำตาม Retry-After และเพิ่มเวลารอ ห้ามเปลี่ยนคีย์ป้องกันการทำซ้ำสำหรับการลองใหม่ที่มีค่าใช้จ่ายเพียงเพราะการตอบกลับสูญหาย

{"message":"The name field is required.","errors":{"name":["The name field is required."]}}

MCP

เชื่อมต่อ /mcp ด้วย Streamable HTTP และโทเค็น Bearer เดิม ดูสคีมาเครื่องมือผ่าน tools/list ชื่อเครื่องมือตาม ID การดำเนินการข้างต้น ยกเว้น runs.start ตรงกับ runs.create ข้อมูลลับผู้ให้บริการและการจัดการโทเค็นไม่มีใน MCP ให้ใช้หน้าบัญชีหรือ REST ข้อมูลรับรอง สิทธิ์อ่านและเขียนแยกกัน การสร้างแบบมีค่าใช้จ่ายต้องยืนยันและมีคีย์ป้องกันการทำซ้ำ ไม่ส่งข้อมูลรับรองกลับ ให้สิทธิ์เขียนเฉพาะเมื่อไคลเอนต์ MCP จำเป็นต้องเปลี่ยนข้อมูล

curl -X POST 'https://serpo.one/mcp' \
 -H 'Authorization: Bearer TOKEN' -H 'Content-Type: application/json' \
 -H 'Accept: application/json, text/event-stream' \
 -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-11-25","capabilities":{},"clientInfo":{"name":"my-client","version":"1.0"}}}'