Proxy-seller

대리인을 통한 작업

Updated:

프록시 주문 내 IP를 관리하십시오 — 목록 작성, 순환, 기간 연장 또는 주석 달기 등을 수행하십시오.

공통 매개변수. 이 페이지의 모든 엔드포인트는 특정 순서에 따라 작동합니다. orderNumber를 전달하십시오 — 이 값은 다음에서 가져옵니다. GET /proxy/list.

GEThttps://proxy-seller.com/personal/api/v2/{apiKey}/proxy/list
유형별로 그룹화된 활성 프록시를 반환합니다.
GEThttps://proxy-seller.com/personal/api/v2/{apiKey}/proxy/list/{type}
한 가지 유형의 활성 프록시를 반환합니다. /proxy/list와 동일한 쿼리 매개변수를 지원합니다.

경로 매개변수

이름

가치

필수 사항

설명

유형

ipv4, ipv6, mobile, isp, mix, mix_isp, 또는 resident

예

다운로드된 목록에 포함할 프록시의 유형을 지정합니다.


승인

<Your_API_Key>

예

개인 API 키 (획득 방법)

쿼리 매개변수

이름

유형

필수 사항

설명

최신

문구

아니요

Y다음 조건에서 가장 최근의 활성 주문에 포함된 프록시를 반환합니다. orderId 제공되지 않습니다.

orderId

문구

아니요

특정 orderId 또는 OrderPart.number에 해당하는 프록시를 반환합니다.

국가

문구

아니요

Alpha3 국가명 (FRA 또는 DEU 등…)

끝

문구

아니요

Y 다음만 반환합니다 ENDED 여전히 남아 있는 프록시 dateEnd 향후. 그렇지 않은 경우 폐쇄형 프록시는 제외됩니다.

예시

모든 유형의 프록시를 검색하려면:

https://proxy-seller.com/personal/api/v2/afoov21vcoodewq/proxy/list

특정 유형(예: IPv4)의 프록시를 검색하려면:

https://proxy-seller.com/personal/api/v2/afoov21vcoodewq/proxy/list/ipv4

답변

모든 유형의 프록시

{
  "status": "success",
  "data": {
    "ipv4": [],
    "ipv6": [],
    "mobile": [],
    "isp": [],
    "mix": [],
    "mix_isp": [],
    "resident": []
  },
  "errors": []
}

프록시의 한 유형

{
    "status": "success",
    "data": {
        "items": [
            {
                "id": "69fa4b7f256cae5b70a79478",
                "order_id": "69fa4b795a1f522c7a53d589",
                "order_number": "TEST_1778011001948-uc_e_UUf2Z3RtGH",
                "basket_id": "69fa4b7a5a1f522c7a53d58b",
                "ip": "11.55.11.0",
                "ip_only": "11.55.11.0",
                "protocol": "HTTP",
                "port_socks": 49453,
                "port_http": 49353,
                "login": "login",
                "password": "password",
                "authIp": "",
                "rotation": null,
                "link_reboot": "#",
                "country": "Germany",
                "country_alpha3": "DEU",
                "status": "Active",
                "status_type": "ACTIVE",
                "can_prolong": true,
                "date_start": "05.05.2026",
                "date_end": "11.06.2026",
                "comment": "",
                "auto_renew": "N",
                "auto_renew_period": ""
            }
        ]
    },
    "errors": []
}

잘못된 프록시 유형

{
    "status": "error",
    "data": null,
    "errors": [
        {
            "message": "Could not find description of list/{type} in CrmUserApiProxy",
            "code": 22002,
            "customData": null
        }
    ]
}

프록시 유형이 지정되지 않은 경우, 프로필에 대해 사용 가능한 모든 유형이 반환된다는 점에 유의해 주십시오.

GEThttps://proxy-seller.com/personal/api/v2/{apiKey}/proxy/download/{type}
IP 내보내기
이 API 엔드포인트를 통해 자신의 프록시 목록을 다운로드할 수 있습니다.

경로 매개변수:

이름

가치

필수 사항

설명

유형

ipv4, ipv6, mobile, isp, mix, mix_isp, 또는 resident

예

