NiceNIC 리셀러 API v2는 도메인 리셀러, 호스팅 제공업체, 개발자 및 WHMCS 사용자가 직접 API 연결을 통해 도메인 작업을 자동화할 수 있도록 도와줍니다.
이 API를 통해 적격한 NiceNIC 리셀러는 자체 웹사이트, 청구 시스템, WHMCS 설치 또는 맞춤 플랫폼을 연결하여 도메인 가용성 확인, 도메인 등록, 도메인 갱신, 도메인 이전, 네임서버 업데이트, DNS 레코드 관리, 계좌 잔액 확인 및 거래 검토 등 일반적인 도메인 워크플로우를 자동화할 수 있습니다.
간단 답변 NiceNIC 리셀러 API v2 사용을 시작하려면, NiceNIC 계정을 리셀러 단계로 업그레이드하고 API 설정을 구성하며, 계정 로그인 비밀번호와 다른 API 비밀번호를 생성하고 API 접근을 허용할 IP 주소를 화이트리스트에 추가한 후 시스템을 NiceNIC API v2 엔드포인트에 연결해야 합니다.
WHMCS를 사용하는 경우 모든 API 워크플로우를 수동으로 구축하는 대신 NiceNIC WHMCS 통합을 통해 연결할 수도 있습니다.
누가 NiceNIC 리셀러 API v2를 사용해야 하나요? NiceNIC 리셀러 API v2는 수동 도메인 관리 이상의 기능이 필요한 사용자를 위해 설계되었습니다. 다음과 같은 경우에 적합합니다:
자신의 고객에게 도메인을 판매하는 도메인 리셀러
호스팅 플랜에 도메인 등록을 번들로 포함하고자 하는 호스팅 제공업체
많은 클라이언트 도메인을 관리하는 웹 에이전시
맞춤 도메인 검색 또는 등록 시스템을 구축하는 개발자
자동화된 도메인 작업을 원하는 WHMCS 사용자
대량 도메인 관리 또는 반복적인 도메인 작업이 필요한 기업
한번에 한두 개만 도메인을 등록한다면 NiceNIC 제어판으로 충분할 수 있습니다. 다수의 도메인을 관리하거나 자체 플랫폼에서 직접 NiceNIC과 통신하려면 리셀러 API가 더 나은 워크플로우입니다.
NiceNIC 리셀러 API v2로 할 수 있는 일 NiceNIC 리셀러 API v2는 도메인 수명 주기의 중요한 부분을 자동화하는 데 도움을 줄 수 있습니다. 계정 상태, API 권한, 도메인 확장자, 레지스트리 규칙 및 사용 가능한 제품 지원에 따라 API 기능은 다음을 포함할 수 있습니다:
도메인 가용성 확인
도메인 이름 등록
기존 도메인 갱신
EPP 코드로 도메인 이전
계정 내 도메인 나열
도메인 세부 정보 가져오기
네임서버 업데이트
도메인 연락처 정보 업데이트
도메인 가격 확인
DNS 레코드 관리
자식 네임서버 생성 및 관리
계정 잔액 확인
거래 내역 검토
WHMCS 워크플로우 연결
일부 작업은 레지스트리 규칙, TLD 요구사항, 도메인 상태, 계정 인증, 결제 잔액 또는 추가 서류 제출 요건에 따라 달라질 수 있습니다. 모든 확장 프로그램이 동일하게 작동한다고 가정하지 말고 항상 API 응답 및 관련 도메인 규칙을 확인하세요.
시작 전에 NiceNIC 리셀러 API v2에 연결하기 전에 다음을 준비하세요:
등록된 NiceNIC 계정
업그레이드된 리셀러 계정 또는 적격 리셀러 접근권
유료 도메인 작업을 위한 충분한 계정 잔액
API 사용자 이름과 API 비밀번호
API 요청을 보낼 서버 IP 주소
통합을 완료할 개발자, WHMCS 관리자 또는 기술 팀원
라이브 고객 주문 전에 테스트 워크플로우
보안을 위해 계정 로그인 비밀번호를 API 비밀번호로 사용하지 마세요. API 비밀번호는 별도로 관리하며 API 인증에만 사용해야 합니다.
1단계: 계정을 리셀러 티어로 업그레이드 API 접근은 NiceNIC 리셀러 사용자용입니다. 계정이 아직 업그레이드되지 않았다면 NiceNIC 계정에 로그인하여 리셀러 업그레이드 옵션을 검토하세요. 리셀러 계정은 다음 목적에 유용합니다:
리셀러 수준 도메인 가격 접근
한 계정으로 더 많은 도메인 관리
도메인 업무 자동화를 위한 API 사용
WHMCS 또는 기타 청구 시스템 연결
자체 고객 기반에서 반복 도메인 수익 창출
리셀러 업그레이드 완료 후 API 구성 과정을 계속 진행할 수 있습니다.
도메인 서비스를 자동화할 준비가 되셨나요? NiceNIC 리셀러 계정으로 업그레이드하고 리셀러 API v2를 통해 도메인 등록, 갱신, 이전, DNS 및 WHMCS 워크플로우를 연결하세요.
2단계: NiceNIC 계정에서 API 설정 열기 계정이 리셀러 티어로 업그레이드된 후 NiceNIC 계정에 로그인하여 리셀러 섹션으로 이동하세요. 그런 다음 API 설정 영역을 찾습니다. 여기서 리셀러 계정의 API 접근을 구성합니다. 이 영역에서는 일반적으로 두 가지 주요 설정을 완료해야 합니다:
API 비밀번호 설정
API 접근을 허용할 IP 주소 추가
계정에서 API 설정을 볼 수 없다면 리셀러 업그레이드가 완료되었는지 확인하거나 NiceNIC 지원팀에 계정 검토를 요청하세요.
3단계: 별도의 API 비밀번호 설정 API 비밀번호는 NiceNIC 계정 로그인 비밀번호와 달라야 합니다. 보안과 문제 해결 측면에서 중요합니다. 잘못된 비밀번호를 사용하거나 계정 로그인 비밀번호를 API 비밀번호 대신 사용하면 인증에 실패할 수 있습니다. 권장사항:
강력한 API 비밀번호 사용
계정 로그인 비밀번호 재사용 금지
API 자격 증명 안전하게 보관
안전하지 않은 채팅이나 공개 티켓을 통해 API 자격 증명 전송 금지
개발자, 벤더, 전 직원이 더 이상 접근할 필요가 없을 경우 자격 증명 변경
4단계: 서버 IP 주소 화이트리스트 등록 NiceNIC API 접근에는 API 요청을 보낼 IP 주소가 필요합니다.일반적으로 서버, WHMCS 설치, 청구 시스템 또는 애플리케이션 백엔드의 공용 IP 주소입니다.
API 설정을 저장하기 전에 개발자나 호스팅 제공업체와 올바른 송신 IP 주소를 확인하세요. 잘못된 IP가 추가되면 사용자 이름과 API 비밀번호가 올바르더라도 API 요청이 실패할 수 있습니다.
일반적인 IP 관련 문제는 다음과 같습니다:
웹사이트 서버 IP와 API 요청 송신 IP가 다름
WHMCS가 방화벽, 프록시 또는 NAT 게이트웨이 뒤에 있음
호스팅 제공자가 서버 IP를 변경함
여러 서버에서 API 요청을 보내는데 한 IP만 화이트리스트에 등록됨
개발 서버는 작동하지만 운영 서버가 화이트리스트에 없음
5단계: NiceNIC API v2 엔드포인트에 연결 API 비밀번호와 IP 화이트리스트를 구성한 후 시스템이 NiceNIC API v2 엔드포인트에 요청을 보낼 수 있습니다. API는 HTTP 요청을 사용하며 JSON 응답을 반환합니다. 요청 시 필수 인증 및 콘텐츠 유형 헤더를 포함해야 합니다.
요청 본문은 수행할 API 작업에 따라 달라집니다. 예를 들어 도메인 가용성 확인, 도메인 등록, 도메인 갱신, 네임서버 업데이트 또는 계정 잔액 확인은 각각 다른 매개변수가 필요할 수 있습니다.
통합을 구축하거나 업데이트할 때는 항상 최신 NiceNIC API v2 문서를 참조하세요.
기술 문서가 필요하신가요? 공식 NiceNIC 리셀러 API v2 문서를 통해 인증, 응답 코드, 도메인 작업, DNS 작업, 청구 작업 및 WHMCS 지원을 검토하세요.
일반적인 설정 문제 및 해결 방법 1. 인증 오류 인증 오류는 일반적으로 API 자격 증명 또는 접근 설정이 올바르지 않을 때 발생합니다. 다음을 확인하세요:
계정에 리셀러 접근 권한이 있는지 확인
계정 로그인 비밀번호가 아닌 API 비밀번호를 사용하고 있는지 확인
API 비밀번호가 정확히 입력되었는지 확인
요청에 Auth또는ization 헤더가 포함되었는지 확인
API 설정에 서버 IP 주소가 화이트리스트에 등록되었는지 확인
요청이 다른 송신 서버 IP 주소에서 전송되고 있지 않은지 확인
2. IP 허용 안 됨 또는 연결 실패 IP 주소가 허용되지 않으면, 작업 처리 전에 API 요청이 실패할 수 있습니다.
호스팅 제공업체나 서버 관리자에게 API 요청에 사용되는 실제 송신 IP를 확인하고, NiceNIC 계정에서 API 설정을 업데이트하도록 요청하세요.
3. 잘못된 요청 형식 요청 본문, 헤더 또는 매개변수 형식이 틀리면 API가 오류 응답을 반환할 수 있습니다. 확인 사항:
Content-유형이 application/json으로 설정되었는지
요청 본문이 올바른 JSON인지
필수 매개변수가 포함되었는지
도메인 형식이 올바른지
작업 이름이 API 문서와 일치하는지
4. 도메인 등록 실패 도메인 등록 요청은 API 연결과 무관한 이유로 실패할 수 있습니다. 가능한 원인은 다음과 같습니다:
도메인이 더 이상 사용 불가
TLD가 특별한 등록 요건 보유
레지스트리에 추가 문서 요구
계정 잔액 부족
도메인 연락처 정보가 불완전하거나 유효하지 않음
레지스트리가 요청 거부
API 응답 메시지를 검토하고 확장자가 특별한 레지스트리 요구사항이 있는지 확인하세요.
5. 갱신 또는 이전 실패 갱신 및 이전 작업은 도메인 확장자, 도메인 상태, 레지스트리 규칙, 만료 시기, 이전 잠금, EPP 코드 및 계정 잔액에 따라 다를 수 있습니다.
이전 문제 발생 시 확인할 사항:
도메인이 이전 대상에 적합한지
현재 등록 기관에서 도메인이 잠금 해제되어 있는지
EPP 코드가 정확한지
레지스트리 또는 정책 제한에 의해 도메인이 차단되지 않았는지
필요 시 등록자 이메일 또는 이전 승인 절차가 완료되었는지
NiceNIC가 할 수 있는 것과 할 수 없는 것 NiceNIC는 등록 기관 측 API 접근, 리셀러 계정 도구, API 문서, WHMCS 통합 리소스 및 플랫폼에서 지원하는 도메인 작업을 제공합니다.
그러나 일부 도메인 작업은 레지스트리 규칙, 확장 정책, 인증 상태, 결제 상태, 남용/규정 준수 상태 또는 제삼자 시스템에 따라 다릅니다.
예를 들어:
특정 TLD는 등록 전 특별 문서가 필요할 수 있음
일부 도메인은 잠겨 있거나 만료되었거나 인증 중이거나 레지스트리 정책에 의해 제한될 수 있음
일부 이전 요청은 이전 등록 기관 또는 등록자 연락처의 승인이 필요할 수 있음
DNS 변경이 전 세계에 전파되는 데 시간이 걸릴 수 있음
WHMCS 동작은 WHMCS 버전, 모듈 설정, 서버 환경 및 크론 구성에 따라 다를 수 있음
이러한 이유로 모든 작업이 성공했다고 가정하지 말고 API 응답을 항상 읽고 저장해야 합니다.
권장 첫 통합 워크플로우 새 통합을 구축하는 경우 다음 순서를 따르세요:
리셀러 계정으로 업그레이드
API 비밀번호 및 IP 화이트리스트 구성
API v2 엔드포인트 연결
계정 잔액 조회 테스트
도메인 가용성 조회 테스트
가격 조회 테스트
안전한 내부 도메인에 대한 네임서버 업데이트 테스트
응답 코드 및 오류 처리 검토
WHMCS 또는 자체 청구 시스템 연결
테스트 후 라이브 등록, 갱신, 이전 워크플로우 활성화
자주 묻는 질문 1. NiceNIC 리셀러 API v2를 사용하려면 리셀러 계정이 필요한가요? 네. NiceNIC 리셀러 API v2는 적격 리셀러 사용자용입니다. API 설정에 접근할 수 없다면 계정이 리셀러 단계로 업그레이드 되었는지 확인하세요.
2. API 비밀번호로 NiceNIC 계정 로그인 비밀번호를 사용해도 되나요? 아니요. 보안 및 올바른 구성을 위해 API 비밀번호는 계정 로그인 비밀번호와 달라야 합니다.
3. API 요청에서 인증 오류가 반환되는 이유는 무엇인가요? 인증 오류는 대개 잘못된 API 비밀번호, Auth또는ization 헤더 누락, 잘못된 사용자 이름, 비화이트리스트 IP 또는 다른 송신 서버 IP에서 요청이 전송되는 경우 발생합니다.
4. NiceNIC API v2를 WHMCS와 함께 사용할 수 있나요? 네. NiceNIC는 도메인 등록 활동(가용성 확인, 등록, 갱신, 이전 및 도메인 정보 조회)을 위한 WHMCS 통합을 제공합니다.
5. 모든 도메인 확장자를 API로 등록할 수 있나요? 항상 그런 것은 아닙니다. 도메인 등록은 TLD 가용성, 레지스트리 규칙, 계정 잔액, 인증 요구사항 및 확장별 제한에 따라 다릅니다. 일부 TLD는 추가 문서나 수동 검토가 필요할 수 있습니다.
6. 라이브 환경에 가기 전에 무엇을 테스트해야 하나요? 계정 잔액 조회, 도메인 가용성 확인, 가격 조회 및 도메인 목록과 같은 위험이 낮은 작업부터 시작하세요. 인증, IP 화이트리스트, 요청 형식, 응답 처리 및 청구 로직이 확인될 때까지 라이브 고객 주문을 활성화하지 마세요.
NiceNIC로 도메인 서비스 자동화 시작 NiceNIC 리셀러 API v2는 리셀러, 호스팅 제공업체, 개발자 및 WHMCS 사용자가 도메인 검색, 등록, 갱신, 이전, DNS 및 계정 워크플로우를 직접 자동화할 수 있는 방법을 제공합니다.