도메인 API - API 명령어 목록

다이나닷 API

우리의 RESTful API 시작하기

Dynadot API는 귀하의 시스템과 원활하게 통합되도록 설계되었습니다. 저희 API는 예측 가능한 리소스 지향 URL을 제공하며, JSON 인코딩된 요청 본문을 지원하고, JSON 인코딩 및 XML 인코딩된 응답을 반환하며, 표준 HTTP 메서드, 인증 및 응답 코드를 준수합니다.Dynadot API는 테스트 모드와 라이브 모드 모두에서 사용할 수 있습니다. 모드는 요청을 인증하는 데 사용되는 API 키에 따라 결정됩니다. 테스트 모드는 라이브 데이터나 거래에 영향을 주지 않고 API 통합을 시뮬레이션하고 검증할 수 있도록 해줍니다.Dynadot API는 주로 도메인 관리, 주문 처리 및 관련 서비스에 중점을 두고 있습니다. 도메인을 등록, 이전 및 갱신하고, DNS 설정을 관리하며, 계정 주문을 조회하거나 업데이트하는 등의 작업을 수행할 수 있습니다.참고해 주십시오: 대량 생성, 업데이트, 삭제는 지원되지 않으며, 각 요청 유형은 하나의 객체 또는 작업으로 제한됩니다.

API 키 생성하기API 요청을 시작하기 전에, API 키와 API 비밀 키를 생성하는 것이 필수적입니다.이 키는 인증을 위해 필요하며, API와 상호작용할 때 귀하의 행동의 보안을 보장합니다.계정 설정의 API 섹션을 통해 API 키와 API 비밀을 모두 생성할 수 있습니다.1. Dynadot 계정에 로그인하세요.2. 도구 > API로 이동합니다.3. 이 페이지에서 API 키와 API 비밀키를 생성하세요.

우리 커뮤니티에 참여하세요아이디어나 제안이 있으신가요? 저희 전문 엔지니어와 직접 이야기해 보세요.Discord

HTTP 메서드API는 리소스에 대한 작업을 수행하기 위해 표준 HTTP 메서드를 사용합니다:

Method	Description
GET	GET Request: Retrieve detailed information about a specified resource
POST	POST Request: Create a new resource
PUT	PUT Request: Fully update the specified resource
DELETE	DELETE Request: Remove the specified resource

URL

모든 API 요청의 기본 URL은:https://api.dynadot.com/

전체 URL 형식:http://api.dynadot.com/restful/version_code/resource/{resource_identify}/action

https://api.dynadot.com/restful/v1/domains/{domain_name}/search

Version

현재 API 버전은v2.0.0

API 요청 URL을 구성할 때는 주요 버전만 포함하면 됩니다. 부 버전 및 패치 업데이트는 이전 버전과의 호환성을 유지하도록 설계되어 있으며, 기존 코드를 깨뜨리는 변경 사항을 도입하지 않습니다. 이를 통해 안정성을 보장하면서도 구현을 수정할 필요 없이 점진적인 개선 및 수정의 혜택을 누릴 수 있습니다.향후 버전이 출시될 때, 우리는 일정 기간 동안 이전 버전과의 호환성을 유지할 것입니다. 새로운 기능과 주요 변경 사항은 주요 버전 증가에서 도입될 것입니다.

HeaderAPI 요청의 헤더에는 요청에 대한 메타데이터가 포함되어 있습니다. 이 메타데이터는 서버가 요청을 적절하게 처리하는 데 필요한 중요한 맥락을 제공합니다. 일반적으로 사용되는 헤더는 다음과 같습니다:

Content-Type요청 본문에 전송되는 데이터의 형식을 지정합니다. 서버는 이 정보를 사용하여 요청을 올바르게 구문 분석합니다. 현재 허용되는 유일한 값은: application/json입니다.

Content-Type: application/json

수락합니다클라이언트가 기대하는 응답 형식을 서버에 알립니다.가능한 값: application/json, application/xml

Accept: application/json

권한 부여모든 API 요청에는 인증을 위한 API 키가 포함되어야 합니다. API 키는 계정 대시보드에서 확인하실 수 있습니다.You can generate an API key in API setting page

Authorization: Bearer YOUR_API_KEY