다운로드된 목록에 포함할 프록시의 유형을 지정합니다.

승인

<Your_API_Key>

예

개인 API 키 (획득 방법)

선택적 매개변수

이름

가치

설명

ext

txt

csv

프록시 목록을 다운로드할 형식을 지정합니다.

%login%:%password%@%ip%:%port%

사용자 정의 형식

proto

https

socks5

프록시에 대해 선호하는 프록시 포트 형식을 지정합니다.

listId

정수

프록시 목록 ID (상주 서버용이며, 설정되지 않은 경우 모든 시트의 IP를 반환합니다)

package_key

문구

프록시 목록 package_key (서브레지던트 전용)

국가

문구

Alpha3 국가명 (FRA 또는 USA 등)

끝

문구

Y - 엔딩 프록시 목록

예시

특정 유형(예: IPv4)의 프록시를 검색하려면:

https://proxy-seller.com/personal/api/v2/afoov21vcoodewq/proxy/download/ipv4?ext=txt&proto=https

답변

login:[email protected]:80;

login:[email protected]:81;

잘못된 프록시 유형 오류

{
    "status": "error",
    "data": null,
    "errors": [
        {
            "message": "Could not find description of list{type} in CrmUserApiProxy",
            "code": 22002,
            "customData": null
        }
    ]
}

수정

POSThttps://proxy-seller.com/personal/api/v2/{apiKey}/proxy/replace
IP 주소 대체
순서 슬롯을 잃지 않고 IP를 교체합니다. 월간 교체 할당량에 포함됩니다.

경로 매개변수

이름

가치

필수 사항

설명

승인

<Your_API_Key>

예

개인 API 키 (획득 방법)

요청 본문

이름

유형

설명

ids

숫자

단일 ID 또는 쉼표로 구분된 '[ ]' 안의 ID 배열

댓글

문구

요청에 포함할 수 있는 선택적 코멘트

유형

문구

대체 유형

예시

https://proxy-seller.com/personal/api/v2/afoov21vcoodewq/proxy/replace
{
    "ids": ["10"],
    "type": "CUSTOM",
    "comment": "Test replace IP"
}

답변

{
    "status": "success",
    "data": {
        "ok": {
            "ips": [
                "11.55.11.0"
            ],
            "msg": "Replacement request submitted"
        }
    },
    "errors": []
}
{
    "status": "error",
    "data": null,
    "errors": [
        {
            "code": 503,
            "message": "Error api key",
            "customData": null
        },
        {
            "code": 503,
            "message": "IP not allowed",
            "customData": null
        },
        {
            "code": 503,
            "message": "Request limit reached",
            "customData": null
        }
    ]
}
{
    "status": "error",
    "data": null,
    "errors": [
        {
            "code": 0,
            "message": "Set coorect type: NOT_WORK / INCORRECT_LOCATION / CANT_CHANGE_NETWORK / LOW_SPEED / CUSTOM",
            "customData": null
        }
    ]
}

대체 유형: NOT_WORK, INCORRECT_LOCATION, CANT_CHANGE_NETWORK, LOW_SPEED, CUSTOM

POST https://proxy-seller.com/personal/api/v2/{apiKey}/prolong/calc/{type}
IP 연장
선택한 IP에 대한 유효기간을 연장합니다. IP당 일 단위로 요금이 청구됩니다.

이 문서는 다양한 유형의 IP 주소에 대한 자동 갱신 설정을 하는 방법에 대한 자세한 안내를 제공합니다. 동일한 IP 주소를 유지하려면 반드시 정해진 기한 내에 갱신해야 합니다.

확장자 계산

이 엔드포인트를 통해 비용을 계산할 수 있습니다. 대량 구매 및 임대 기간에 따른 할인 혜택은 당사 서비스에서 제공하는 것과 유사합니다.

경로 매개변수

이름

가치

필수 사항

설명

승인

<Your_API_Key>

예

개인 API 키 (획득 방법)

유형

ipv4

ipv6

mobile

isp

mix

mix_isp

예

확장하려는 프록시 유형

요청 본문

이름

유형

설명

ids

숫자

단일 ID 또는 쉼표로 구분된 '[ ]' 안의 ID 배열 (획득 방법)

