ORBIT

服务 API 参考

服务 API。

共 15 个端点,其中 8 个只读。每一个都同时是 orbit 命令行中的命令、SDK 中的方法和 MCP 服务器上的工具。

01

通用

端点	权限	参数	CLI · MCP 工具
`GET /services` List my services	只读	`?limit` integer `?offset` integer	`orbit services list` `services_list`
`GET /services/{id}` Get a service	只读	`id` integer	`orbit services get <id>` `services_get`
`POST /services/{id}/transfer` Move a service (with its zones, sites and rules) to yourself or to a team you administer	读写	`id` integer 请求体: `to`* string	`orbit services transfer <id>` `services_transfer`
`POST /services/{id}/rule-test` Check what a name would do against the custom rules	只读	`id` integer 请求体: `name` string, `qtype` string, `rules` string	`orbit services ruletest <id>` `services_ruletest`
`GET /services/{id}/query-log` Recent queries (private resolvers with logging on)	只读	`id` integer `?q` string `?action` pass \| blocked \| rewritten \| safesearch \| ratelimited `?limit` integer	`orbit services querylog <id>` `services_querylog`
`GET /services/{id}/stats` Resolver statistics	只读	`id` integer `?days` integer	`orbit services dnsstats <id>` `services_dnsstats`

02

filter

端点	权限	参数	CLI · MCP 工具
`GET /services/{id}/filter` Resolver filter lists and rewrites	只读	`id` integer	`orbit services filter get <id>` `services_filter_get`
`PUT /services/{id}/filter` Replace resolver filter lists / rewrites	读写	`id` integer 请求体: `custom_block` string, `custom_allow` string, `rewrites` string, `block_mode` nxdomain \| zero \| page, `filter_lists` string	`orbit services filter put <id>` `services_filter_put`

03

policy

端点	权限	参数	CLI · MCP 工具
`GET /services/{id}/policy` Resolver filtering policy	只读	`id` integer	`orbit services policy get <id>` `services_policy_get`
`PUT /services/{id}/policy` Update the resolver filtering policy	读写	`id` integer 请求体: `rules` string, `blocked_services` string, `schedule_json` string, `tz` string, `safesearch` string, `block_bypass` boolean, `log_mode` off \| blocked \| all, `log_days` integer, `anonymize_ip` boolean, `ratelimit` integer, `ttl_min` integer, `ttl_max` integer, `access_allow` string, `access_deny` string, `forwards` string, `paused_until` string	`orbit services policy put <id>` `services_policy_put`

04

clients

端点	权限	参数	CLI · MCP 工具
`GET /services/{id}/clients` List client groups	只读	`id` integer	`orbit services clients list <id>` `services_clients_list`
`POST /services/{id}/clients` Create a client group	读写	`id` integer 请求体: `id` integer, `name` string, `client_id` string, `addrs` string, `tags` string, `enabled` boolean, `paused_until` string, `lists` string, `rules` string, `blocked_services` string, `safesearch` string, `block_mode` string, `log_mode` string	`orbit services clients create <id>` `services_clients_create`
`PATCH /services/{id}/clients/{client_id}` Update a client group	读写	`id` integer `client_id` integer 请求体: `id` integer, `name` string, `client_id` string, `addrs` string, `tags` string, `enabled` boolean, `paused_until` string, `lists` string, `rules` string, `blocked_services` string, `safesearch` string, `block_mode` string, `log_mode` string	`orbit services clients patch <id> <client_id>` `services_clients_patch`
`DELETE /services/{id}/clients/{client_id}` Delete a client group	读写	`id` integer `client_id` integer	`orbit services clients delete <id> <client_id>` `services_clients_delete`
`POST /services/{id}/clients/{client_id}/ddns-token` Issue or revoke a dynamic-address update token	读写	`id` integer `client_id` integer 请求体: `revoke` boolean	`orbit services clients token <id> <client_id>` `services_clients_token`

继续

相关文档

账户 API 参考

Orbit API 中账户的全部 10 个端点:方法与路径、所需令牌权限、参数,以及对应的命令行命令与 MCP 工具。

组织 API 参考

Orbit API 中组织的全部 10 个端点:方法与路径、所需令牌权限、参数,以及对应的命令行命令与 MCP 工具。

DNS API 参考

Orbit API 中 DNS 的全部 30 个端点:方法与路径、所需令牌权限、参数,以及对应的命令行命令与 MCP 工具。

← 全部文档