파트너 API
파트너 API
파트너용 서버 API: 자체 사이트나 봇에서 고객을 만들고 요금제를 부여하며 구독을 관리하세요.
파트너 API를 사용하면 CreateYourVPN 위에 자체 웹사이트, 고객 포털 또는 봇을 구축할 수 있습니다. 고객, 요금제, 구독만 노출되며 서버, 노드, 패널 및 인프라 자격 증명은 응답에 절대 포함되지 않습니다.
키는 서버 간 통신 전용입니다. JavaScript나 모바일 앱에 넣지 마세요. 브라우저에서 보낸 것으로 보이는 요청은 403 browser_forbidden으로 거부됩니다.
시작하기
- 대시보드에서 설정 → API 및 연동을 엽니다.
- 최소 권한으로 키를 만들고 secret을 복사합니다. secret은 한 번만 표시됩니다.
Authorization: Bearer cyv_live_…또는X-API-Key로 전송합니다.
curl https://api.createyourvpn.com/api/v1/partner-api/me \
-H "Authorization: Bearer cyv_live_<key_id>_<secret>"권한: 설정과 위치를 위한 config:read, 고객 조회를 위한 users:read, 고객 생성과 구독 관리를 위한 users:write.
공개 계약
공개 Postman 컬렉션에는 모든 엔드포인트, 매개변수, 본문, 예시, 권한 및 오류 코드가 포함됩니다. 백엔드 계약에서 생성되므로 유일한 기술 참조입니다.
제한: 키당 분당 120회, GET /users는 분당 10회입니다. grant, rotate, DELETE에는 Idempotency-Key가 필요하며 동일한 이벤트의 재시도에는 24시간 동안 같은 값을 사용해야 합니다.