X-Request-IDX-Request-ID 헤더는 각 API 요청을 고유하게 식별하는 데 사용되는 선택적 헤더입니다. 이 헤더가 포함되면 시스템과 로그 전반에 걸쳐 요청을 추적하고 연관짓는 데 도움이 되어 API 활동을 디버깅하고 모니터링하는 것이 더 쉬워집니다.X-Request-ID의 값은 유효한 UUID (전 세계적으로 고유한 식별자)여야 하며, 표준 형식에 따라야 합니다: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx (예: 123e4567-e89b-12d3-a456-426614174000).

X-Request-ID: 550e8400-e29b-41d4-a716-446655440000

X-서명X-Signature 헤더는 민감한 정보를 검색하거나 데이터를 업데이트하는 요청을 포함한 거래 요청에 대한 필수 보안 메커니즘입니다. 이 헤더는 클라이언트가 HMAC-SHA256을 사용하여 요청 페이로드에 서명하도록 요구함으로써 API 요청의 진정성, 무결성 및 부인 방지를 보장합니다.

서명을 생성하려면 다음 값을 입력해야 합니다.API 키: 귀하의 고유한 API 키입니다.2. 전체 경로 및 쿼리: 쿼리 매개변수와 함께 API 엔드포인트의 전체 경로입니다.3. X-Request-Id: 요청 ID입니다. 사용 가능하지 않은 경우, 빈 문자열을 입력할 수 있습니다.4. 요청 본문: 요청의 본문입니다. 비어 있거나 null인 경우, 빈 문자열을 입력할 수 있습니다.

서명할 문자열은 위에서 언급한 값들을 다음 순서로 연결한 조합입니다:

apiKey + "\n" + fullPathAndQuery + "\n" + (xRequestId or empty String) + "\n" + (requestBody or empty String)

apiKey = "your_api_key"
fullPathAndQuery = "/v1/some/endpoint?param=value"
xRequestId = "unique-request-id"
requestBody = "{\"key\":\"value\"}"


stringToSign = "your_api_key\n/v1/some/endpoint?param=value\nunique-request-id\n{\"key\":\"value\"}"

HMAC-SHA256 서명 생성하기문자열을 서명한 후, 비밀 키를 사용하여 HMAC-SHA256 암호화를 적용해야 합니다. 이 과정에서 서명이 생성됩니다.서명은 다음 단계에 따라 생성됩니다:1. HMAC-SHA256 알고리즘을 사용하세요. 2. Use the stringToSign as the input message.비밀을 키로 사용하세요.
요청 헤더에서 X-Signature의 값으로 생성된 signature를 적용하세요.

X-Signature: {HMAC-SHA256 Signature}

BodyAPI 요청의 본문은 서버에 데이터를 전송하는 데 사용됩니다. 일반적으로 POST, PUT 또는 PATCH 요청에 포함되며 (GET 또는 DELETE 요청에는 일반적으로 포함되지 않습니다).

Content Format본문 데이터의 형식은 Content-Type 헤더에 의해 결정됩니다. 일반적인 형식으로는 다음과 같은 것들이 있습니다:

{
    "domainName": "domain.com",
    "showPrice": "yes",
    "currency": "USD"
}

일반적인 사용 사례POST 요청: POST 메소드는 서버에 새로운 리소스를 생성하는 데 사용됩니다. 요청 본문에는 일반적으로 리소스 세부 정보가 포함됩니다.PUT 요청: PUT 메서드는 기존 리소스를 완전히 교체하여 업데이트하는 데 사용됩니다. 요청 본문에는 완전한 업데이트된 리소스가 포함됩니다.DELETE 요청: DELETE 메서드는 서버에서 기존 리소스를 제거하는 데 사용됩니다. 요청 본문이 없습니다.GET 요청: GET 메서드는 서버에서 기존 리소스를 검색하는 데 사용됩니다. 요청 본문이 없습니다

Response Format모든 API 응답은 JSON 또는 XML 형식으로 반환되며, 본문 데이터의 형식은 Accept 헤더에 의해 결정됩니다. 요청된 데이터 또는 해당되는 경우 오류 메시지를 제공합니다.

Content FormatThe response in general contains 3 parts: Code, Message, Data

코드: 요청의 상태메시지: 상태에 대한 더 많은 설명데이터: 응답의 본문

{
    "Code": "200",
    "Message": "Success",
    "Data": {}
}