쿠폰

문구

추가하고자 하는 댓글

periodId

문구

/reference/list/{type} 요청에서 선택한 기간의 ID

예시 (예: ipv4)

https://proxy-seller.com/personal/api/v2/afoov21vcoodewq/prolong/calc/ipv4
{
    "ids": ["10"],
    "periodId": "1m",
    "coupon": "",
    "paymentId": "balance"
}

답변

{
    "status": "success",
    "data": {
        "warning": "",
        "balance": 498648.72,
        "total": 3.49,
        "quantity": 1,
        "currency": "USD",
        "discount": 3.00,
        "items": [
            {
                "id": "69fa4b7f256cae5b70a79478",
                "order_id": "69fa4b795a1f522c7a53d589",
                "order_number": "TEST_1778011001948-uc_e_UUf2Z3RtGH",
                "basket_id": "69fa4b7a5a1f522c7a53d58b",
                "ip": "11.55.11.0",
                "ip_only": "11.55.11.0",
                "protocol": "HTTP",
                "port_socks": 49453,
                "port_http": 49353,
                "login": "login ",
                "password": "password",
                "authIp": "",
                "rotation": null,
                "link_reboot": "#",
                "country": "Germany",
                "country_alpha3": "DEU",
                "status": "Active",
                "status_type": "ACTIVE",
                "can_prolong": true,
                "date_start": "05.05.2026",
                "date_end": "11.06.2026",
                "comment": "",
                "auto_renew": "N",
                "auto_renew_period": ""
            }
        ],
        "orders": 1
    },
    "errors": []
}
{
    "status": "error",
    "data": {
        "warning": "Insufficient funds. Total $3.49. Not enough $2.49",
        "balance": 1.00,
        "total": 3.49,
        "quantity": 1,
        "currency": "USD",
        "discount": 3.00,
        "items": [
            {
                "id": "69fa4b7f256cae5b70a79478",
                "order_id": "69fa4b795a1f522c7a53d589",
                "order_number": "TEST_1778011001948-uc_e_UUf2Z3RtGH",
                "basket_id": "69fa4b7a5a1f522c7a53d58b",
                "ip": "11.55.11.0",
                "ip_only": "11.55.11.0",
                "protocol": "HTTP",
                "port_socks": 49453,
                "port_http": 49353,
                "login": "login",
                "password": "password",
                "authIp": "",
                "rotation": null,
                "link_reboot": "#",
                "country": "Germany",
                "country_alpha3": "DEU",
                "status": "Active",
                "status_type": "ACTIVE",
                "can_prolong": true,
                "date_start": "05.05.2026",
                "date_end": "11.06.2026",
                "comment": "",
                "auto_renew": "N",
                "auto_renew_period": ""
            }
        ],
        "orders": 1
    },
    "errors": []
}
{
    "status": "error",
    "data": null,
    "errors": [
        {
            "code": 0,
            "message": "Set existed [periodId] from reference",
            "customData": null
        }
    ]
}
{
    "status": "error",
    "data": null,
    "errors": [
        {
            "code": 0,
            "message": "IP not found",
            "customData": null
        }
    ]
}

POSThttps://proxy-seller.com/personal/api/v2/{apiKey}/prolong/make/{type}
IP 연장
이 섹션에서는 갱신 주문을 생성하는 방법을 배우게 됩니다.

갱신 주문 생성

확장 주문 생성.

경로 매개변수

이름

가치

필수 사항

설명

승인

<Your_API_Key>

예

개인 API 키 (획득 방법)

유형

ipv4

ipv6

mobile

isp

mix

mix_isp

예

확장하려는 프록시 유형

요청 본문

이름

유형

설명

ids

숫자

단일 ID 또는 쉼표로 구분된 '[ ]' 안의 ID 배열 (획득 방법)

쿠폰

문구

프로모션 코드.

periodId

문구

/reference/list/{type} 요청에서 선택한 기간의 ID

paymentId

문구

결제 시스템의 ID "69e799e7497b2c153b33faca" - 밸런스, "69e799e8497b2c153b33faed" - 캐비닛에 추가한 카드

예시 (예: ipv4)

