본 콘텐츠는 사용자의 편의를 고려해 자동 기계 번역 서비스를 사용하였습니다. 영어 원문과 다른 오류, 누락 또는 해석상의 미묘한 차이가 포함될 수 있습니다. 필요하시다면 영어 원문을 참조하시기를 바랍니다.
오늘 Cloudflare Registrar의 다음 장인 Registrar API 베타 버전이 출시됩니다.
Registrar API를 사용하면 도메인을 검색하고, 가용성을 확인하며, 프로그래밍 방식으로 도메인을 등록할 수 있습니다. 이제 아이디어가 실제로 느껴질 때 도메인을 구매하여 에이전트 기반 워크플로우에서 벗어날 필요가 없습니다.
Registrar API는 Cloudflare를 이용하는 빌더가 가장 자주 묻는 질문 중 하나입니다. 에이전트 워크플로우가 편집기, 터미널, 에이전트 기반 도구로 이동함에 따라 도메인 등록 문제는 해소해야 할 분명한 공백이 되었습니다.
7년 전 Cloudflare Registrar 를 출시했을 때의 아이디어는 단순했습니다. 도메인은 마크업 및 게임 없이 원가로 제공되어야 합니다. 그 이후로 Cloudflare Registrar는 더 많은 사람들이 다음 프로젝트를 구축하기 위해 Cloudflare를 선택하면서 세계에서 가장 빠르게 성장하는 등록 기관 중 하나가 되었습니다.
AI 코드 편집기 내에서 에이전트에 이름 아이디어를 생성하고, 도메인을 검색, 확인, 구매하도록 프롬프트를 표시합니다.
Registrar API는 내부 편집기, 배포 파이프라인, 백엔드 서비스, 에이전트 기반 워크플로우 등 이미 소프트웨어가 구축 중인 모든 곳에서 잘 작동하도록 설계되었습니다.
워크플로우는 의도적으로 단순하고 기계 친화적입니다. 검색은 후보자 이름을 반환합니다. 확인은 실시간 재고 및 가격을 반환합니다. Register는 최소한의 요청으로 즉시 완료할 수 있는 워크플로우 형태의 응답을 반환하고, 시간이 더 걸릴 경우 폴링합니다. 따라서 기존 API 클라이언트와 사용자를 대신하는 AI 에이전트 는 간편하게 사용할 수 있습니다.
실제로, 이 모든 과정은 에이전트가 이름 제안, 실제로 등록 가능한 사람 확인, 승인을 위한 가격 표시, 사용자에게 이미 사용 중인 도구를 강제로 밖으로 내보내지 않고 구매를 완료하는 등의 모든 과정에 도움을 줄 수 있음을 의미합니다.
Registrar API의 첫 번째 릴리스의 핵심은 세 가지 기능입니다.
선별된 인기 TLD 세트로 시작하려면 Registrar API 문서를 참조하세요. 지원되는 경우 프리미엄 도메인 도 등록할 수 있지만, 이를 위해서는 명시적인 요금 확인이 필요합니다.
Registrar API는 전체 Cloudflare API의 일부이므로, 현재 에이전트는 이미 Cloudflare MCP를 통해 액세스할 수 있습니다. 별도의 통합이나 사용자 지정 도구 정의가 필요하지 않습니다. Cursor, Claude Code 또는 모든 MCP 호환 환경에서 작업하는 에이전트는 전체 Cloudflare API 표면을 포함하는 동일한 search() 및 execute() 패턴을 사용하여 Registrar 엔드포인트를 검색하고 호출할 수 있습니다. API가 사양에 포함되는 순간부터 에이전트도 사용할 수 있게 됩니다.
실제로는 다음과 같은 모습입니다:
선호하는 AI 코드 편집기에서 새 프로젝트를 빌드합니다. 스캐폴딩 절반에서 에이전트에게 "좋은 .dev를 찾아주세요. 도메인을 새로 만들고 등록하세요."
에이전트는 귀사의 프로젝트를 기반으로 후보자의 이름을 검색합니다. 선택하신 품목의 실시간 가용성을 확인하여 가격을 확인합니다. '예'라고 답하면 그러면 계정의 기본 연락처 정보와 결제 방법을 사용하여 도메인이 자동으로 등록됩니다. 응답을 읽을 때쯤이면 도메인이 등록되고 개인정보 보호가 활성화됩니다.
세 가지 API 호출 몇 초입니다.
코드로 보면 다음과 같습니다:
검색 엔드포인트를 사용하여 도메인 확장자 유무에 관계없이 도메인 쿼리를 제출할 수 있습니다.
async () => {
return cloudflare.request({
method: "GET",
path: `/accounts/${accountId}/registrar/domain-search`,
query: { q: "acme corp", limit: 3 },
});
}
{
"success": true,
"errors": [],
"messages": [],
"result": {
"domains": [
{
"name": "acmecorp.com",
"registrable": true,
"tier": "standard",
"pricing": {
"currency": "USD",
"registration_cost": "8.57",
"renewal_cost": "8.57"
}
},
{
"name": "acmecorp.dev",
"registrable": true,
"tier": "standard",
"pricing": {
"currency": "USD",
"registration_cost": "10.11",
"renewal_cost": "10.11"
}
},
{
"name": "acmecorp.app",
"registrable": true,
"tier": "standard",
"pricing": {
"currency": "USD",
"registration_cost": "11.00",
"renewal_cost": "11.00"
}
}
]
}
}
검색 결과는 빠르지만, 신뢰할 수 없습니다. 캐시 데이터를 기반으로 하며 인기 있는 이름의 참석 여부는 몇 초만에 바뀔 수 있습니다. 확인 은 레지스트리를 직접 쿼리합니다. 등록 직전에 호출하고, 가격 응답을 출처로 활용합니다.
async () => {
return cloudflare.request({
method: "POST",
path: `/accounts/${accountId}/registrar/domain-check`,
body: { domains: ["acmecorp.dev"] },
});
}
{
"success": true,
"errors": [],
"messages": [],
"result": {
"domains": [
{
"name": "acmecorp.dev",
"registrable": true,
"tier": "standard",
"pricing": {
"currency": "USD",
"registration_cost": "10.11",
"renewal_cost": "10.11"
}
}
]
}
}
유일한 필수 필드는 도메인 이름입니다. WHOIS 개인정보 보호는 추가 비용 없이 기본적으로 활성화되어 있습니다. 계정에 기본 등록자 연락처가 있는 경우 API는 이 연락처를 자동으로 사용합니다. 그렇지 않은 경우, 요청 세부 정보를 인라인으로 제공하셔도 됩니다. 자동으로 기본 결제 방법이 사용됩니다.
async () => {
return cloudflare.request({
method: "POST",
path: `/accounts/${accountId}/registrar/registrations`,
body: { domain_name: "acmecorp.dev" },
});
}
{
"success": true,
"errors": [],
"messages": [],
"result": {
"domain_name": "acmecorp.dev",
"state": "succeeded",
"completed": true,
"created_at": "2025-10-27T10:00:00Z",
"updated_at": "2025-10-27T10:00:03Z",
"context": {
"registration": {
"domain_name": "acmecorp.dev",
"status": "active",
"created_at": "2025-10-27T10:00:00Z",
"expires_at": "2026-10-27T10:00:00Z",
"auto_renew": true,
"privacy_enabled": true,
"locked": true
}
},
"links": {
"self": "/accounts/abc/registrar/registrations/acmecorp.dev/registration-status",
"resource": "/accounts/abc/registrar/registrations/acmecorp.dev"
}
}
}
등록은 일반적으로 동기식으로 몇 초 이내에 완료됩니다. 시간이 더 오래 걸리면 API는 폴링할 워크플로 URL과 함께 202 Accepted를 반환합니다. 어느 쪽이든 응답 형태는 동일하며 특별한 케이스가 필요하지 않습니다. 프리미엄 도메인의 경우, Check 응답은 레지스트리가 설정한 정확한 가격을 반환하고, Register 요청은 이를 명시적인 수수료 알림으로 반환합니다.
에이전트 및 환불 불가 구매에 대한 참고 사항
에이전트가 사용자를 대신하여 도메인을 등록하면 기본 결제 방법에 요금이 부과됩니다. 도메인 등록이 완료된 후에는 환불이 불가능합니다. 잘 설계된 에이전트 흐름에서는 등록 엔드포인트를 호출하기 전에 사용자와 함께 도메인 이름과 가격을 확인해야 합니다. Check 단계는 정확히 해당 확인 단계를 명시적이고 명확하게 하기 위해 존재합니다. API는 API를 올바르게 구축할 수 있는 도구를 제공합니다. 이에 대한 책임은 에이전트의 로직에 있습니다.
기본적으로 API 문서에는 API 등록 호출 중에 사용자에게 권한을 요청하는 명시적인 에이전트 대면 지침이 있습니다. 하지만 사용자의 승인 없이 도메인을 구매하지 않는 에이전트 플로우를 설계하는 것은 인간의 책임입니다.
Cloudflare가 이를 다르게 할 수 있는 이유
현재 도메인 워크플로를 추가하는 많은 개발자 플랫폼과 Cloudflare의 차이점은 Cloudflare에서 등록 기관 자체를 운영한다는 점입니다. 즉, 프로젝트가 빌드되고 배포되는 동일한 플랫폼에서 마크업을 추가하지 않고도 도메인을 검색, 등록, 관리할 수 있습니다.
실제 원가 가격 책정은 Cloudflare 등록 기관 모델의 핵심입니다. Cloudflare는 레지스트리에서 부과하는 요금을 정확히 그대로 부과합니다. 이는 대시보드를 통해 도메인을 등록하든, API를 직접 호출하거나, 에이전트에게 귀사를 대신하여 등록해달라고 요청하든, 마찬가지입니다.
이 베타 버전은 도메인 수명 주기의 첫 번째 중요한 순간인 검색, 확인, 등록에 초점을 맞춥니다. Cloudflare에서는 핵심 Registrar 경험을 더 많이 포괄하여 API를 확장하기 위해 적극적으로 노력하고 있습니다. 따라서 도메인을 생성하는 순간뿐만 아니라 도메인을 구매한 후에도 프로그래밍 방식으로 관리할 수 있습니다. 여기에는 이전, 갱신, 연락처 업데이트 등의 수명 주기 요소가 포함됩니다.
API는 더 광범위한 서비스형 등록 기관 제품을 향한 첫 번째 단계입니다. 해당 서비스는 현재 개발 중이며, 올해 말 출시를 목표로 하고 있습니다. API가 확장되면 웹 사이트 빌더, 호스팅 공급자, AI 제품, 기타 다중 테넌트 애플리케이션과 같은 플랫폼에서 도메인 등록을 사용자 경험의 일부로 만들 수 있습니다. 사용자는 도메인을 검색하고, 구매하고, 이미 구축한 서비스나 에이전트 기반 워크플로를 벗어나지 않고도 프로비저닝할 수 있습니다.
Registrar API는 빌더가 요청하기 때문에 존재합니다. 이제 베타 버전으로 제공되므로, Cloudflare 커뮤니티, X 또는 Discord에서 여러분이 무엇을 구축하시는지 보고 싶습니다.
시작 방법:
누락된 부분이 있거나, 워크플로가 제대로 작동하지 않거나, 더 규모가 큰 플랫폼 사용 사례를 구축하고 있다면 알려주시기 바랍니다. Cloudflare는 도메인 갱신, 이전 등을 지원할 수 있도록 API의 기능을 확장하기 위해 빠르게 노력하고 있습니다.
여러분이 무엇을 구축해나갈지 정말 기대됩니다!
Registrar API 베타 서비스를 제공하는 데 귀중한 기여를 해준 Lucy Dryava와 Fred Pinto에게 특별히 감사의 말씀을 전합니다.