NYMWELL 的基礎
清楚的 API 與 Key 模型。
控制台與 MCP 共用的 REST API：同樣的操作、同樣的核准。
註冊、續約、轉入與網域變更，只在伺服器已設定註冊商與金流時執行；
nymwell_status 與 GET /api/v1/status 會說明目前狀態。未設定時這些呼叫回傳 integration_not_configured，不會收費。| Method | Endpoint | 用途 |
|---|---|---|
| GET | /api/v1/status | 目前設定：註冊商、金流、webhook |
| GET | /api/v1/domains/search?domain= | 向註冊商查可註冊性與價格（公開、限流） |
| GET | /api/v1/domains/suggest?q= | 依關鍵字取得建議（公開） |
| GET | /api/v1/domains/tld-info?tlds= | 網域結尾價格與規則（公開） |
| GET | /api/v1/domains/screen?q= | RDAP＋DNS 初篩，非可註冊性（公開） |
| POST | /api/v1/quotes | 註冊、續約或轉入報價，鎖價 40 分鐘 |
| POST | /api/v1/renewals | 續約報價 |
| POST | /api/v1/transfers | 持有人提交授權碼，回傳轉入報價 |
| GET | /api/v1/transfers | 轉入清單與狀態 |
| POST | /api/v1/orders | 為報價付款：回傳結帳網址 |
| GET | /api/v1/orders?id= | 訂單狀態 |
| GET | /api/v1/domains/detail?domain= | 網域在註冊商的即時狀態 |
| POST | /api/v1/domains/auto-renew | 續約偏好 |
| POST | /api/v1/domains/settings | 隱私或轉移鎖（需核准） |
| POST | /api/v1/domains/nameservers | 名稱伺服器（需核准） |
| POST | /api/v1/domains/contacts | 聯絡人（需核准） |
| POST | /api/v1/domains/auth-code | 解鎖並顯示授權碼（需核准） |
| POST | /api/v1/domains/cancel | 寬限期內取消並退款（需核准） |
| GET | /api/v1/domains/services?domain=&service= | DNSSEC、網址／郵件轉寄、自有名稱伺服器 |
| POST | /api/v1/domains/services | 變更上述服務（需核准） |
| POST | /api/v1/transfers/cancel | 取消轉入或轉出（需核准） |
| GET | /api/v1/dns/records?domain=&refresh=1 | DNS 紀錄，可重新讀取註冊商 |
| POST | /api/v1/dns/change-sets | 新增、修改、刪除紀錄（需核准） |
| GET | /api/v1/contacts/unverified | 待驗證的登記人 |
| POST | /api/v1/contacts/resend | 重寄驗證信 |
| GET | /api/v1/approvals | 等待核准的變更 |
| POST | /api/v1/approvals | 核准或拒絕（限本人） |
| POST | /api/v1/api-keys | 一次性簽發限定 agent key |
| POST | /api/v1/webhooks/namecom | 註冊商事件，HMAC 驗證 |
API Key
傳送 X-Nymwell-Key。Key 以 nw_live_ 或 nw_test_ 開頭。
{
"domain": "example.com",
"action": "renew",
"years": 1,
"currency": "USD"
}