OpenAPI

app_key 인증 키는 로그인 후 개인 센터 홈페이지에서 확인하세요.

키를 안전하게 보관하세요. 키는 계정 관리자 권한을 갖습니다.

Base URLs:

인증

프록시 계정 관리

GET 프록시 계정 목록

GET /openapi/whitelist-account/list

반환 예시

200 응답

{
	"code": 200,
	"msg": "string",
	"data": {
		"list": [
			{
				"id": 0,
				"username": "string",
				"password": "string",
				"created_at": "string",
				"remark": "string",
				"product_type": 9,
				"usage_flow": 0,
				"limit_flow": 102400,
				"status": 0
			}
		]
	}
}

반환 결과

상태 코드	상태 코드 의미	설명	데이터 모델
200	OK	요청 성공	인라인

반환 데이터 구조

상태 코드 200

이름	유형	필수 여부	제약 조건	설명
» code	responseCode	false	없음	상태 코드, 200 성공, 3 app_key 유효하지 않음
» msg	string	거짓	없음	상태 메시지
» 데이터	객체	거짓	없음	없음
»» 목록	[객체]	거짓	없음	없음
»»» id	정수	거짓	없음	계정 번호
»»» username	string	거짓	없음	프록시 계정 이름
»»» 비밀번호	문자열	거짓	없음	프록시 계정 비밀번호
»»» created_at	string	false	없음	추가 시간
»»» remark	string	false	없음	비고
»»» product_type	productTypes	거짓	없음	套餐 유형, 9 동적 주거 트래픽 패키지, 11 동적 주거 IP, 14 정적 데이터 센터 IP, 25 정적 주거 IP
»»» usage_flow	정수	거짓	없음	사용된 트래픽(KB)
»»» limit_flow	정수	거짓	없음	사용자 지정 트래픽 제한: 단위 GB, 최대 102400, 0은 무제한
»»» status	정수	거짓	없음	활성화 상태: 1 활성화, 0 비활성화

열거형 값

속성	값
product_type	9
product_type	11
product_type	14
제품_유형	25

POST 프록시 계정을 추가합니다.

POST /openapi/whitelist-account/add

Body 요청 파라미터

{
	"app_key": "stringstringstringstringstringst",
	"accounts": "user01:pass,user02:pass,user03:pass",
	"remark": "",
	"product_type": 9
}

요청 파라미터

이름	위치	유형	필수	설명
body	body	개체	아니요	없음
» app_key	본문	문자열	아니요	인증 키
» 계정	본문	문자열	아니요	계정 비밀번호는 username:password 형식으로 입력하세요. 계정과 비밀번호는 숫자와 문자만 지원하며, 특수 문자나 공백은 사용할 수 없습니다. 계정과 비밀번호는 콜론으로 구분합니다. 일괄 추가를 지원하며, 영어 쉼표(,)로 프록시 계정을 구분합니다.
» remark	body	string	아니요	대리 계정 설명
» product_type	본문	productTypes	아니요	패키지 유형, 9 동적 주거용 트래픽 패키지, 11 동적 주거용 IP, 14 정적 데이터 센터 IP, 25 정적 주거용 IP

열거형 값

속성	값
» product_type	9
» product_type	11
» 제품_유형	14
» 제품_유형	25

반환 예시

200 응답

{
	"code": 200,
	"msg": "string",
	"data": null
}

반환 결과

상태 코드	상태 코드 의미	설명	데이터 모델
200	OK	요청 성공	Inline

반환 데이터 구조

상태 코드 200

이름	유형	필수 사항	제약 조건	설명
» code	정수	거짓	없음	상태 코드, 200 성공, 3 app_key 유효하지 않음, 156 계정 실명 인증되지 않음
» 메시지	문자열	거짓	없음	상태 메시지
» data	null	false	없음	없음

POST 삭제 대리 계정

POST /openapi/whitelist-account/delete

삭제 후에는 복구할 수 없으며, 사용한 트래픽 등은 조회할 수 없습니다. 삭제에는 약 5분 정도의 시간이 소요되며, 이 동안에도 요금이 발생할 수 있습니다.

