{"components":{"securitySchemes":{"bearerAuth":{"description":"API 令牌（paomi_mcp_ 前缀）。scope：api=域名读，api:write=域名写（隐含 api，会扣余额），ssl=证书读，ssl:renew=证书免费重签（隐含 ssl，不扣余额），mcp=MCP 接入。域名与证书范围互不包含。令牌与接入状态在控制台开发者页管理。","scheme":"bearer","type":"http"}}},"info":{"description":"域名业务开放 API：查询、目录、账户域名与联系人、报价与注册/续费/转入，以及证书下载和免费重签。订单、充值、工单不在开放范围。","title":"泡米网开发者 API","version":"1.0.0"},"openapi":"3.1.0","paths":{"/account":{"get":{"description":"返回账户 ID、会员档与可用余额（下单前自查额度）。","responses":{"200":{"description":"成功，统一响应包 {data: ...}"},"400":{"description":"参数错误 {error:{code,message}}"},"401":{"description":"缺少或无效令牌"},"403":{"description":"scope 不足、接入停用或验证未完成"},"429":{"description":"超出限流档位"}},"security":[{"bearerAuth":[]}],"summary":"账户概览","x-required-scope":"api"}},"/contacts":{"get":{"description":"返回 WHOIS 联系人资料库。","responses":{"200":{"description":"成功，统一响应包 {data: ...}"},"400":{"description":"参数错误 {error:{code,message}}"},"401":{"description":"缺少或无效令牌"},"403":{"description":"scope 不足、接入停用或验证未完成"},"429":{"description":"超出限流档位"}},"security":[{"bearerAuth":[]}],"summary":"联系人列表","x-required-scope":"api"}},"/contacts/{id}":{"get":{"description":"返回单个联系人详情。","responses":{"200":{"description":"成功，统一响应包 {data: ...}"},"400":{"description":"参数错误 {error:{code,message}}"},"401":{"description":"缺少或无效令牌"},"403":{"description":"scope 不足、接入停用或验证未完成"},"429":{"description":"超出限流档位"}},"security":[{"bearerAuth":[]}],"summary":"联系人详情","x-required-scope":"api"}},"/domains":{"get":{"description":"分页返回账户域名。","parameters":[{"description":"状态过滤","in":"query","name":"status","required":false,"schema":{"type":"string"}},{"description":"","in":"query","name":"page","required":false,"schema":{"type":"integer"}},{"description":"","in":"query","name":"page_size","required":false,"schema":{"description":"默认 20","type":"integer"}}],"responses":{"200":{"description":"成功，统一响应包 {data: ...}"},"400":{"description":"参数错误 {error:{code,message}}"},"401":{"description":"缺少或无效令牌"},"403":{"description":"scope 不足、接入停用或验证未完成"},"429":{"description":"超出限流档位"}},"security":[{"bearerAuth":[]}],"summary":"域名列表","x-required-scope":"api"}},"/domains/registrations":{"post":{"description":"从余额扣款注册域名；履约异步进行。必须携带 Idempotency-Key。","requestBody":{"content":{"application/json":{"schema":{"properties":{"accept_claims":{"description":"命中商标声明时设为 true 表示已阅读并接受声明","type":"boolean"},"accept_https":{"description":"后缀强制 HTTPS 时设为 true 表示已知晓并同意","type":"boolean"},"contact_id":{"description":"联系人 ID，同时套用到 registrant/admin/tech/billing 四类角色","type":"string"},"contacts":{"description":"按角色分别指定联系人，缺省角色回落到 contact_id","properties":{"admin":{"type":"string"},"billing":{"type":"string"},"registrant":{"type":"string"},"tech":{"type":"string"}},"type":"object"},"domain":{"format":"完整域名","type":"string"},"years":{"description":"年限，默认 1","type":"integer"}},"required":["domain"],"type":"object"}}},"required":true},"responses":{"200":{"description":"成功，统一响应包 {data: ...}"},"400":{"description":"参数错误 {error:{code,message}}"},"401":{"description":"缺少或无效令牌"},"403":{"description":"scope 不足、接入停用或验证未完成"},"429":{"description":"超出限流档位"}},"security":[{"bearerAuth":[]}],"summary":"注册域名","x-idempotency":"必须携带 Idempotency-Key 头；相同键在 24 小时内重放同一响应","x-required-scope":"api:write"}},"/domains/transfers":{"post":{"description":"提交域名转入并扣款；需转移密码，履约异步进行。必须携带 Idempotency-Key。","requestBody":{"content":{"application/json":{"schema":{"properties":{"accept_claims":{"description":"命中商标声明时设为 true 表示已阅读并接受声明","type":"boolean"},"auth_code":{"format":"转移密码","type":"string"},"contact_id":{"description":"联系人 ID，同时套用到 registrant/admin/tech/billing 四类角色","type":"string"},"contacts":{"description":"按角色分别指定联系人，缺省角色回落到 contact_id","properties":{"admin":{"type":"string"},"billing":{"type":"string"},"registrant":{"type":"string"},"tech":{"type":"string"}},"type":"object"},"domain":{"format":"完整域名","type":"string"}},"required":["domain","auth_code"],"type":"object"}}},"required":true},"responses":{"200":{"description":"成功，统一响应包 {data: ...}"},"400":{"description":"参数错误 {error:{code,message}}"},"401":{"description":"缺少或无效令牌"},"403":{"description":"scope 不足、接入停用或验证未完成"},"429":{"description":"超出限流档位"}},"security":[{"bearerAuth":[]}],"summary":"转入域名","x-idempotency":"必须携带 Idempotency-Key 头；相同键在 24 小时内重放同一响应","x-required-scope":"api:write"}},"/domains/{id}":{"get":{"description":"返回单个账户域名详情。","responses":{"200":{"description":"成功，统一响应包 {data: ...}"},"400":{"description":"参数错误 {error:{code,message}}"},"401":{"description":"缺少或无效令牌"},"403":{"description":"scope 不足、接入停用或验证未完成"},"429":{"description":"超出限流档位"}},"security":[{"bearerAuth":[]}],"summary":"域名详情","x-required-scope":"api"}},"/domains/{id}/renewals":{"post":{"description":"按账户域名 ID 续费；履约异步进行。必须携带 Idempotency-Key。","requestBody":{"content":{"application/json":{"schema":{"properties":{"years":{"description":"年限，默认 1","type":"integer"}},"type":"object"}}},"required":true},"responses":{"200":{"description":"成功，统一响应包 {data: ...}"},"400":{"description":"参数错误 {error:{code,message}}"},"401":{"description":"缺少或无效令牌"},"403":{"description":"scope 不足、接入停用或验证未完成"},"429":{"description":"超出限流档位"}},"security":[{"bearerAuth":[]}],"summary":"续费域名","x-idempotency":"必须携带 Idempotency-Key 头；相同键在 24 小时内重放同一响应","x-required-scope":"api:write"}},"/lookup":{"get":{"description":"查询单个域名可用性与本档公开价；裸名（不含点）按 suffixes 或全部可售后缀展开。带令牌时返回会员档价。","parameters":[{"description":"完整域名或裸名","in":"query","name":"domain","required":true,"schema":{"type":"string"}},{"description":"逗号分隔后缀列表，裸名时限定展开范围","in":"query","name":"suffixes","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"成功，统一响应包 {data: ...}"},"400":{"description":"参数错误 {error:{code,message}}"},"401":{"description":"缺少或无效令牌"},"403":{"description":"scope 不足、接入停用或验证未完成"},"429":{"description":"超出限流档位"}},"summary":"域名实时查询"}},"/lookup/batch":{"post":{"description":"domains 为完整域名列表（精确匹配），或 name + suffixes 组合展开。单请求最多 100 个目标，超出请分批。","requestBody":{"content":{"application/json":{"schema":{"properties":{"domains":{"description":"完整域名列表","items":{"type":"string"},"type":"array"},"name":{"description":"裸名，配合 suffixes 展开","type":"string"},"suffixes":{"description":"后缀列表，缺省展开全部可售后缀","items":{"type":"string"},"type":"array"}},"type":"object"}}},"required":true},"responses":{"200":{"description":"成功，统一响应包 {data: ...}"},"400":{"description":"参数错误 {error:{code,message}}"},"401":{"description":"缺少或无效令牌"},"403":{"description":"scope 不足、接入停用或验证未完成"},"429":{"description":"超出限流档位"}},"summary":"批量域名查询"}},"/prices":{"get":{"description":"按调用者会员档返回已发布的注册/续费/转入价目。","responses":{"200":{"description":"成功，统一响应包 {data: ...}"},"400":{"description":"参数错误 {error:{code,message}}"},"401":{"description":"缺少或无效令牌"},"403":{"description":"scope 不足、接入停用或验证未完成"},"429":{"description":"超出限流档位"}},"summary":"公开价目"}},"/prices/offers":{"get":{"description":"按会员档返回各上游渠道的公开报价对比。","responses":{"200":{"description":"成功，统一响应包 {data: ...}"},"400":{"description":"参数错误 {error:{code,message}}"},"401":{"description":"缺少或无效令牌"},"403":{"description":"scope 不足、接入停用或验证未完成"},"429":{"description":"超出限流档位"}},"summary":"多渠道报价"}},"/quote":{"get":{"description":"对注册/续费/转入动作返回实时报价与可结算状态，不产生订单。","parameters":[{"description":"完整域名","in":"query","name":"domain","required":true,"schema":{"type":"string"}},{"description":"register | renew | transfer_in，默认 register","in":"query","name":"kind","required":false,"schema":{"type":"string"}},{"description":"年限，默认 1","in":"query","name":"years","required":false,"schema":{"type":"integer"}},{"description":"转入时的转移密码","in":"query","name":"auth_code","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"成功，统一响应包 {data: ...}"},"400":{"description":"参数错误 {error:{code,message}}"},"401":{"description":"缺少或无效令牌"},"403":{"description":"scope 不足、接入停用或验证未完成"},"429":{"description":"超出限流档位"}},"security":[{"bearerAuth":[]}],"summary":"下单前报价","x-required-scope":"api"}},"/ssl/certificates":{"get":{"description":"返回当前令牌所属用户已签发的证书。不含上游厂商、成本和私钥。","responses":{"200":{"description":"成功，统一响应包 {data: ...}"},"400":{"description":"参数错误 {error:{code,message}}"},"401":{"description":"缺少或无效令牌"},"403":{"description":"scope 不足、接入停用或验证未完成"},"429":{"description":"超出限流档位"}},"security":[{"bearerAuth":[]}],"summary":"证书列表","x-required-scope":"ssl"}},"/ssl/certificates/{id}":{"get":{"description":"返回到期日、订阅结束日，以及进行中的文件和 CNAME 验证材料。","responses":{"200":{"description":"成功，统一响应包 {data: ...}"},"400":{"description":"参数错误 {error:{code,message}}"},"401":{"description":"缺少或无效令牌"},"403":{"description":"scope 不足、接入停用或验证未完成"},"429":{"description":"超出限流档位"}},"security":[{"bearerAuth":[]}],"summary":"证书详情","x-required-scope":"ssl"}},"/ssl/certificates/{id}/download/{file}":{"get":{"description":"下载当前已核对通过的证书文件。file 为 fullchain.crt、domain.crt、chain.crt 或 domain.p7b，不含私钥。","responses":{"200":{"description":"成功，统一响应包 {data: ...}"},"400":{"description":"参数错误 {error:{code,message}}"},"401":{"description":"缺少或无效令牌"},"403":{"description":"scope 不足、接入停用或验证未完成"},"429":{"description":"超出限流档位"}},"security":[{"bearerAuth":[]}],"summary":"下载证书","x-required-scope":"ssl"}},"/ssl/certificates/{id}/reissues":{"post":{"description":"订阅有效期内用原 CSR 免费重签，不扣款。method 为 file 或 cname，省略时按文件验证；通配符不能用文件验证。必须携带 Idempotency-Key。","requestBody":{"content":{"application/json":{"schema":{"properties":{"method":{"format":"file 或 cname，省略时按 file","type":"string"}},"type":"object"}}},"required":true},"responses":{"200":{"description":"成功，统一响应包 {data: ...}"},"400":{"description":"参数错误 {error:{code,message}}"},"401":{"description":"缺少或无效令牌"},"403":{"description":"scope 不足、接入停用或验证未完成"},"429":{"description":"超出限流档位"}},"security":[{"bearerAuth":[]}],"summary":"免费重签","x-idempotency":"必须携带 Idempotency-Key 头；相同键在 24 小时内重放同一响应","x-required-scope":"ssl:renew"}},"/ssl/certificates/{id}/validation/check":{"post":{"description":"验证材料放好后请厂商复查。不支持立即复查的厂商返回 checked=false，调用方继续轮询。必须携带 Idempotency-Key。","responses":{"200":{"description":"成功，统一响应包 {data: ...}"},"400":{"description":"参数错误 {error:{code,message}}"},"401":{"description":"缺少或无效令牌"},"403":{"description":"scope 不足、接入停用或验证未完成"},"429":{"description":"超出限流档位"}},"security":[{"bearerAuth":[]}],"summary":"复查验证","x-idempotency":"必须携带 Idempotency-Key 头；相同键在 24 小时内重放同一响应","x-required-scope":"ssl:renew"}},"/suffixes":{"get":{"description":"返回全部在售后缀、类型与描述。","responses":{"200":{"description":"成功，统一响应包 {data: ...}"},"400":{"description":"参数错误 {error:{code,message}}"},"401":{"description":"缺少或无效令牌"},"403":{"description":"scope 不足、接入停用或验证未完成"},"429":{"description":"超出限流档位"}},"summary":"可售后缀目录"}},"/tld-wiki":{"get":{"description":"返回已发布的后缀百科条目。","responses":{"200":{"description":"成功，统一响应包 {data: ...}"},"400":{"description":"参数错误 {error:{code,message}}"},"401":{"description":"缺少或无效令牌"},"403":{"description":"scope 不足、接入停用或验证未完成"},"429":{"description":"超出限流档位"}},"summary":"后缀百科列表"}},"/tld-wiki/{suffix}":{"get":{"description":"返回指定后缀的百科详情：事实卡片、章节内容。","parameters":[{"description":"后缀，如 com、.shop","in":"path","name":"suffix","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"成功，统一响应包 {data: ...}"},"400":{"description":"参数错误 {error:{code,message}}"},"401":{"description":"缺少或无效令牌"},"403":{"description":"scope 不足、接入停用或验证未完成"},"429":{"description":"超出限流档位"}},"summary":"后缀百科详情"}},"/usage":{"get":{"description":"返回当前令牌近 N 天按日调用量与限流档位。","parameters":[{"description":"统计天数，1-45，默认 7","in":"query","name":"days","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"description":"成功，统一响应包 {data: ...}"},"400":{"description":"参数错误 {error:{code,message}}"},"401":{"description":"缺少或无效令牌"},"403":{"description":"scope 不足、接入停用或验证未完成"},"429":{"description":"超出限流档位"}},"security":[{"bearerAuth":[]}],"summary":"令牌用量","x-required-scope":"api"}}},"servers":[{"url":"https://paomi.com/api/v1"}],"x-rate-limits":{"guest_per_minute":30,"mcp_per_minute":120,"read_per_minute":120,"write_per_minute":20}}