Proxy-seller

대리인 및 주문

Updated:

권한: account:read, account:write, 청구:작성

이 그룹에서

도구

기능 설명

list_proxies

🟢 read

특정 유형의 활성 프록시: IP, HTTP/SOCKS 포트, 인증 정보, 국가, 만료일, 자동 갱신 상태 및 비고.

export_proxies

🟢 read

프록시를 한 줄에 하나씩, 바로 사용할 수 있는 목록 형태로 내보내십시오.

get_reference

🟢 read

제품 유형별 이용 가능 국가, 대여 기간 및 패키지.

calc_order_cost

🟢 read

주문을 진행하지 않은 상태에서 신규 주문에 대한 가격 및 할인 정보.

make_order

💳 pays

새로운 프록시 주문을 생성하십시오.

list_orders

🟢 read

주문 내역(최신 순) 및 해당 계정에 이미 등록된 사용 대상 목록.

check_order_status

🟢 read

주문된 프록시가 발급되었는지 확인합니다.

calc_prolong_cost

🟢 read

갱신 없이 특정 프록시의 갱신 가격.

make_prolong

💳 pays

프록시를 한 기간 더 갱신하십시오.

replace_proxy

🟡 write

작동하지 않는 프록시를 교체해 주시기 바랍니다.

set_proxy_comment

🟡 write

하나 이상의 프록시에 동일한 코멘트를 설정하십시오.

list_proxies

🟢 read-only · account:read

특정 유형의 활성 프록시: IP, HTTP/SOCKS 포트, 인증 정보, 국가, 만료일, 자동 갱신 상태 및 비고. password 요청하지 않는 한 가면으로 돌아옵니다. 프록시를 사용하는 경우 status: "Ended" 는 곧 종료됩니다, 만료되지 않음 — date_end 이것이 실제 만료일입니다.

매개변수

유형

설명

type 필수

프록시 유형

제품 유형. mix 이는 IPv4 MIX 패키지에만 해당하며, mix_isp ISP MIX 패키지 — 두 개의 별도 목록이므로, “내 모든 MIX 프록시”는 두 가지를 모두 의미합니다. subresident 여기서는 제공되지 않습니다: 다음을 사용하십시오 list_resident_subuser_lists

orderId

문자열 | 정수

주문은 하나만 가능합니다

country

string

알파-3 코드, 예: USA

latest

boolean

가장 최근에 발급된 프록시만

ends

boolean

곧 만료되는 프록시만

page, per_page

정수

돌아가기 페이지 (기본값) 1) 및 페이지 크기(기본값 50)

reveal

boolean

돌아가기 password 'in clear' 대신 ••••. 조교가 먼저 확인을 요청합니다 — 참조 프록시 비밀번호 및 AI 제공업체

반환 값: {items: [...]} — 프록시당 하나의 객체를 포함하며 id, ip, protocol, port_http, port_socks, login, password, country, country_alpha3, date_start, date_end, status, status_type, can_prolong, auto_renew, comment, order_id, order_number, base_order_number. 응답은 페이지 단위로 표시되며(기본값은 페이지당 50개), 다음 내용을 포함합니다. page, per_page, total, total_pages, 그리고 _note 더 많은 페이지가 존재할 경우. 예를 들어 resident 여기서 항목이란 IP가 아닌 주거지 목록을 의미합니다. 예를 들어, mix / mix_isp 하나의 패키지가 여러 국가에 걸쳐 배포되는 경우: order_number 그리고 base_order_number 국가별 접미사를 붙여야 합니다 (NS_…-dX_GBR, NS_…-dX_DEU) 반면 order_id 공유됨 — 그룹별 order_id; a _note 결과에 그렇게 나와 있습니다. password is "••••" 단, reveal: true. ⚠️ 민감한 데이터 — 결과에는 어시스턴트가 사용자에게 반복해 알려주는 경고 메시지가 포함됩니다.

export_proxies

🟢 read-only · account:read

프록시를 바로 사용할 수 있는 목록 형태로 내보내며, 한 줄에 하나의 프록시만 포함해야 합니다. 기본적으로 가려진 상태로 표시됩니다: ip:port. reveal: true 선들은 연결할 수 있습니다 login:password@host:port.

