HostBill, Blesta 또는 자체 시스템에서 Zinn® 호스팅을 판매하세요

WHMCS를 운영 중이시라면 대신 WHMCS 모듈을 사용하십시오. 이 페이지는 그 외의 모든 경우를 위한 안내입니다. 두 가지 옵션이 제공되며, 둘 다 무료이고 GPL-2.0-or-later 라이선스가 적용됩니다.

HostBill

WHMCS 모듈과 동일한 6가지 동작을 수행하는 호스팅 모듈입니다.

1. 다운로드한 뒤 압축을 푸십시오.
2. 파일들이 includes/modules/Hosting/zinn/class.zinn.php 및 includes/modules/Hosting/zinn/ZinnHostBillClient.php에 위치하도록 zinn 디렉터리를 includes/modules/Hosting/에 업로드하십시오.
3. Settings → Modules → Hosting으로 이동하여 Zinn Digital®을 활성화하고 연결을 추가하십시오:

• API address: https://api.zinndigital.com
• API key: 귀하의 Zinn® API 키 (password 필드이므로 HostBill이 암호화하여 저장합니다)

1. 제품에서 Product line(예: mainstream), Stack(기본값은 wordpress), 그리고 선택적으로 Application 및 PHP version을 설정하십시오.
2. Test connection을 누르십시오.

⛔ zinn 디렉터리의 이름을 변경하지 마십시오. HostBill의 로더는 디렉터리 이름에서 찾으려는 클래스를 파생하므로, 이름을 변경하면 패널에는 표시되지만 결코 호출되지 않는 모듈이 생성됩니다.

기타 모든 환경 — PHP 클라이언트

의존성 없이 패널에 대한 가정도 없는 단 하나의 파일입니다. 귀하의 코드베이스에 ZinnProvisioning.php를 추가하고 6개의 메서드를 호출하십시오.

require_once 'ZinnProvisioning.php';

$zinn = new ZinnProvisioning(getenv('ZINN_API_KEY'));

// 주문이 결제되었을 때 — 고객당 한 번, 그 다음 서비스당 한 번:
$orgId  = $zinn->account('customer-4211', 'Acme Ltd');
$siteId = $zinn->provision('service-9915', $orgId, 'acme.com', 'mainstream', 'wordpress');
// 고객 정보에 $orgId를, 서비스 정보에 $siteId를 저장하십시오.

$zinn->suspend($siteId, 'INV-2026-114 unpaid');   // 인보이스가 미납되었을 때
$zinn->unsuspend($siteId);                        // 결제 완료 시
$zinn->terminate($siteId);                        // 취소 시 — 삭제가 예약됩니다

// 고객이 "내 호스팅에 로그인"을 클릭할 때 — 페이지 렌더링 시점이 아닌 반드시 클릭 시점에 생성하십시오:
header('Location: ' . $zinn->signInLink($siteId));

PHP로 개발하지 않으십니까? 동일한 호출 방식이 API 레퍼런스에 안내되어 있으며 어떤 언어로든 호출하실 수 있습니다.

API 키

정확히 다음 7가지 권한만 포함되며 그 이상은 필요하지 않습니다: org.create, org.read, sites.create, sites.view, sites.delete, reseller.view, reseller.provision.

⛔ reseller.manage는 포함되지 않습니다. 청구 패널에 붙여넣는 키는 미납 고객의 서비스를 정지시키고 로그인 처리를 할 수 있는 권한만 가져야 하며, 귀하의 결제 게이트웨이 인증 정보를 재작성할 수 있어서는 안 됩니다.

위반 시 비용 손실이 발생하는 두 가지 규칙

1. 계정의 고유 식별 기준은 고객(CUSTOMER)으로, 사이트의 기준은 서비스(SERVICE)로 설정하십시오. 고객의 두 번째 주문은 이미 보유하고 있는 계정에 연결되어야 합니다. 둘 다 서비스 기준으로 설정하면 한 명의 고객이 연관 없는 세 개의 계정과 세 개의 개별 제어판을 갖게 됩니다.
2. 모든 생성 작업 시 해당 대상에 대한 귀하 고유의 식별자(ID)에서 파생된 멱등성 키(idempotency key)를 전송하십시오. 모든 청구 시스템은 재시도를 수행합니다. 게이트웨이 콜백이 두 번 도착하거나, 관리자가 실패한 프로비저닝을 다시 실행하거나, 고객이 더블 클릭할 수 있습니다. 멱등성 키가 없으면 두 번째 시도로 인해 두 번째 사이트가 생성되고 이에 대한 요금이 청구됩니다. 두 모듈과 PHP 클라이언트는 이 작업을 자동으로 처리합니다. API를 직접 호출하시는 경우 Idempotency-Key를 전송하십시오.