오류 처리HTTP 상태 코드는 클라이언트의 요청 결과를 나타내기 위해 서버가 반환하는 표준화된 세 자리 숫자입니다. 이 코드는 요청이 성공적으로 처리되었는지, 추가 조치가 필요한지, 또는 오류가 발생했는지에 대한 중요한 정보를 제공합니다. 이러한 코드는 다섯 가지 범주로 나뉘며, 각 범주는 고유한 유형의 응답을 나타냅니다.우리 API의 상태 코드는 HTTP/1.1 프로토콜을 준수합니다. 이는 일관되고 신뢰할 수 있는 통신을 보장하는 널리 인정받는 표준입니다. HTTP/1.1을 사용함으로써 우리는 지속적인 연결 및 향상된 캐싱과 같은 기능을 활용하여 클라이언트-서버 상호작용을 최적화합니다.

2xx (성공): 명령이 수신되어 수락되었음을 나타냅니다.

200상태 코드는 요청이 성공했음을 나타냅니다.

201상태 코드는 요청이 완료되었으며 하나 이상의 새로운 리소스가 생성되었음을 나타냅니다.

202상태 코드는 요청이 처리 중으로 수락되었지만, 처리가 완료되지 않았음을 나타냅니다.

249사용자가 주어진 시간 내에 너무 많은 요청을 보냈습니다.

4xx (클라이언트 오류): 클라이언트가 요청에서 오류를 발생시켰음을 나타내며, 예를 들어 잘못된 입력을 제공하거나 적절한 권한이 부족한 경우입니다.

400상태 코드는 서버가 클라이언트 오류로 인식되는 이유로 인해 요청을 처리할 수 없거나 처리하지 않겠다는 것을 나타냅니다.

401상태 코드는 요청이 대상 리소스에 대한 유효한 인증 자격 증명이 부족하여 적용되지 않았음을 나타냅니다.

402상태 코드는 결제 문제로 인해 요청이 적용되지 않았음을 나타냅니다.

403상태 코드는 서버가 요청을 이해했지만 이를 이행하기를 거부한다는 것을 나타냅니다.

404상태 코드는 원본 서버가 대상 리소스에 대한 현재 표현을 찾지 못했거나 해당 표현이 존재한다는 사실을 공개할 의사가 없음을 나타냅니다.

409요청을 완료할 수 없습니다. 현재 리소스의 상태와 충돌이 발생했습니다.

5xx (서버 오류): 서버가 오류를 만나거나 요청을 처리할 수 없음을 나타냅니다.

500상태 코드는 서버가 요청을 이행하는 데 방해가 되는 예상치 못한 상황을 만났음을 나타냅니다.

501상태 코드는 서버가 요청을 이행하는 데 필요한 기능을 지원하지 않음을 나타냅니다.

502상태 코드는 서버가 게이트웨이 또는 프록시 역할을 하면서 요청을 처리하기 위해 접근한 인바운드 서버로부터 유효하지 않은 응답을 받았음을 나타냅니다.

503상태 코드는 서버가 현재 일시적인 과부하 또는 예정된 유지보수로 인해 요청을 처리할 수 없음을 나타냅니다. 이 문제는 일정 시간이 지난 후 완화될 가능성이 높습니다.

504상태 코드는 서버가 게이트웨이 또는 프록시 역할을 하면서 요청을 완료하기 위해 접근해야 하는 상위 서버로부터 적시에 응답을 받지 못했음을 나타냅니다.

코드상태 이름

200성공

201생성한

202Accepted

249요청이 너무 많습니다.

400잘못된 요청

401무단 접근

402결제가 필요합니다

403금지됨

404찾을 수 없습니다

409갈등

500내부 서버 오류

501구현되지 않음

502잘못된 게이트웨이

503서비스를 사용할 수 없습니다

504게이트웨이 타임아웃

속도 제한요청은 보안을 위해 https(보안 소켓)를 통해 전송해야 합니다. 한 번에 1개의 요청만 처리할 수 있으므로, 다른 요청을 보내기 전에 현재 요청이 완료될 때까지 기다려 주시기 바랍니다.

계정의 가격 수준에 따라 다양한 스레드 수를 받게 됩니다:

Price level	Thread Count	Rate Limit
Regular	1 thread	60/min (1/sec)
Bulk	5 threads	600/min (10/sec)
Super Bulk	25 threads	6000/min (100/sec)

참고: place_auction_bid & get_auction_bid은 현재 위의 속도 제한에서 제외됩니다.

<Response>
  <status>
    <code>429</code>
    <message>Too Many Requests</message>
  </status>
  <error>
    <description>You have reached the maximum allowed requests within the concurrent limit of your account. Please try again later.</description>
  </error>
</Response>

