API 개요
NiceNIC 도메인 API v2 문서 및 빠른 시작
NiceNIC 도메인 API v2는 마켓 계정과 리셀러 계정 모두에서 사용할 수 있습니다. 이 개요를 통해 액세스를 구성하고, 첫 번째 요청을 확인하고, API 응답 모델을 이해하고, 왼쪽 탐색에서 올바른 섹션으로 바로 이동할 수 있습니다.
API 액세스와 리셀러 가격은 별개입니다.
마켓 계정: 마켓 계정 가격으로 API 액세스.
리셀러 계정: 현재 리셀러 등급에 할당된 가격으로 API 액세스.
리셀러 등급 및 가격 비교 →
마켓 계정: 마켓 계정 가격으로 API 액세스.
리셀러 계정: 현재 리셀러 등급에 할당된 가격으로 API 액세스.
리셀러 등급 및 가격 비교 →
기본 엔드포인트
https://api.nicenic.net/v2/
필수 헤더
Host: api.nicenic.net Authorization: username:api_secret Content-Type: application/json
표준 성공 응답
{ "code": 0, "msg": "success", "data": {} }
API 샌드박스
라이브 전환 전에 통합을 테스트하세요
프로덕션 환경으로 전환하기 전에 NiceNIC API 샌드박스를 사용하여 도메인 API 통합을 테스트하십시오. 전용 테스트 환경에서 인증, API 요청, 응답 처리 및 애플리케이션 워크플로우를 검증하세요.
API 통합을 준비 중인 리셀러, 호스팅 제공업체, 개발자 및 플랫폼에 적합합니다.
빠른 시작
4단계로 첫 API 호출하기
실제 등록, 갱신 또는 이전을 활성화하기 전에 읽기 전용 요청으로 시작하세요. 이렇게 하면 유료 주문을 하지 않고도 인증, 요청 형식 및 응답 처리를 검증할 수 있습니다.
1
API 액세스 활성화
API 설정을 열고 API Secret을 생성하거나 검색한 후, 해당되는 경우 승인된 서버 IP를 구성하세요.
2
인증 확인
HTTPS를 사용하고 Authorization 헤더를 username:api_secret 형식으로 지정하세요.
3
안전한 테스트 실행
도메인 사용 가능 여부, 가격, 계정 잔액 또는 도메인 목록부터 시작하세요.
4
응답 처리
유료 프로덕션 작업을 활성화하기 전에 반환된 code 및 msg를 읽고 저장하세요.
권장 첫 번째 요청: 도메인 가용성
가용성 엔드포인트는 도메인 이름을 쉼표로 구분하여 한 번의 요청으로 여러 도메인을 지원합니다.
curl "https://api.nicenic.net/v2/?category=domain&action=check&domains=example.com,example.net" \ -H "Authorization: username:api_secret" \ -H "Content-Type: application/json"
API 맵
필요한 워크플로우를 선택하세요
아래 개요는 왼쪽 탐색 메뉴와 동일합니다. 올바른 워크플로우를 확인한 후, 전용 엔드포인트 페이지에서 매개변수, 요청 예시 및 응답 예시를 확인하세요.
| 섹션 | 용도 | 문서화된 기능 |
|---|---|---|
| 시작하기 | 안전하게 연결하고 응답 처리 방식을 이해합니다. | API 개요, API 샌드박스, 인증, 응답 코드. |
| 도메인 관리 | 핵심 도메인 수명 주기를 자동화합니다. | 가용성, 도메인 목록, 도메인 세부 정보, 등록, 갱신, 이전(Transfer In), 네임서버, 연락처, 가격. |
| 신고 및 규정 준수 | 규정 준수가 필요한 도메인을 모니터링합니다. | 신고가 접수된 도메인 목록을 조회하고, 기계 판독 가능한 신고 상태, 보류 수명 주기, 신고 정보 및 권장 조치를 검색합니다. |
| DNS 레코드 | 호스팅 DNS 레코드를 프로그래밍 방식으로 관리합니다. | DNS 레코드를 나열, 생성, 업데이트 및 삭제합니다. |
| 하위 네임서버 | 자체 도메인 아래에 있는 네임서버의 호스트/글루 레코드를 관리합니다. | 자식 네임서버를 생성, 나열, 업데이트 및 삭제합니다. |
| 계정 및 결제 | 계정 수준 검사에 자동화를 연결합니다. | 계정 잔액 및 거래 관련 계정 정보입니다. |
| WHMCS API | NiceNIC을 기존 WHMCS 청구 워크플로에 통합합니다. | 가용성, 등록, 갱신, 이전, 도메인 세부정보, 네임서버, 연락처 및 추가 등록대행자 모듈 기능. |
| API 자주 묻는 질문 | 일반적인 액세스, 보안, 테스트 및 워크플로 질문을 해결합니다. | 자격, 자격 증명, 요청 처리, 지원되는 작업 및 통합 지침입니다. |
권장 워크플로
권장 첫 통합 순서
안정적인 운영 통합은 실시간 고객 주문을 보내기 전에 접근 권한과 구매 조건을 검증해야 합니다.
1. 인증
API Secret + 승인된 IP
API Secret + 승인된 IP
→
2. 가용성
읽기 전용 연결 테스트
읽기 전용 연결 테스트
→
3. 가격
현재 계정별 비용 조회
현재 계정별 비용 조회
→
4. 잔액
유료 작업을 위한 자금 확인
유료 작업을 위한 자금 확인
→
5. 응답 처리
코드 및 메시지 처리
코드 및 메시지 처리
→
6. 실시간 운영
등록 / 갱신 / 이전
등록 / 갱신 / 이전
API 요청이 수락되었다고 해서 완료된 것으로 간주해서는 안 됩니다. 일부 작업은 보류 상태를 반환할 수 있으며, 최종 도메인 상태가 확인되기 전에 레지스트리 처리가 여전히 필요할 수 있습니다.
운영 환경 동작
성공, 대기 및 오류 응답 이해하기
code: 0 — 성공 응답 현재 엔드포인트 예제에서는 성공적으로 완료된 응답에 code 0을 사용합니다.
code: 201 — 대기 중인 주문 등록 및 이전 문서에서 주문이 제출되었지만 최종 처리가 아직 진행 중일 때 code 201이 반환될 수 있습니다.
code: 400 — 요청 오류 엔드포인트 예제에서는 요청 매개변수 오류에 code 400을 사용합니다.
등록 대기 동작
도메인 등록의 경우, 현재 문서에 따르면 201 응답은 주문이 성공적으로 제출되었고 수수료가 차감되었음을 의미하지만, 최종 활성화는 여전히 레지스트리 확인을 거쳐야 합니다. 도메인을 활성화할 수 없는 경우 등록 수수료는 24시간 이내에 NiceNIC 계정 잔액으로 반환됩니다.
도메인 이전 보류 동작
이전 엔드포인트는 201을 보류 주문으로도 문서화합니다. 따라서 애플리케이션은 보류 중인 이전이 이미 완료된 증거가 아니라 처리를 위해 수락된 것으로 취급해야 합니다.
가격
유료 작업 전 가격 조회
NiceNIC의 가격 조회 엔드포인트를 통해 도메인의 등록, 갱신 및 이전 가격을 확인할 수 있습니다. 문서화된 type 값은 register, renew, transfer, all입니다. 문서화된 기간은 1~10년이며, TLD별 예외가 적용될 수 있습니다.
등록 가격 응답에는 is_premium 플래그도 포함될 수 있습니다. 애플리케이션이 현재 계정 수준의 비용을 확인해야 하는 경우, 유료 요청을 제출하기 전에 가격 조회 엔드포인트를 사용하세요.
무료 API 액세스는 요금제를 변경하지 않습니다. 마켓 계정은 마켓 계정 요금제를 적용받으며, 리셀러 계정은 현재 리셀러 등급에 할당된 요금제가 적용됩니다.
도메인 및 DNS 작업
네임서버, DNS 레코드 및 자식 네임서버의 차이점 이해하기
| 작업 | 사용 시점 | 문서화된 기능 |
|---|---|---|
| 네임서버 업데이트 | 도메인을 다른 권위 있는 네임서버에 위임하려는 경우 | 도메인 네임서버 엔드포인트는 기본, 보조 및 추가 네임서버를 지원하며, 현재 페이지에는 최대 6개까지 제한이 문서화되어 있습니다. |
| DNS 레코드 | NiceNIC DNS 호스팅을 사용하고 있으며 영역 레코드를 관리해야 하는 경우 | DNS 레코드를 나열, 생성, 업데이트 및 삭제하기 위한 별도의 API가 문서화되어 있습니다. |
| 하위 네임서버 | ns1.example.com과 같은 호스트/글루 레코드가 필요한 경우 |
자식 네임서버를 생성, 나열, 업데이트 및 삭제합니다. 생성 엔드포인트는 네임서버 호스트 이름이 도메인과 일치해야 하며 IP 주소를 허용합니다. |
포트폴리오 및 규정 준수
도메인 주문뿐 아니라 포트폴리오 모니터링까지 자동화하세요
도메인 API v2에는 등록 후 유용한 읽기 작업도 포함됩니다. 도메인 목록 엔드포인트는 페이지 매김, 정렬, 상태 필터링 및 보류 필터링을 지원하며, 도메인 세부 정보 가져오기는 등록 날짜, 만료 날짜, 네임서버 및 등록자 연락처 정보를 반환합니다.
남용 및 규정 준수 모니터링
NiceNIC의 남용 및 규정 준수 API는 남용 신고가 있는 도메인을 나열하고 특정 도메인에 대한 상세한 기계 판독 가능 요약을 반환할 수 있습니다. 상세 남용 엔드포인트는 6가지 도메인 수준 상태 문구를 문서화합니다: 정상, 검토 중, ClientHold 대기 중, ClientHold, 종료 및 ServerHold.
응답에는 해당되는 경우 현재 영향, 권장 다음 조치, 보류 상태 및 타임라인, 불만 건수, 불만 날짜, 카테고리, DNS 남용 분류, 증거 상태 및 신고된 URL이 포함될 수 있습니다. 이를 통해 플랫폼과 리셀러는 수동 검토에만 의존하지 않고 자체 운영 시스템 내에서 규정 준수 상태를 표시할 수 있습니다.
직접 API 또는 WHMCS
시스템에 맞는 통합 모델을 선택하세요
| 옵션 | 적합한 환경 | 현재 문서에서 제공하는 기능 |
|---|---|---|
| 도메인 API v2 | 맞춤형 웹사이트, SaaS 플랫폼, 내부 시스템, 맞춤 결제 또는 프로비저닝 워크플로우 | 도메인, DNS, 하위 네임서버, 계정 및 컴플라이언스 운영 전반에 걸친 직접 HTTPS + JSON 통합 |
| WHMCS 모듈 | WHMCS를 이미 사용 중인 호스팅 업체 및 리셀러 | 가용성 확인, 등록, 갱신, 이전, 도메인 정보, 네임서버, 연락처, 잠금/잠금 해제, EPP 조회, 오류 로깅 및 선택적 테스트 모드 |
현재 WHMCS 문서는 요구 사항으로 WHMCS 7.0 이상, cURL을 지원하는 PHP 7.0 이상, 유효한 NiceNIC API 자격 증명 및 SSL/TLS 지원을 명시하고 있습니다.
문제 해결
API 요청이 실패하는 경우
동일한 유료 작업을 반복적으로 재시도하기보다는 반환된 응답과 구성 상태를 먼저 확인하세요.
인증 또는 액세스 오류
- NiceNIC 사용자 이름과 API Secret을 확인하세요.
- Authorization 헤더가 존재하고 올바르게 형식화되었는지 확인하세요.
- API Secret이 재설정되거나 교체되지 않았는지 확인하세요.
- IP 제한이 활성화된 경우, 요청이 승인된 아웃바운드 서버 IP에서 들어오는지 확인하세요.
요청 매개변수 오류
- 요청을 특정 엔드포인트의 문서화된 매개변수와 비교하세요.
- 필수 값, 형식 및 작업 이름을 확인하세요.
- 해당되는 경우 TLD별 등록 기간 또는 연락처 요구 사항을 확인하세요.
유료 작업이 즉시 완료되지 않음
- 반환된
code및msg를 읽으십시오. 201보류 응답을 최종 완료로 간주하지 마십시오.- 유료 작업을 재시도하기 전에 계정 잔액과 현재 요금을 확인하십시오.
NiceNIC 지원이 필요하신가요?
- 요청 타임스탬프와 API 작업을 기록하세요.
- 해당되는 경우 관련 도메인 이름이나 객체를 포함하세요.
- 반환된 코드와 메시지를 포함하세요.
- 민감하지 않은 매개변수만 공유하세요. 티켓에 전체 API 비밀 키를 게시하지 마세요.
다음 단계
안전한 테스트 요청으로 시작하기
API 액세스를 활성화하고, 인증을 확인하고, 가용성 또는 가격 요청을 실행한 후, 고객 대상 유료 운영을 시작하기 전에 응답 처리를 검증하세요.
마지막 확인: 2026년 8월 26일
