대리인 및 주문
Updated:
권한: account:read, account:write, 청구:작성
이 그룹에서
도구 | 기능 설명 | |
|---|---|---|
🟢 | 특정 유형의 활성 프록시: IP, HTTP/SOCKS 포트, 인증 정보, 국가, 만료일, 자동 갱신 상태 및 비고. | |
🟢 | 프록시를 한 줄에 하나씩, 바로 사용할 수 있는 목록 형태로 내보내십시오. | |
🟢 | 제품 유형별 이용 가능 국가, 대여 기간 및 패키지. | |
🟢 | 주문을 진행하지 않은 상태에서 신규 주문에 대한 가격 및 할인 정보. | |
💳 | 새로운 프록시 주문을 생성하십시오. | |
🟢 | 주문 내역(최신 순) 및 해당 계정에 이미 등록된 사용 대상 목록. | |
🟢 | 주문된 프록시가 발급되었는지 확인합니다. | |
🟢 | 갱신 없이 특정 프록시의 갱신 가격. | |
💳 | 프록시를 한 기간 더 갱신하십시오. | |
🟡 | 작동하지 않는 프록시를 교체해 주시기 바랍니다. | |
🟡 | 하나 이상의 프록시에 동일한 코멘트를 설정하십시오. |
list_proxies
🟢 read-only · account:read
특정 유형의 활성 프록시: IP, HTTP/SOCKS 포트, 인증 정보, 국가, 만료일, 자동 갱신 상태 및 비고. password 요청하지 않는 한 가면으로 돌아옵니다. 프록시를 사용하는 경우 status: "Ended" 는 곧 종료됩니다, 만료되지 않음 — date_end 이것이 실제 만료일입니다.
매개변수 | 유형 | 설명 |
|---|---|---|
| 프록시 유형 | 제품 유형. |
| 문자열 | 정수 | 주문은 하나만 가능합니다 |
| string | 알파-3 코드, 예: |
| boolean | 가장 최근에 발급된 프록시만 |
| boolean | 곧 만료되는 프록시만 |
| 정수 | 돌아가기 페이지 (기본값) |
| boolean | 돌아가기 |
반환 값: {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.
매개변수 | 유형 | 설명 |
|---|---|---|
| 프록시 유형, 포함: | 제품 유형 |
| string |
|
|
| 단일 포트 유형(주거용 제외) |
|
| 주거용만 ( |
|
| 거주지 한정: 각 줄의 게이트웨이 — 유럽(기본값), 미국 또는 아시아. 진입 지점만 기재하며, 출구 IP 위치는 목록 설정에서 가져옵니다. |
| string | 알파-3 코드 (주거용 제외) |
| boolean | 조만간 만료되는 프록시만 허용 (일반 가정용 제외) |
| 문자열 | 정수 | 거주지 목록 ID ( |
| string | 서브패키지 키, 다음을 포함하여: |
| 정수 | 최대 줄 수, 주거 지역 전용 |
| boolean | Return connectable |
반환 값: 주거용 protocol 다음 문장들은 그 방식을 보여줍니다: socks5://host:port 기본적으로, socks5://login:password@host:port with reveal: true. 없이 reveal 해당 줄 뒤에는 비밀번호가 생략되었다는 메모가 붙어 있습니다. 조수가 이를 전달하므로, 비밀번호가 없는 목록은 요청하신 인증 정보로 제시되지 않습니다. 요청 시 csv 비밀번호를 요청하고 있습니다: 어시스턴트가 해당 파일을 내보내면 대화 기록에 프록시 인증 정보가 포함될 것이라고 경고하며, 내보내기 전에 확인을 요청합니다.
get_reference
🟢 read-only · account:read
제품 유형별 이용 가능 국가, 대여 기간 및 패키지. 가격 확인 또는 주문 전에 필요한 정보입니다. 국가명은 알파-3 코드(USA), 마침표는 짧은 코드입니다 (1m). 모바일의 경우 연산자 및 회전 옵션도 반환하며, 가정용의 경우 — 통신 요금도 반환합니다.
매개변수 | 유형 | 설명 |
|---|---|---|
| 프록시 유형 | 제품 유형 |
calc_order_cost
🟢 read-only · account:read
주문을 진행하지 않은 상태에서의 신규 주문 가격 및 할인 정보. 다음 매개변수와 동일한 매개변수를 사용합니다. make_order.
make_order
💳 spends money · billing:write
새로운 프록시 주문을 생성합니다. 잔액에서 요금이 청구됩니다. 두 번 호출하면 두 건의 주문이 생성됩니다.
매개변수 | 유형 | 설명 |
|---|---|---|
| 프록시 유형 | 제품 유형 (사용 make_resident_order (일반 사용자 트래픽용) |
| string | 출처: get_reference, 예: |
| string | 출처: get_reference, 예: |
| 정수 | 프록시 수 ( |
| string |
|
| string | 프록시의 용도를 간결한 사이트 또는 서비스 이름(Google, Instagram) 형태로 기술하십시오. 필수 항목입니다. |
| string | 프로모션 코드 |
| boolean | 새 프록시용 로그인/비밀번호 생성 |
|
| 프로토콜 재정의 |
|
| 모바일 전용, 필수 |
| string | 모바일 전용, 필수 — 통신사: get_reference |
| string | 모바일 전용, 필수 — 분 단위의 로테이션 get_reference |
| string | MIX 전용 — 다음에서 코드 패키징: get_reference |
| 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, 그리고 주문 내역의 경우.
매개변수 | 유형 | 설명 |
|---|---|---|
| 문자열 | 정수 | 한 건의 주문 ( |
| string | 작성 날짜 범위, |
|
| 기계 상태 필터 |
| boolean |
|
| boolean |
|
| 정수 | 페이지 나누기: 기본적으로 페이지당 50행; a |
반환 값: {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; 순서는 동일합니다.
매개변수 | 유형 | 설명 |
|---|---|---|
| 프록시 유형 | 제품 유형 |
| 문자열 | 정수 |
|
| 정수 | 주문 수량, 부분 배송 감지용 |
| string[] | MIX 전용 — |
반환 값: 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
프록시를 한 기간 더 갱신합니다. 선택한 결제 수단으로 요금이 청구됩니다. 두 번 호출하면 요금이 두 번 청구됩니다.
매개변수 | 유형 | 설명 |
|---|---|---|
|
| 제품 유형. 주거용 패키지는 기간별로 갱신되지 않으며, 트래픽을 구매하면 make_resident_order |
| string | 출처: get_reference |
| string |
|
| string[] |
|
| (문자열 | 정수)[] |
|
| (문자열 | 정수)[] |
|
| 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
작동하지 않는 프록시를 교체해 달라고 요청하십시오. 각 프록시는 하루에 한 번씩 교체할 수 있습니다.
매개변수 | 유형 | 설명 |
|---|---|---|
| (문자열 | 정수)[] | 프록시 ID |
|
| 이유 |
| string | 다음과 같은 경우 필수입니다. |
set_proxy_comment
🟡 changes account state · account:write
하나 이상의 프록시에 동일한 주석을 설정합니다. 이전 주석을 덮어씁니다. 빈 문자열을 입력하면 주석이 지워집니다.
매개변수 | 유형 | 설명 |
|---|---|---|
| (문자열 | 정수)[] | 프록시 ID |
| string | 설명 텍스트 |