{
  "code": 429,
  "message": "Too Many Requests",
  "error": {
    "description": "You have reached the maximum allowed requests within the concurrent limit of your account. Please try again later."
  }
}

변경 로그 개요

변경 로그는 API의 각 버전에서 도입된 변경 사항, 개선 사항, 버그 수정 및 새로운 기능에 대한 자세한 기록입니다. 이는 각 업데이트의 영향을 문서화하여 사용자와 개발자에게 투명성을 제공합니다. 변경 로그는 두 가지 주요 부분으로 구성됩니다:

API 버전이 부분에서는 API의 버전 관리 시스템을 강조합니다. 이 시스템은 개발자들이 기능의 발전을 추적하고 호환성을 보장하는 데 도움을 줍니다. 각 API 버전은 고유한 버전 번호(예: v1.0.1, v2.2.3)로 식별되며, 이는 중요한 이정표나 릴리스를 나타냅니다. 버전 관리를 통해 사용자는 준비가 되었을 때 업데이트를 선택하여 최소한의 중단으로 통합을 유지할 수 있습니다.

변경 로그 기록변경 로그 히스토리는 각 버전에서 도입된 업데이트, 버그 수정, 사용 중단 및 개선 사항에 대한 자세한 정보를 제공합니다. 이 문서는 엔드포인트, 매개변수, 인증 메커니즘 또는 응답 형식에 대해 이루어진 특정 변경 사항을 설명합니다. 이 섹션은 개발자들이 변경된 사항에 대해 완전한 투명성을 갖고 그에 따라 구현을 조정할 수 있도록 보장합니다. 명확하고 상세한 변경 로그를 유지함으로써, 우리는 개발자들이 통합을 효과적이고 자신 있게 관리하는 데 필요한 도구와 정보를 제공하는 것을 목표로 합니다.

API 버전

우리 API는 현재 버전에 있습니다.v2.0.0

버전 코드는 API 업데이트를 체계적으로 식별하고 관리하는 데 사용됩니다. 이들은 의미론적 버전 관리(Semantic Versioning, SemVer) 형식을 따릅니다:

버전 코드의 각 구성 요소는 특정한 목적을 가지고 있으며, 개발자들이 변경 사항의 범위와 유형을 효과적으로 전달하는 데 도움을 줍니다.

주요 버전정의: 이전 버전과의 호환성을 깨뜨릴 수 있는 중요한 변화를 나타냅니다.Format:<Major>.x.x

예시:v1.0.0->v2.0.0완전한 API 재설계 또는 호환되지 않는 스키마 변경.

마이너 버전정의: 이전 버전과 호환되는 기능 추가를 나타냅니다.Format:x.<Minor>.x

예시:v1.0.0->v1.1.0새로운 엔드포인트나 메서드를 추가하면서 이전 버전과의 호환성을 유지합니다.

패치 버전정의: 이전 버전과 호환되는 버그 수정 또는 소규모 개선 사항을 의미합니다.Format:x.x.<Patch>

예시:v1.0.0->v1.1.0API 엔드포인트의 작은 버그 수정.

API 변경 로그

변경 로그는 소프트웨어 또는 API의 각 버전에서 도입된 변경 사항, 개선 사항, 버그 수정 및 새로운 기능에 대한 자세한 기록입니다. 이는 각 업데이트의 영향을 문서화하여 사용자와 개발자에게 투명성을 제공합니다.

변경 로그의 일반적인 항목은 다음과 같습니다:설명: 변경된 내용에 대한 간단한 설명입니다.영향을 받는 구성 요소: 변경으로 인해 영향을 받는 특정 모듈, 엔드포인트 또는 기능.

예시: 이 새로운 API 명령에 대한 지원이 추가되었습니다.<Domain Register>

변경 로그 기록Dynadot API의 모든 변경 사항을 추적하세요.

March 15, 2025

v1.0.0The Dynadot API 1.0.0 introduces a RESTful interface designed for seamless integration with your systems.

It features predictable resource-oriented URLs, supports standard HTTP methods and authentication, and returns responses in both JSON and XML formats.

Each request processes a single object or action, as bulk updates are not supported.

This version focuses on core domain management, order processing, and related services.
Users can register, transfer, and renew domains, manage DNS settings, view or update account orders, as well as access functionalities for aftermarket, site builder, email hosting, and more.

To facilitate collaboration and support, we provide a dedicated Discord channel where users can discuss API usage, share feedback, and receive updates.

March 15, 2025

장바구니 보기