Body 요청 파라미터

{
	"app_key": "stringstringstringstringstringst",
	"accounts": "user01,user02"
}

요청 파라미터

이름	위치	유형	필수	설명
본문	본문	객체	아니요	없음
» app_key	본문	문자열	아니요	인증 키
» 계정	본문	문자열	아니요	프록시 계정, 숫자와 문자만 지원합니다. 대량 작업이 지원되며 영어 쉼표(,)로 프록시 계정을 구분합니다.

반환 예시

200 응답

{
	"code": 200,
	"msg": "string",
	"data": null
}

반환 결과

상태 코드	상태 코드 의미	설명	데이터 모델
200	OK	요청 성공	인라인

반환 데이터 구조

상태 코드 200

이름	유형	필수	제약 조건	설명
» 코드	정수	거짓	없음	상태 코드, 200 성공, 3 app_key 유효하지 않음, 156 계정 미실명 인증
» msg	string	false	없음	상태 메시지
» data	null	거짓	없음	없음

POST 프록시 계정 비활성화됨

POST /openapi/whitelist-account/disable

비활성화하는 데 약 5분 정도 소요되며, 이 시간 동안 요금이 발생할 수 있습니다.

Body 요청 파라미터

{
	"app_key": "stringstringstringstringstringst",
	"accounts": "user01,user02"
}

요청 파라미터

이름	위치	유형	필수 사항	설명
본문	본문	객체	아니요	없음
» app_key	본문	문자열	아니요	인증 키
» 계정	본문	문자열	아니요	프록시 계정, 숫자와 문자만 지원합니다. 대량 작업이 지원되며, 영어 쉼표(,)로 프록시 계정을 구분합니다.

반환 예시

200 응답

{
	"code": 200,
	"msg": "string",
	"data": null
}

반환 결과

상태 코드	상태 코드 의미	설명	데이터 모델
200	OK	요청 성공	인라인

반환 데이터 구조

상태 코드 200

이름	유형	필수 여부	제약 조건	설명
» code	정수	거짓	없음	상태 코드, 200 성공, 3 app_key 유효하지 않음, 156 계정 미실명 인증
» msg	string	거짓	없음	상태 메시지
» 데이터	null	거짓	없음	없음

POST 프록시 계정 활성화

POST /openapi/whitelist-account/enable

Body 요청 파라미터

{
	"app_key": "stringstringstringstringstringst",
	"accounts": "user01,user02"
}

요청 파라미터

이름	위치	유형	필수 사항	설명
본문	본문	객체	아니요	없음
» app_key	본문	문자열	아니요	인증 키
» 계정	본문	문자열	아니요	프록시 계정, 숫자와 문자만 지원합니다. 대량 작업이 지원되며, 영어 쉼표(,)로 프록시 계정을 구분합니다.

반환 예시

200 응답

{
	"code": 200,
	"msg": "string",
	"data": null
}

반환 결과

상태 코드	상태 코드 의미	설명	데이터 모델
200	OK	요청 성공	인라인

반환 데이터 구조

상태 코드 200

이름	유형	필수 여부	제약 조건	설명
» code	정수	거짓	없음	상태 코드, 200 성공, 3 app_key 유효하지 않음, 156 계정 미실명 인증
» msg	string	거짓	없음	상태 메시지
» 데이터	null	거짓	없음	없음

POST 프록시 계정 비밀번호 수정

POST /openapi/whitelist-account/change-password

수정 후 5분 대기 시간이 있습니다. 이 시간 동안 이전 비밀번호를 계속 사용할 수 있습니다.

Body 요청 매개변수

{
	"app_key": "stringstringstringstringstringst",
	"account": "user",
	"password": "pass"
}

요청 파라미터

이름	위치	유형	필수	설명
body	body	개체	아니요	없음
» app_key	본문	문자열	아니요	인증 키
» 계정	본문	문자열	아니요	대리 계정, 숫자와 글자만 지원합니다.
» 비밀번호	본문	문자열	아니요	대리 계정 새 비밀번호는 숫자와 문자만 지원합니다.