매개변수

유형

설명

type 필수

프록시 유형, 포함: subresident

제품 유형

ext

string

txt (기본값), csv, 또는 다음과 같은 템플릿을 사용하십시오. %login%:%password%@%ip%:%port%. 없이 reveal, txt 다음과 같이 변경됩니다 %ip%:%port%; csv (고정 레이아웃의 ip;port;login;password (항상 비밀번호가 포함되어 있음) 및 템플릿 명명 규칙 %password% 공개 확인을 할 때까지 거부됩니다

proto

https | socks5

단일 포트 유형(주거용 제외)

protocol

http | socks5

주거용만 (resident, subresident): 각 줄의 구성 방식. 다음을 사용하여 txt 한 줄이 다음과 같이 변경됩니다. socks5://login:password@host:port; csv 열을 유지하며; 템플릿은 값을 가져옵니다. %protocol% (템플릿에는 다음을 포함할 수 없습니다 /, 따라서 다음을 사용하십시오 txt for scheme:// 줄). 이것이 없으면 줄은 체계가 없습니다. 다음과는 다릅니다. proto; 없습니다 https. socks5 또한 UDP 및 HTTP/3(QUIC)도 지원합니다.

host

res.proxy-seller.com | us.res.proxy-seller.com | asia.res.proxy-seller.com

거주지 한정: 각 줄의 게이트웨이 — 유럽(기본값), 미국 또는 아시아. 진입 지점만 기재하며, 출구 IP 위치는 목록 설정에서 가져옵니다.

country

string

알파-3 코드 (주거용 제외)

ends

boolean

조만간 만료되는 프록시만 허용 (일반 가정용 제외)

listId

문자열 | 정수

거주지 목록 ID (resident 그리고 subresident); 모든 목록을 내보내지 않으려면 생략하십시오

package_key

string

서브패키지 키, 다음을 포함하여: type: "subresident"

maxLine

정수

최대 줄 수, 주거 지역 전용

reveal

boolean

Return connectable login:password@host:port 줄 대신 ip:port. 보조 담당자가 먼저 귀하와 확인합니다 — 참조 프록시 비밀번호 및 AI 제공업체

반환 값: 주거용 protocol 다음 문장들은 그 방식을 보여줍니다: socks5://host:port 기본적으로, socks5://login:password@host:port with reveal: true. 없이 reveal 해당 줄 뒤에는 비밀번호가 생략되었다는 메모가 붙어 있습니다. 조수가 이를 전달하므로, 비밀번호가 없는 목록은 요청하신 인증 정보로 제시되지 않습니다. 요청 시 csv 비밀번호를 요청하고 있습니다: 어시스턴트가 해당 파일을 내보내면 대화 기록에 프록시 인증 정보가 포함될 것이라고 경고하며, 내보내기 전에 확인을 요청합니다.

get_reference

🟢 read-only · account:read

제품 유형별 이용 가능 국가, 대여 기간 및 패키지. 가격 확인 또는 주문 전에 필요한 정보입니다. 국가명은 알파-3 코드(USA), 마침표는 짧은 코드입니다 (1m). 모바일의 경우 연산자 및 회전 옵션도 반환하며, 가정용의 경우 — 통신 요금도 반환합니다.

매개변수

유형

설명

type 필수

프록시 유형

제품 유형

calc_order_cost

🟢 read-only · account:read

주문을 진행하지 않은 상태에서의 신규 주문 가격 및 할인 정보. 다음 매개변수와 동일한 매개변수를 사용합니다. make_order.

make_order

💳 spends money · billing:write

새로운 프록시 주문을 생성합니다. 잔액에서 요금이 청구됩니다. 두 번 호출하면 두 건의 주문이 생성됩니다.

매개변수

유형

설명

type 필수

프록시 유형

제품 유형 (사용 make_resident_order (일반 사용자 트래픽용)

countryId 필수

string

출처: get_reference, 예: USA

periodId 필수

string

출처: get_reference, 예: 1m

quantity 필수

정수

프록시 수 (ipv6 (최소 10개)

paymentId 필수

string

balance 또는 paddle_subscription

customTargetName

string

프록시의 용도를 간결한 사이트 또는 서비스 이름(Google, Instagram) 형태로 기술하십시오. 필수 항목입니다. ipv4, ipv6, isp. 해당 계정이 한 번도 사용한 적이 없는 수취인은 신규 수취인으로 간주됩니다. 관리자가 수동으로 승인해야 하며, 승인 전까지 주문은 보류 상태로 유지되므로, 담당자는 해당 계정의 기존 수취인 중 한 곳을 선호합니다 (list_orders → targets)

coupon

string

프로모션 코드

generateAuth

boolean

새 프록시용 로그인/비밀번호 생성

protocol

HTTPS | SOCKS5

프로토콜 재정의

mobileServiceType

shared | dedicated

모바일 전용, 필수

operatorId

string

모바일 전용, 필수 — 통신사: get_reference

rotationId

string

모바일 전용, 필수 — 분 단위의 로테이션 get_reference

mixId

string

MIX 전용 — 다음에서 코드 패키징: get_reference

uptime

boolean

IPv4/ISP 전용 — 제공되는 경우 고가용성 모드

흔히 발생하는 오류: 주문이 결제되었으나 1분 이상 처리 대기 상태로 남아 있습니다. 그 때 customTargetName 이 계정을 처음 사용하는 경우, provisioning.targetNote 다음과 같이 설명합니다: CRM이 새로운 사용 대상을 생성하면 관리자가 수동으로 승인하고, 그 후에 프록시가 발급됩니다. 결제나 주식에는 아무런 문제가 없습니다. 나중에 다음을 통해 다시 확인하십시오. check_order_status, 또는 다음 번에 기존 대상 언어를 재사용하십시오.

list_orders

🟢 read-only · account:read

최신 순으로 정렬된 주문 내역(구매 및 연장) — ID, 상태, 금액, 날짜, 프록시 유형 및 사용 대상, 그리고 계정의 고유한 사용 대상 정보를 포함합니다. 이를 활용하여 customTargetName 주문하기 전에 계정에 이미 있는 것을 확인하여, order_id 중시하는 점은 ipv6 / mix / mix_isp 갱신에는 다음이 소요됩니다. orderIds, 그리고 주문 내역의 경우.

매개변수

유형

설명

order_id

문자열 | 정수

한 건의 주문 (order_id 연장된 형태와 함께 반환합니다; 행의 숫자 id (해당 행을 반환합니다)

start_date / end_date

string

작성 날짜 범위, yyyy-MM-dd 또는 dd.MM.yyyy

status

PAYED | NOT_PAYED | RETURN

기계 상태 필터

is_extend

boolean

true 연장 요청만, false 구매 전용

auto_order

boolean

true API를 통해 배치되거나 자동으로 갱신되는, false 수동으로 입력됨

page / limit

정수

페이지 나누기: 기본적으로 페이지당 50행; a _note 더 많은 페이지가 존재할 때 표시됩니다. targets 항상 모든 일치하는 순서를 모두 포함합니다

반환 값: {metadata: {total_orders, total_pages, current_page, current_limit}, items: [{id, order_id, order_number, base_order_number, status, status_type, summ, date_insert, date_payed, payment_name, is_extend, auto_order, auth_way, auth_ip, protocol, items: [{order_part_id, type, quantity, target, target_section, time, price, name, ...}], ...}], targets: string[], _note?}. summ 는 화폐 문자열입니다 ($12.50), 날짜는 ISO 8601 형식을 따르며, 사용 대상은 각 주문 항목에 따라 다릅니다 (items[].items[].target); 분기점 status_type, 아니라 status.

check_order_status

🟢 read-only · account:read

위임장을 집계하여, 접수된 주문에 대한 위임장이 발급되었는지 확인합니다. list_proxies 주문에도 동일하게 적용됩니다 — 모든 유형에 대해 MIX 패키지가 포함됩니다. MIX 주문에는 아직 IP 주소가 명시되어 있지 않지만, 국가별 로그인 정보는 list_auth 는 대체 증거입니다 (started). 반복해서 호출해도 안전하며, 상태와 다음 단계를 반환합니다. 캐비닛은 MIX 패키지에 다음과 같은 라벨을 붙입니다. order_part_id, 이는 다음과 다릅니다. orderId; 순서는 동일합니다.

매개변수

유형

설명

type 필수

프록시 유형

제품 유형

orderId 필수

문자열 | 정수

orderId 출처: make_order

expectedQuantity

정수

주문 수량, 부분 배송 감지용

baseOrderNumbers

string[]

MIX 전용 — listBaseOrderNumbers 출처: make_order 로그인 대체 수단으로 사용되는 응답

반환 값: status is provisioned, partial, started (MIX: 로그인 정보는 존재하나, IP 주소는 아직 기재되지 않음) 또는 pending. proxies[] 다음은 발행된 기록이며 password masked — 사용 list_proxies / export_proxies with reveal: true 자격 증명서.

calc_prolong_cost

🟢 read-only · account:read

갱신 없이 특정 프록시의 갱신 가격. 다음과 동일한 매개변수: make_prolong.

반환 값: items 갱신될 프록시들은 다음과 같습니다. password masked.

make_prolong

💳 spends money · billing:write

프록시를 한 기간 더 갱신합니다. 선택한 결제 수단으로 요금이 청구됩니다. 두 번 호출하면 요금이 두 번 청구됩니다.

매개변수

유형

설명

type 필수

ipv4 | ipv6 | mobile | isp | mix | mix_isp

제품 유형. 주거용 패키지는 기간별로 갱신되지 않으며, 트래픽을 구매하면 make_resident_order

periodId 필수

string

출처: get_reference

paymentId 필수

string

balance 또는 다음의 메서드에서 list_payments

ips

string[]

ipv4 / isp / mobile: 프록시 주소는 다음과 같이 list_proxies 그것들을 보여줍니다

ids

(문자열 | 정수)[]

ipv4 / isp / mobile: 프록시 ID

orderIds

(문자열 | 정수)[]

ipv6 / mix / mix_isp: the order_id 값 출처: list_proxies. 이러한 상품은 전체 주문 단위로 판매 및 갱신되며, 주문에 포함된 모든 활성 프록시가 갱신되고 요금이 청구됩니다.

coupon

string

프로모션 코드

어떤 선택자가 적용되는지는 다음 요소에 따라 달라집니다. type: ipv4, isp 그리고 mobile take ids 또는 ips; ipv6, mix 그리고 mix_isp take orderIds. 전체 주문 유형의 경우 여전히 다음을 전달할 수 있습니다. ids 또는 ips — 어시스턴트 도구가 이를 명령어로 변환하지만 — API 자체는 오직 orderIds 여기.

흔히 발생하는 오류: 갱신 중인 주문에 대한 두 번째 갱신 요청이 결제 전에 거부됨(코드 57, “이미 진행 중”) — 요금이 청구되지 않음; 잠시 기다린 후 다시 확인하십시오. list_proxies 무턱대고 다시 시도하기보다는. “연장이 적용되지 않았으며, 결제 금액이 잔액으로 환불되었습니다”는 갱신이 취소되었고, 해당 금액이 잔액으로 돌아왔음을 의미합니다.

replace_proxy

🟡 changes account state · account:write

작동하지 않는 프록시를 교체해 달라고 요청하십시오. 각 프록시는 하루에 한 번씩 교체할 수 있습니다.

매개변수

유형

설명

ids 필수

(문자열 | 정수)[]

프록시 ID

reason 필수

NOT_WORK | INCORRECT_LOCATION | CANT_CHANGE_NETWORK | LOW_SPEED | CUSTOM

이유

comment

string

다음과 같은 경우 필수입니다. reason is CUSTOM

set_proxy_comment

🟡 changes account state · account:write

하나 이상의 프록시에 동일한 주석을 설정합니다. 이전 주석을 덮어씁니다. 빈 문자열을 입력하면 주석이 지워집니다.

매개변수

유형

설명

ids 필수

(문자열 | 정수)[]

프록시 ID

comment 필수

string

설명 텍스트

다음 단계

On this page