Ry.hk Ry.hk

API

한 번에 페이지가 아닌 프로그램에서 도메인을 관리하세요.

유선 등록, 가용성 확인, DNS 및 자체 시스템 관리: 대량 주문, 갱신 청소, 고객을 위한 제어판.

API는 클라이언트 영역에서 제공하는 것과 동일한 작업에 대한 기계 진입점입니다. 페이지에서 수행할 수 있는 작업을 스크립트로 작성할 수 있습니다.

휴식 HTTPS(JSON 응답 포함)
API 키 클라이언트 영역에서 생성 및 취소됨
전체 범위 클라이언트 영역과 동일한 작업
감사 가능 통화는 계정에 녹음됩니다

그것은 무엇입니까

  • 엔드포인트는 가용성, 도메인, 네임서버, 연락처, 주문 및 송장 등 리소스별로 그룹화되어 JSON를 반환합니다.
  • 인증은 클라이언트 영역에서 생성된 API 키를 사용하며, 이 키는 언제든지 취소하고 교체할 수 있습니다.
  • 일반적인 용도: 대량 등록, 만료 비우기, 도메인 상태를 자체 시스템에 동기화, 클라이언트를 위한 셀프 서비스 패널 및 자동화된 인증서 워크플로.
  • 웹에서와 동일한 비즈니스 규칙이 적용됩니다. 즉, 도메인은 외부에서 등록할 수 없으며 이전에는 여전히 잠금 해제된 도메인과 60 기간이 필요합니다.

작동 원리

01

키 만들기

수행해야 하는 작업 범위에 따라 클라이언트 영역에서 API 키를 생성합니다.

02

문서 읽기

끝점, 매개변수 및 반응 형태.

03

작은 테스트

자동화하기 전에 읽기 전용 엔드포인트 또는 몇 개의 도메인을 사용해 보십시오.

04

로깅을 통해 라이브 시작

프로덕션에 영향을 미치기 전에 재시도 및 로깅을 추가하세요.

가용성 및 검색

여러 이름을 한번에 확인하여 모니터링하고 선택하세요.

등록 및 갱신

주문, 갱신 및 주문 상태 읽기.

DNS 및 네임서버

레코드 및 네임서버 변경 사항을 일괄 푸시합니다.

연락처 관리

등록자, 관리자, 기술 및 청구서를 읽고 업데이트합니다.

주문 및 송장

주문, 송장, 결제 상태를 읽어보세요.

키 순환

키를 취소하고 교체합니다. 각 시스템을 자체 키로 유지하십시오.

API의 내용

자원별

자원당신이 할 수 있는 일
도메인가용성 확인, 등록, 갱신, 읽기 상태 및 만료
DNS네임서버 읽기 및 설정, DNS 레코드 유지
개인정보 보호 및 연락처개인 정보 보호 수준을 설정하고 네 가지 연락처 역할을 모두 업데이트하세요.
주문 및 청구주문, 송장 및 결제 상태 읽기
계정잔액 및 기본 계정 세부정보 읽기

연결하기 전에 준비해야 할 사항

대부분의 디버깅을 절약하는 네 가지 작은 것

  • 잔액 또는 유효한 결제 방법: 등록 및 갱신은 실제 주문이며 자금이 없으면 주문 단계에서 호출이 실패합니다.
  • 재시도 및 오류 처리: 네트워크 문제, 속도 제한 및 업스트림 지연이 발생합니다. 멱등성 읽기를 재시도합니다. 주문의 경우 고유 참조를 보내고 다시 작성하기 전에 확인하십시오.
  • 로깅: 참조, 도메인 및 응답 코드를 기록합니다. 나중에 논쟁이 벌어질 때 해당 로그는 해당 작업이 발생했다는 유일한 증거입니다.
  • 최소 권한: 읽기 전용 작업에 쓰기 가능한 키를 사용하지 말고 각 시스템에 자체 키를 제공하여 다른 시스템을 중단하지 않고 하나를 취소할 수 있도록 하세요.

API 키는 계정 비밀번호와 동일합니다. 서버 측 환경 변수나 비밀 관리자에 보관하세요. 프런트엔드 코드나 저장소에는 절대 보관하지 마세요.

사람들이 그것을 사용하는 방법

일반적인 패턴

  • 대량 등록기관: 등록을 위해 선택 항목을 제출하고 결과를 자신의 백엔드에 다시 작성합니다.
  • 갱신 기간: 만료가 다가오는 도메인을 밤마다 가져오고 알림이나 갱신 작업을 직접 진행하세요.
  • 화이트 라벨 패널: 고객이 여기에 로그인하지 않고도 제품 내부의 도메인을 관리할 수 있습니다.
  • 조정: 일정에 따라 도메인 및 주문 데이터를 가져와 자신의 원장과 일치시킵니다.

모든 주문에 포함되는 것

API 키 관리

목적에 따라 키를 생성, 취소 및 분리합니다.

문서

엔드포인트, 매개변수 및 응답.

도메인 및 DNS 엔드포인트

검색, 등록, 갱신, DNS 및 네임서버.

주문 및 청구 엔드포인트

주문, 송장 및 결제 상태.

통화 기록

문제 해결을 위해 계정에 대해 기록되었습니다.

지원

통합이 오작동하는 경우 티켓을 엽니다.

일반적인 질문

API에 대한 추가 비용이 있습니까?

API 자체는 별도로 요금이 청구되지 않습니다. 귀하는 수행하는 비즈니스 운영에 대해 비용을 지불합니다. 우발적이거나 남용적인 사용을 방지하기 위해 합리적인 속도 제한이 있습니다.

SDK가 있나요?

API는 표준 HTTPS 및 JSON이므로 모든 HTTP 클라이언트가 작동합니다. 문서에는 직접 조정할 수 있는 요청 예제가 포함되어 있습니다.

열쇠가 누출되면 어떻게 되나요?

클라이언트 영역에서 이를 취소하고 새 것을 생성하십시오. 취소는 즉시 적용되며 이전 키를 사용하는 요청은 거부됩니다.

테스트 비용이 듭니까?

읽기 전용 호출에는 비용이 들지 않습니다. 등록 및 갱신은 실제 주문이며 비용이 발생하므로 먼저 소수의 도메인에 대한 논리를 검증하십시오.

API는 다른 곳에 등록된 도메인을 관리할 수 있나요?

아니요. 클라이언트 영역과 동일하게 이 계정의 도메인에서 작동합니다.

참고하세요

  • API 키를 서버에 보관하세요. 브라우저 코드 또는 모바일 번들로 제공되는 키는 게시된 키입니다.
  • 엔드포인트 주문의 경우 고유한 요청 참조를 보내고 쓰기 전에 확인하여 네트워크 재시도가 두 번 등록되거나 청구되지 않도록 하세요.

시작할 준비가 되셨나요?

이 서비스 페이지를 열고 몇 단계만 거치면 완료됩니다. 먼저 물어보고 싶다면 티켓이 사람에게 전달됩니다.