반환 예시

200 응답

{
	"code": 200,
	"msg": "string",
	"data": null
}

반환 결과

상태 코드	상태 코드 의미	설명	데이터 모델
200	OK	요청 성공	Inline

반환 데이터 구조

상태 코드 200

이름	유형	필수 사항	제약 조건	설명
» code	정수	거짓	없음	상태 코드, 200 성공, 3 app_key 유효하지 않음, 156 계정 실명 인증되지 않음
» 메시지	문자열	거짓	없음	상태 메시지
» data	null	false	없음	없음

POST 프록시 계정 메모 수정

POST /openapi/whitelist-account/change-remark

Body 요청 파라미터

{
	"app_key": "stringstringstringstringstringst",
	"account": "user",
	"remark": ""
}

요청 파라미터

이름	위치	유형	필수 사항	설명
본문	본문	객체	아니요	없음
» app_key	본문	문자열	아니요	인증 키
» 계정	본문	문자열	아니요	대리 계정, 숫자와 글자만 지원합니다.
» remark	body	string	아니요	대리 계정 새 메모, 32자(중국어) 또는 64자(영어) 이내.

반환 예시

200 응답

{
	"code": 200,
	"msg": "string",
	"data": null
}

반환 결과

상태 코드	상태 코드 의미	설명	데이터 모델
200	OK	요청 성공	Inline

반환 데이터 구조

상태 코드 200

이름	유형	필수	제약	설명
» 코드	정수	거짓	없음	상태 코드, 200 성공, 3 app_key 유효하지 않음, 156 계정 미실명 인증
» msg	string	false	없음	상태 메시지
» data	null	거짓	없음	없음

POST 수정 대리 계정 트래픽 상한

POST /openapi/whitelist-account/change-limit

트래픽 통계에 최대 5분 지연이 있을 수 있습니다. 즉, 실제 트래픽 소비량이 이 제한을 초과할 수 있습니다.

Body 요청 파라미터

{
	"app_key": "stringstringstringstringstringst",
	"account": "user",
	"limit": 0
}

요청 파라미터

이름	위치	유형	필수 사항	설명
본문	본문	객체	아니요	없음
» app_key	본문	문자열	아니요	인증 키
» 계정	본문	문자열	아니요	프록시 계정, 숫자와 문자만 지원합니다.
» 제한	본문	정수	아니요	트래픽 제한, 단위: GB, 0은 제한 없음을 의미합니다.

반환 예시

200 Response

{
	"code": 200,
	"msg": "string",
	"data": null
}

반환 결과

상태 코드	상태 코드 의미	설명	데이터 모델
200	OK	요청 성공	Inline

반환 데이터 구조

상태 코드 200

이름	유형	필수	제약	설명
» code	정수	false	none	상태 코드, 200 성공, 3 app_key 유효하지 않음, 156 계정 미실명 인증
» msg	문자열	거짓	없음	상태 메시지
» 데이터	null	false	none	없음

트래픽 로그 쿼리

GET 사용량 트래픽 일별 합계

GET /openapi/user-usage-flow/total

요청 파라미터

이름	위치	유형	필수 사항	설명
app_key	query	문자열(password)	예	인증 키
start_time	query	string(Y-m-d H:i:s)	아니요	시작 시간이며, 초 단위까지 정확하게 지정할 수 있습니다. 로그 기록에는 5분 이내의 지연이 있을 수 있습니다. 기본적으로 7일 이내입니다.
end_time	쿼리	string(Y-m-d H:i:s)	아니요	마감 시간이며, 초 단위까지 정확하게 지정할 수 있습니다. 로그 기록에는 5분 이내의 지연이 있을 수 있습니다. 기본값은 현재 시간입니다.
사용자 이름	쿼리	문자열	아니요	하위 계정 이름, 기본적으로 모든 계정을 쿼리하며, 하위 계정을 지정할 수 있습니다. 동일한 이름의 하위 계정을 추가한 경우, 이 쿼리는 동일한 이름의 프록시 계정의 모든 사용 기록을 반환합니다.
product_type	query	number	아니요	패키지 유형