누락하기 쉬운 세 가지 필드

각 필드가 누락되면 관련 명령 전체가 정상 작동하지 않으며, 단순한 유효성 검사 오류로만 나타납니다. 단, 첫 번째 필드는 아무런 오류도 발생하지 않는 상태로 나타납니다:

• ⛔⛔ 클라이언트의 첫 번째 사이트가 프로비저닝되기 전에 반드시 플랜에 등록되어야 합니다. 이는 POST /v1/reseller/clients/{orgId}/plan을 통해 수행되며, 해당 subscription_id를 POST /v1/sites에 전달해야 합니다. 이는 읽을 수 있는 오류가 발생하지 않는 경우입니다. 신규 클라이언트 계정에는 구독이 없으며 POST /v1/sites에는 플랜 필드가 없으므로, 플랜 없이 프로비저닝된 사이트에는 플랜이 전혀 적용되지 않습니다. 도매 청구 내역은 클라이언트의 활성 구독을 기준으로 생성되므로 청구 항목이 생성되지 않으며 호스팅이 실행되는 동안 Zinn®은 귀하에게 비용을 전혀 청구하지 않습니다. 클라이언트는 할당량을 상속받지 않으므로 해당 사이트에는 할당량이 적용되지 않으며, 업그레이드로 변경할 대상도 존재하지 않습니다. 주문은 201을 반환하고, 사이트는 프로비저닝되며, 완벽하게 서비스됩니다. 양쪽 끝 어디에서도 이에 대해 어떠한 보고도 이루어지지 않습니다.

순서가 중요합니다. POST /v1/sites는 실행되는 시점에 존재하는 구독을 기록하므로, 나중에 설정된 플랜은 소급하여 연결되지 않습니다.

• POST /v1/sites에는 stack_type이 필요합니다. 이를 생략하면 어떤 주문도 성공할 수 없습니다.
• DELETE /v1/sites/{siteId}에는 본문 {"confirm_domain": "<the site's own domain>"}이 필요합니다. 이는 파괴적인 동작을 수행하는 동사이므로 직접 입력하는 확인 절차가 필요합니다. 이를 생략하면 취소가 성공할 수 없으므로 서비스가 계속 실행되고 비용이 계속 청구됩니다. 자체 기록을 사용하는 대신 GET /v1/reseller/services/{siteId}에서 도메인을 다시 읽어오십시오. 이는 별칭이 아닌 사이트 자체의 기본 도메인과 비교됩니다.

문장만이 아닌 전체 오류를 읽으십시오

유효성 검사 거부 메시지는 의도적으로 일반적입니다("요청 형식은 올바르지만 유효성 검사에 실패했습니다"). 조치 가능한 핵심 정보는 필드명과 이유를 명시하는 details에 포함되어 있기 때문입니다. 모듈과 PHP 클라이언트 모두 관리자에게 표시하는 메시지에 이를 추가합니다. API를 직접 호출하는 경우 error.details를 읽으십시오. 일부 항목은 문장 대신 단순한 값을 전달하기도 하는데, 리셀러 플랜에 여유 공간이 없을 때 max_sites: 0이 전달되는 방식이 바로 이와 같습니다.

첫 주문 전 확인 사항

클라이언트가 구매하는 사이트는 귀하의 리셀러 플랜 사이트 허용 한도에 반영되므로 여유 공간이 있는 플랜이 필요합니다. 연결 테스트는 이를 감지할 수 없습니다. 이는 프로그램을 읽기만 할 뿐 아무것도 프로비저닝하지 않으므로 아직 판매할 수 없는데도 정상적인 계정으로 보고합니다. 할당량 없이 접수된 주문은 정확히 해당 내용을 알리는 메시지와 함께 거부됩니다.

다운로드 확인

두 아카이브 모두 당사의 자체 호스트 이름에서 TLS를 통해 제공되며 다른 곳으로 리디렉션되지 않습니다. SHA-256 체크섬은 다운로드 페이지의 다운로드 링크 옆에 표시되어 있습니다.