https://proxy-seller.com/personal/api/v2/afoov21vcoodewq/prolong/make/ipv4
{
    "ids": ["10"],
    "periodId": "1m",
    "coupon": "",
    "paymentId": "balance"
}

답변

{
    "status": "success",
    "data": {
        "orderId": "69fa4b795a1f522c7a53d589",
        "total": 3.49,
        "listBaseOrderNumbers": [
            "TEST_1778011001948-uc_e_UUf2Z3RtGH"
        ],
        "balance": 1.00
    },
    "errors": []
}
{
    "status": "error",
    "data": {
        "warning": "Insufficient funds. Total $3.49. Not enough $2.49",
        "balance": 1.00,
        "total": 3.49,
        "quantity": 1,
        "currency": "USD",
        "discount": 3.00,
        "items": [
            {
                "id": "69fa4b7f256cae5b70a79478",
                "order_id": "69fa4b795a1f522c7a53d589",
                "order_number": "TEST_1778011001948-uc_e_f7iNLfHqK8",
                "base_order_number": "TEST_1778011001948-uc_e_f7iNLfHqK8",
                "ip": "11.55.11.0",
                "port_http": null,
                "port_socks": null,
                "login": "x2alltop0qRU6",
                "password": "gwBwtL9LMM",
                "authIp": "",
                "country": "Germany",
                "date_start": "05.05.2026 19:56:42",
                "date_end": "10.08.2026 23:59:59",
                "comment": "",
                "status": "Active",
                "rotation": null,
                "link_reboot": "#",
                "can_prolong": true
            }
        ],
        "orders": 1
    },
    "errors": []
}
{
    "status": "error",
    "data": null,
    "errors": [
        {
            "code": 0,
            "message": "Set existed [periodId] from reference",
            "customData": null
        }
    ]
}
{
    "status": "error",
    "data": null,
    "errors": [
        {
            "code": 0,
            "message": "IP not found",
            "customData": null
        }
    ]
}
POSThttps://proxy-seller.com/personal/api/v2/{apiKey}/proxy/comment/set
댓글 달기
UI 또는 내보낸 파일에서 IP를 식별하는 데 도움이 되도록 자유 텍스트 메모(최대 256자)를 첨부하십시오.

경로 매개변수

이름

가치

필수 사항

설명

승인

<Your_API_Key>

예

개인 API 키 (획득 방법)

요청 본문

이름

유형

설명

ids

숫자

단일 ID 또는 쉼표로 구분된 '[ ]' 안의 ID 배열 (획득 방법)

댓글

문구

추가하고자 하는 댓글

예시

https://proxy-seller.com/personal/api/v2/afoov21vcoodewq/proxy/comment/set
{
    "ids": ["10"],
    "comment": "My server"
}

답변

{
    "status": "success",
    "data": {
        "updated": 1
    },
    "errors": []
}
{
    "status": "error",
    "data": null,
    "errors": [
        {
            "code": 0,
            "message": "IP not found",
            "customData": null
        }
    ]
}

모든 프록시 엔드포인트에 공통적으로 적용되는 사항

  1. 기본 URL

    https://proxy-seller.com/personal/api/v2/{YourApiKey}/

  2. 인증

    URL 경로에 포함된 API 키.

  3. 오류 모델

    비즈니스 오류는 HTTP 200을 반환하며 errors[] 채워짐.

IP 관리를 마친 후

Authorizationissue per-order credentialsOpenOrder actionsbuy more proxies when you need additional IPsOpenBalancecheck funds before bulk prolongationOpen

승인

Previous Page

활성 프록시 가져오기

Next Page

On this page

경로 매개변수
쿼리 매개변수
예시
답변
경로 매개변수:
선택적 매개변수
예시
답변
수정
경로 매개변수
요청 본문
예시
답변
확장자 계산
경로 매개변수
요청 본문
예시 (예: ipv4)
답변
갱신 주문 생성
경로 매개변수
요청 본문
예시 (예: ipv4)
답변
경로 매개변수
예시
답변
모든 프록시 엔드포인트에 공통적으로 적용되는 사항
1
기본 URL
2
인증
3
오류 모델
IP 관리를 마친 후