반환 예시

200 응답

{
	"code": 200,
	"msg": "string",
	"data": {
		"list": [
			{
				"day": "2022-08-01",
				"flow": 0
			}
		]
	}
}

반환 결과

상태 코드	상태 코드 의미	설명	데이터 모델
200	OK	요청 성공	Inline

반환 데이터 구조

상태 코드 200

이름	유형	필수 사항	제약 조건	설명
» code	정수	거짓	없음	상태 코드, 200 성공, 3 app_key 유효하지 않음, 156 계정 실명 인증되지 않음
» 메시지	문자열	거짓	없음	상태 메시지
» data	object	false	없음	없음
»» 목록	[개체]	거짓	없음	없음
»»» 일	문자열	거짓	없음	날짜
»»» 흐름	정수	거짓	없음	소모 트래픽, 단위 KB

套餐 조회

GET 구매한 패키지 목록

GET /openapi/user-product/list

요청 매개변수

이름	위치	유형	필수	설명
app_key	query	string(password)	예	인증 키
trade_no	쿼리	string	아니요	주문 번호, 전체 주문 번호를 입력하세요. 퍼지 검색은 지원되지 않습니다.
페이지	쿼리	번호	아니요	페이지 매김, 기본값: 1
크기	쿼리	번호	아니요	페이지로 나누어 표시할 개수, 기본값: 20
제품_유형	쿼리	번호	아니요	패키지 유형

반환 예시

200 응답

{
	"code": 200,
	"msg": "string",
	"data": {
		"list": [
			{
				"id": 0,
				"created_at": "2022-05-13 12:14:15",
				"expired_at": "2022-05-13 12:14:15",
				"product_type": 9,
				"trade_no": "2022051312134339861461465434",
				"order": {
					"created_at": "2022-05-13 12:13:43",
					"pay_at": "2022-05-13 12:13:43",
					"title": "入门级"
				}
			}
		],
		"page": 1,
		"page_size": 20,
		"total_count": 0,
		"total_page": 0
	}
}

반환 결과

상태 코드	상태 코드 의미	설명	데이터 모델
200	OK	요청 성공	Inline

반환 데이터 구조

상태 코드 200

이름	유형	필수	제약 조건	설명
» code	정수	false	none	상태 코드, 200 성공, 3 app_key 유효하지 않음, 156 계정 미실명 인증
» msg	문자열	거짓	없음	상태 메시지
» 데이터	객체	거짓	없음	없음
»» 목록	[객체]	거짓	없음	없음
»»» id	정수	거짓	없음	패키지 번호
»»» created_at	문자열	거짓	없음	패키지 활성화 시간
»»» expired_at	문자열	거짓	없음	패키지 만료 시간, 만료 후 트래픽을 사용할 수 없습니다.
»»» product_type	productTypes	false	없음	패키지 유형, 9 동적 주거용 트래픽 패키지, 11 동적 주거용 IP, 14 고정 데이터 센터 IP, 25 고정 주거용 IP
»»» trade_no	string	거짓	없음	주문 거래 번호
»»» order	객체	거짓	없음	없음
»»»» created_at	string	false	없음	주문 생성 시간
»»»» pay_at	string	false	없음	주문 결제 시간
»»»» 제목	string	거짓	없음	주문 설명
»» 페이지	정수	거짓	없음	현재 페이지
»» page_size	정수	거짓	없음	페이지 크기
»» total_count	정수	거짓	없음	총 레코드 수
»» total_page	정수	거짓	없음	총 페이지 수

열거형 값

속성	값
product_type	9
product_type	11
제품_유형	14
제품_유형	25

IP 추출

GET IP 추출

GET /openapi/ip/v3

요청 파라미터

