NiceNIC 도메인 API v2 자주 묻는 질문
API 액세스, 샌드박스 테스트, 인증, 가격, 도메인 작업, 응답 처리 및 프로덕션 통합에 대한 실용적인 답변을 확인하세요.
시작하기
액세스, 가격 및 자격 증명부터 시작하세요.
01 NiceNIC 도메인 API v2란 무엇인가요?
NiceNIC 도메인 API v2는 NiceNIC 계정을 통해 도메인 관리를 자동화하기 위한 HTTPS 및 JSON 기반 API입니다.
도메인 사용 가능 여부 확인, 등록, 갱신, 이전, 포트폴리오 조회, 네임서버 및 연락처 업데이트, 가격, DNS 레코드, 하위 네임서버, 계정 정보 및 규정 준수 관련 작업을 포함한 핵심 워크플로를 지원합니다.
NiceNIC 도메인 서비스를 웹사이트, 호스팅 플랫폼, 결제 시스템, 내부 도구 또는 기타 애플리케이션에 직접 연결하려면 API를 사용하세요.
02 누가 NiceNIC 도메인 API v2를 사용할 수 있나요?
활성 상태인 모든 NiceNIC 계정은 도메인 API v2를 사용할 수 있습니다. API 액세스는 마켓 계정과 리셀러 계정 모두에 제공됩니다.
API 액세스 권한을 얻기 위해 리셀러가 될 필요는 없습니다. 그러나 가격에는 계정 유형이 여전히 중요합니다. 유료 API 작업은 요청을 보내는 NiceNIC 계정에 할당된 가격을 사용합니다.
03 NiceNIC 도메인 API v2는 무료인가요?
네, API 액세스 자체는 무료입니다. API 액세스를 활성화하거나 지원되는 API 요청을 보내는 데 별도의 수수료는 없습니다.
도메인 등록, 갱신, 이전과 같은 유료 작업은 계정의 가격 정책과 해당 도메인 규칙에 따라 청구됩니다.
04 API를 사용하려면 리셀러 계정이 필요한가요?
아니요. API 액세스와 리셀러 가격 정책은 별개입니다.
일반 NiceNIC 마켓 계정으로도 도메인 API v2를 사용할 수 있습니다. 리셀러 가격이나 기타 리셀러 혜택이 비즈니스 규모에 맞을 때만 리셀러 계정으로 업그레이드하세요.
05 API v2는 기존 NiceNIC API와 어떻게 다른가요?
도메인 API v2는 HTTPS 요청, JSON 응답, 헤더 기반 인증, 그리고 개별 도메인 및 계정 워크플로우 중심의 문서 구조를 갖춘 최신 NiceNIC API 구조를 사용합니다.
기존 NiceNIC API를 기반으로 구축된 통합 시스템을 유지 중이라면, 두 버전이 서로 호환된다고 가정하지 말고 프로덕션 트래픽을 전환하기 전에 API v2의 매개변수와 응답 처리를 검토하세요.
06 API 자격 증명은 어떻게 받나요?
NiceNIC 계정에 로그인하고 API 설정을 여세요. API v2 요청은 인증에 NiceNIC 사용자 이름과 API Secret을 사용합니다.
샌드박스 및 인증
프로덕션 전에 안전하게 연결하고 테스트하세요.
07 NiceNIC 도메인 API v2에서 API 샌드박스를 제공하나요?
예. NiceNIC은 개발자가 프로덕션 API에 연결하기 전에 통합을 테스트할 수 있도록 API 샌드박스를 제공합니다.
실제 고객 도메인 작업을 활성화하기 전에 샌드박스를 사용하여 인증, 요청 형식, 응답 구문 분석, 오류 처리 및 애플리케이션 워크플로를 검증하십시오.
08 샌드박스와 프로덕션 API의 차이점은 무엇인가요?
API 샌드박스는 개발 및 통합 테스트를 위한 것입니다. 프로덕션 API는 실제 도메인 작업과 NiceNIC 계정에 대한 유료 요청에 사용됩니다.
고객에게 노출되는 프로덕션 작업을 활성화하기 전에 샌드박스에서 인증, 요청 처리, 응답 처리 및 오류 로직을 검증하는 것이 좋습니다.
09 API 인증은 어떻게 작동하나요?
HTTPS를 통해 API 요청을 보내고 Authorization 헤더에 NiceNIC 사용자 이름과 API Secret을 포함하십시오.
Host: api.nicenic.net
Authorization: username:api_secret
Content-Type: application/json
계정에 IP 제한이 설정된 경우, 요청은 반드시 승인된 서버 IP에서 시작되어야 합니다.
10 도메인 API v2는 어떤 엔드포인트를 사용하나요?
프로덕션 API 기본 엔드포인트는 다음과 같습니다:
https://api.nicenic.net/v2/
API 작업은 각 엔드포인트에 문서화된 매개변수(예: category 및 action)를 사용하여 선택됩니다. 특정 작업에 필요한 매개변수와 선택적 매개변수는 항상 전용 엔드포인트 문서를 따르십시오.
11 API v2는 어떤 응답 형식과 문자 인코딩을 사용하나요?
API v2 응답은 JSON을 사용하며, 요청 매개변수는 UTF-8을 사용합니다.
{
"code": 0,
"msg": "success",
"data": {}
}
애플리케이션은 모든 HTTP 응답이 완료된 도메인 작업을 나타낸다고 가정하지 말고, 반환된 code 및 msg를 검사해야 합니다.
도메인 작업 및 가격
지원되는 워크플로우와 구매 방식을 이해하세요.
12 NiceNIC 도메인 API v2로 무엇을 할 수 있나요?
현재 문서화된 API를 통해 도메인 가용성 확인, 등록, 갱신 및 이전, 포트폴리오 목록 및 도메인 세부 정보, 네임서버 및 도메인 연락처 업데이트, 도메인 가격, DNS 레코드, 자식 네임서버, 계정 정보 및 남용 및 컴플라이언스 모니터링을 포함한 워크플로를 자동화할 수 있습니다.
추가 워크플로는 API 내비게이션에서 개별적으로 문서화되어 있습니다.
13 실제 등록 또는 이전을 활성화하기 전에 무엇을 테스트해야 하나요?
도메인 가용성, 도메인 가격, 계정 잔액 및 도메인 목록과 같은 위험이 낮은 읽기 작업부터 시작하세요.
그런 다음 실제 등록, 갱신 또는 이전을 활성화하기 전에 인증, 응답 구문 분석, 오류 처리 및 보류 중인 주문 처리를 확인하세요.
14 하나의 API 요청으로 여러 도메인을 확인할 수 있나요?
예. 도메인 가용성 확인 엔드포인트는 쉼표로 구분된 여러 도메인 이름을 지원합니다.
example.com,example.net,example.org
모든 API 작업이 동일한 다중 도메인 입력 형식을 지원한다고 가정하지 마세요. 등록, 갱신 및 이전은 각 엔드포인트 문서를 따라야 합니다.
15 등록, 갱신 및 이전 가격을 어떻게 조회할 수 있나요?
도메인 가격 조회 엔드포인트를 사용하세요. 문서화된 가격 유형에는 register, renew, transfer, all이 포함됩니다.
등록 응답에는 조회한 등록이 프리미엄인지 여부를 나타내는 is_premium 값이 포함될 수도 있습니다.
API 주문은 계정 수준의 가격을 사용하므로, 캐시된 가격을 계속 신뢰하기보다는 유료 고객 주문을 제출하기 전에 현재 가격을 조회하세요.
16 모든 TLD를 1~10년 동안 등록하거나 갱신할 수 있나요?
아니요. API 문서에서는 적용 가능한 확장자의 경우 최대 1~10년 기간을 지원하지만, 개별 TLD에는 각기 다른 레지스트리 규칙이 적용될 수 있습니다.
등록 기간, 갱신 기간, 전송 자격, 연락처 요구 사항 및 검증 요구 사항은 확장자별로 다를 수 있습니다. 애플리케이션은 해당 TLD의 현재 규칙을 따라야 합니다.
17 네임서버, DNS 레코드 및 하위 네임서버의 차이점은 무엇인가요?
ns1.example.com과 같은 호스트/글루 레코드를 생성합니다.이들은 별개의 작업이며 서로 대체하여 사용할 수 없습니다.
응답 및 오류
성공, 대기 상태 및 실패를 올바르게 처리하세요.
18 API 응답 코드는 무엇을 의미하나요?
| 코드 | 의미 |
|---|---|
0 | 성공 |
201 | 대기 중 |
400 | 매개변수 오류 |
401 | 인증 실패 |
404 | 관련 레코드를 찾을 수 없습니다 |
500 | 서버 내부 오류 |
API 요청의 상태를 확인할 때는 항상 반환된 코드와 메시지를 사용하십시오.
19 코드 201은 무엇을 의미하나요?
201 응답은 작업이 처리 승인되었지만 반드시 최종 상태에 도달했음을 의미하지는 않습니다.
20 도메인 등록 시 코드 201이 반환되면 어떻게 되나요?
도메인 등록의 경우 201 응답은 주문이 제출되었으며 최종 레지스트리 처리를 기다리고 있음을 나타냅니다.
시스템이 최종 결과를 확인하기 전에는 최종 고객에게 도메인이 활성화되었다고 말하지 마십시오. 최신 대기 주문 및 환불 처리 규칙은 등록 엔드포인트 문서를 따르십시오.
21 전송 보류(Pending transfer) 응답은 무엇을 의미하나요?
전송 보류는 전송 요청이 처리 승인되었음을 의미하며, 도메인이 이미 NiceNIC으로 전송을 완료했음을 의미하지는 않습니다.
전송 완료는 레지스트리 및 레지스트라 처리와 도메인의 현재 전송 상태에 따라 달라질 수 있습니다. 완료가 확인될 때까지 전송을 보류 상태로 유지하십시오.
포트폴리오, 규정 준수 및 통합
포트폴리오를 관리하고 기존 시스템을 연결하세요.
22 API를 통해 도메인 포트폴리오를 조회하고 필터링할 수 있나요?
네. 도메인 목록 API는 페이지네이션, 정렬 및 필터링 옵션을 지원하여 포트폴리오 검색을 제공합니다.
개별 도메인에 대한 상세 정보(예: 등록 정보, 만료 정보, 네임서버 및 도메인 연락처 데이터)가 필요할 때 도메인 세부 정보 가져오기를 사용하십시오.
23 신고 및 규정 준수 API는 무엇을 할 수 있나요?
NiceNIC 도메인 API v2는 고객 도메인 포트폴리오를 관리하는 플랫폼과 리셀러를 위한 신고 및 규정 준수 작업을 포함합니다.
신고 보고서와 연결된 도메인을 식별하고 개별 도메인에 대한 기계 판독 가능한 규정 준수 정보를 검색할 수 있습니다. 경우에 따라 응답에는 도메인 상태, 현재 영향, 권장 조치, 보류 정보, 불만 사항 정보 및 신고된 URL이 포함될 수 있습니다.
이를 통해 자체 고객 포털이나 운영 시스템 내에서 규정 준수 상태를 직접 표시할 수 있습니다.
24 NiceNIC 도메인 API v2를 WHMCS와 함께 사용할 수 있나요?
예. NiceNIC은 이미 WHMCS를 사용하여 결제 및 프로비저닝을 처리하는 비즈니스를 위해 WHMCS 등록기관 통합을 제공합니다.
자체 애플리케이션 또는 워크플로우를 구축하는 경우 도메인 API v2를 직접 사용하십시오. 기존 WHMCS 환경에 도메인 작업을 통합하려는 경우 WHMCS 통합을 사용하십시오.
개발 및 지원
안전하게 구축하고 도움이 필요할 때 무엇을 보내야 하는지 알아두세요.
25 어떤 프로그래밍 언어를 사용할 수 있나요?
HTTPS 요청을 보내고 JSON을 파싱할 수 있는 모든 서버 측 프로그래밍 언어 또는 런타임은 도메인 API v2와 통합할 수 있습니다.
일반적인 선택으로는 PHP, Python, Node.js 및 Java가 있습니다. API 자격 증명은 서버 측에 보관하고 API Secret을 브라우저 측 JavaScript 또는 다운로드 가능한 클라이언트 코드에 절대 노출하지 마세요.
26 API 요청 속도 제한이 있나요?
API 안정성과 플랫폼 보안을 보호하기 위해 요청 속도 제한이 적용될 수 있습니다.
프로덕션 통합에서 지속적으로 높은 요청량이 발생할 것으로 예상되는 경우, 출시 전에 NiceNIC에 문의하여 예상 사용 패턴을 검토받을 수 있도록 하세요.
27 API 문제로 지원팀에 문의할 때 무엇을 포함해야 하나요?
요청 타임스탬프, API 카테고리 및 작업, 해당되는 경우 도메인 이름, 민감하지 않은 요청 매개변수, 반환된 응답 코드 및 메시지, 그리고 요청이 Sandbox에서 왔는지 Production에서 왔는지 여부를 포함하세요.
28 전체 요청 매개변수와 코드 예제는 어디에서 찾을 수 있나요?
문서의 API 탐색을 사용하세요. 각 작업에는 지원되는 매개변수, 요청 예제, 응답 예제 및 작업별 동작에 대한 자체 페이지가 있습니다.
FAQ는 일반적인 API 동작을 설명합니다. 정확한 요청 형식에 대한 세부 사항은 개별 엔드포인트 문서를 기준으로 삼아야 합니다.
지금 바로 구축을 시작할 준비가 되셨나요?
API 샌드박스에서 통합을 테스트한 후, 프로덕션으로 전환할 준비가 되면 NiceNIC 계정을 연결하세요.
대량 도메인 등록을 위한 리셀러 요금제가 필요하신가요?
리셀러 플랜 비교 →