이름	위치	유형	필수	설명
app_key	query	문자열(비밀번호)	아니요	액세스 키
cc	쿼리	문자열	아니요	국가 또는 지역
상태	쿼리	문자열	아니요	도 또는 주
도시	쿼리	문자열	아니요	도시
format	query	문자열	아니요	형식 가져오기
lb	쿼리	문자열	아니요	간격 문자, 텍스트 형식에만 유효함
수	쿼리	번호	아니요	수량 추출
life	query	숫자	아니요	유지 주기(분)
ep	query	문자열	아니요	프록시 네트워크

반환 예시

200 응답

{
	"code": 200,
	"msg": "string",
	"data": {
		"list": [
			[
				"150.109.114.72:1140",
				"150.109.114.72:1141",
				"150.109.114.72:1142",
				"150.109.114.72:1143",
				"150.109.114.72:1144",
				"150.109.114.72:1145",
				"150.109.114.72:1146",
				"150.109.114.72:1147",
				"150.109.114.72:1148",
				"150.109.114.72:1149"
			]
		]
	}
}

반환 결과

상태 코드	상태 코드 의미	설명	데이터 모델
200	OK	요청 성공	인라인

반환 데이터 구조

상태 코드 200

이름	유형	필수	제약 조건	설명
» 코드	정수	거짓	없음	상태 코드, 200 성공, 3 app_key 유효하지 않음, 156 계정 미실명 인증
» msg	string	false	없음	상태 메시지
» data	object	거짓	없음	없음
»» 목록	[임의]	거짓	없음	없음

GET 도시 목록

GET /openapi/ip/dynamic-citys

반환 예시

200 응답

{
	"code": 200,
	"msg": "string",
	"data": {
		"list": [
			{
				"name_zh_cn": "美国",
				"name_en": "United States",
				"continent_code": "NA",
				"country_code": "US",
				"items": [
					{
						"city": null,
						"state": null,
						"continent_code": null,
						"country_code": null
					}
				]
			}
		]
	}
}

반환 결과

상태 코드	상태 코드 의미	설명	데이터 모델
200	OK	요청 성공	Inline

반환 데이터 구조

상태 코드 200

이름	유형	필수 사항	제약 조건	설명
» code	정수	거짓	없음	상태 코드, 200 성공, 3 app_key 유효하지 않음, 156 계정 실명 인증되지 않음
» 메시지	문자열	거짓	없음	상태 메시지
» data	object	false	없음	없음
»» 목록	[개체]	거짓	없음	목록
»»» name_zh_cn	문자열	거짓	없음	국가 또는 지역 이름
»»» name_ko	문자열	거짓	없음	국가 또는 지역 이름
»»» continent_code	string	false	없음	대륙 코드
»»» country_code	string	거짓	없음	국가 또는 지역 코드
»»» 항목	[개체]	거짓	없음	도 또는 주
»»»» 도시	문자열	거짓	없음	도시 이름
»»»» state	string	false	없음	도 또는 주 이름 코드
»»»» continent_code	string	거짓	없음	대륙 코드
»»»» country_code	문자열	거짓	없음	국가 또는 지역 코드

GET 도시 검색

GET /openapi/ip/dynamic-citys/search

요청 매개변수

이름	위치	유형	필수	설명
국가_코드	쿼리	문자열	예	국가 또는 지역 코드
state	query	string	예	주 또는 지방 코드

반환 예시

200 응답

{
	"code": 200,
	"msg": "string",
	"data": {
		"list": ["string"]
	}
}

반환 결과

상태 코드	상태 코드 의미	설명	데이터 모델
200	OK	요청 성공	Inline

반환 데이터 구조

상태 코드 200

이름	유형	필수 항목	제약 조건	설명
» code	정수	거짓	없음	상태 코드, 200 성공, 3 app_key 유효하지 않음, 156 계정 실명 인증되지 않음
» 메시지	문자열	거짓	없음	상태 메시지
» data	object	false	없음	없음
»» 목록	[문자열]	거짓	없음	목록

GET 주 목록

GET /openapi/ip/dynamic-states

반환 예시

200 응답

{
	"code": 200,
	"msg": "string",
	"data": {
		"list": [
			{
				"name_zh_cn": "美国",
				"name_en": "United States",
				"continent_code": "NA",
				"country_code": "US",
				"items": [
					{
						"state": null,
						"continent_code": null,
						"country_code": null
					}
				]
			}
		]
	}
}

반환 결과

상태 코드	상태 코드 의미	설명	데이터 모델
200	OK	요청 성공	Inline

반환 데이터 구조

상태 코드 200

이름	유형	필수	제약 조건	설명
» code	정수	false	none	상태 코드, 200 성공, 3 app_key 유효하지 않음, 156 계정 미실명 인증
» msg	문자열	거짓	없음	상태 메시지
» 데이터	객체	거짓	없음	없음
»» 목록	[객체]	거짓	없음	목록
»»» name_zh_cn	문자열	거짓	없음	국가 또는 지역 이름
»»» name_en	문자열	거짓	없음	국가 또는 지역 이름
»»» continent_code	문자열	거짓	없음	대륙 코드
»»» country_code	string	false	없음	국가 또는 지역 코드
»»» items	[객체]	거짓	없음	도 또는 주
»»»» 상태	문자열	거짓	없음	도/주 이름 코드
»»»» continent_code	string	false	없음	대륙 코드
»»»» country_code	string	거짓	없음	국가 또는 지역 코드

GET 주/도 검색

GET /openapi/ip/dynamic-states/search

요청 파라미터

이름	위치	유형	필수	설명
country_code	쿼리	문자열	예	국가 또는 지역 코드

반환 예시

200 응답

{
	"code": 200,
	"msg": "string",
	"data": {
		"list": ["string"]
	}
}

반환 결과

상태 코드	상태 코드 의미	설명	데이터 모델
200	OK	요청 성공	인라인

반환 데이터 구조

상태 코드 200

이름	유형	필수 여부	제약 조건	설명
» code	정수	거짓	없음	상태 코드, 200 성공, 3 app_key 유효하지 않음, 156 계정 미실명 인증
» msg	string	거짓	없음	상태 메시지
» 데이터	객체	거짓	없음	없음
»» 목록	[문자열]	거짓	없음	목록

GET 정적 IP 목록 가져오기

GET /ip/get-static-ip

요청 매개변수

이름	위치	유형	필수	설명
country_code	쿼리	문자열	아니요	국가 또는 지역 코드
제품_유형	쿼리	번호	아니요	제품 유형, 25:정적 주거 IP, 14: 데이터 센터 IP
trade_no	query	string	아니요	주문 번호로 IP 필터링
페이지	쿼리	번호	아니요	페이지 번호
크기	쿼리	번호	아니요	페이지당 개수
상태	쿼리	번호	아니요	상태, 1:유효, 2:무효, 3:만료 임박, 4:유지 관리 중

열거형 값

속성	값
제품_유형	14
제품_유형	25
상태	1
상태	2
상태	3
상태	4

반환 예시

200 응답

{}

반환 결과

상태 코드	상태 코드 의미	설명	데이터 모델
200	OK	없음	인라인

반환 데이터 구조

데이터 모델

상품 유형

패키지 유형, 9 동적 주거용 트래픽 패키지, 11 동적 주거용 IP, 14 고정 데이터 센터 IP, 25 고정 주거용 IP

속성

이름	유형	필수 여부	제약 조건	中文名	설명
익명	정수	거짓	없음		패키지 유형, 9 동적 주거용 트래픽 패키지, 11 동적 주거용 IP, 14 고정 데이터 센터 IP, 25 고정 주거용 IP

열거형 값

속성	값
익명	9
익명	11
익명	14
익명	25

apiKey

null

인증 키

속성

없음

responseCode

상태 코드, 200 성공, 3 app_key 유효하지 않음

속성

이름	유형	필수	제약	중국어 이름	설명
익명의	정수	거짓	없음		상태 코드, 200 성공, 3 app_key 유효하지 않음

responseMsg

"success"

응답 메시지

속성

이름	유형	필수	제약 조건	중국어 이름	설명
익명	문자열	거짓	없음		응답 메시지