Proxy-seller

プロキシと注文

Updated:

権限:account:read,account:write,課金:執筆

このグループでは

ツール

機能の説明

list_proxies

🟢read

ある種類のアクティブなプロキシ:IP、HTTP/SOCKSポート、認証情報、国、有効期限、自動更新状態、およびコメント。

export_proxies

🟢read

プロキシを、1行に1つのプロキシという形式で、すぐに使えるリストとしてエクスポートしてください。

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

1つ以上のプロキシに同じコメントを設定してください。

list_proxies

🟢read-only ・ account:read

ある種類のアクティブなプロキシ:IP、HTTP/SOCKSポート、認証情報、国、有効期限、自動更新状態、およびコメント。password 明示的に要求しない限り、マスクされた状態で返されます。プロキシではstatus: "Ended" はまもなく終了、期限切れではありません —date_end が実際の有効期限です。

パラメータ

種類

説明

type 必須

プロキシの種類

製品タイプ。mix はIPv4 MIXパッケージのみであり、mix_isp ISP MIX パッケージ — 2つの別々のリストがあるため、「私のすべての MIX プロキシ」とは、その両方を指します。subresident ここでは提供されていません:代わりにlist_resident_subuser_lists

orderId

文字列 | 整数

注文は1件のみ

country

string

Alpha-3コード、例:USA

latest

boolean

最も最近発行されたプロキシのみ

ends

boolean

まもなく期限切れとなるプロキシのみ

page,per_page

整数

戻るページ(デフォルト1) およびページサイズ(デフォルト50)

reveal

boolean

戻るpassword 「in clear」の代わりに••••。アシスタントはまずあなたに確認します — 参照プロキシのパスワードとAIプロバイダー

返却内容: {items: [...]} — プロキシごとに1つのオブジェクトを指定し、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。検索結果はページ分けされており(デフォルトで1ページあたり50件)、以下の情報を含みます。page,per_page,total,total_pages、さらに_note ページがさらに存在する場合は。例えばresident ここでいう「アイテム」とは、IPアドレスではなく、居住地リストのことです。例えば、mix /mix_isp 1つのパッケージが複数の国で発行される場合:order_number およびbase_order_number 国ごとの接尾辞を付ける(NS_…-dX_GBR,NS_…-dX_DEU) 一方でorder_id は共有されています — グループ分けはorder_id; a_note 結果にはそのように記載されています。password は"••••" ただし、reveal: true. ⚠️機密情報 — 結果には、アシスタントがあなたに繰り返す警告が含まれます。

export_proxies

🟢read-only ・ account:read

プロキシを、1行に1つのプロキシという形式で、すぐに使えるリストとしてエクスポートします。デフォルトではマスクされています: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

ポートタイプは1種類のみ(住宅用を除く)

protocol

http |socks5

居住用のみ(resident,subresident):各行の構成。txt 1行が次のようになりますsocks5://login:password@host:port;csv 列を維持します。テンプレートは値を%protocol% (テンプレートには以下を含めることはできません/、したがって、txt forscheme:// 行)。これがないと、行に体系性が失われます。以下とは異なります。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

Alpha-3コード(住宅用ではありません)

ends

boolean

まもなく期限切れとなるプロキシのみ(個人向けは対象外)

listId

文字列 | 整数

居住地リストID (resident およびsubresident); すべてのリストのエクスポートを省略

package_key

string

サブパッケージキー、以下を含む:type: "subresident"

maxLine

整数

最大行数、住宅地限定

reveal

boolean

接続可能に戻すlogin:password@host:port 行の代わりにip:port。アシスタントはまずあなたに確認します — 参照プロキシのパスワードとAIプロバイダー

返却内容: 住宅用protocol 以下の行にその構成が示されています:socks5://host:port デフォルトでは、socks5://login:password@host:port withreveal: 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

新しいプロキシ注文を発行します。残高から引き落とされます。2回呼び出すと、2件の注文が作成されます。

パラメータ

種類

説明

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

新しいプロキシ用のログインIDとパスワードを生成する

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

文字列 | 整数

1件のご注文(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

整数

ページ分割は、デフォルトで1ページあたり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 はprovisioned,partial,started (MIX:ログイン情報は存在するが、IPアドレスはまだ記載されていない) またはpending.proxies[] は、発行されたレコードであり、password masked — 使用するlist_proxies /export_proxies withreveal: true 認証情報について。

calc_prolong_cost

🟢read-only ・ account:read

特定のプロキシの更新価格(更新を行わない場合)。パラメータは以下と同じです。make_prolong.

返却内容: items は、更新対象となるプロキシです、password masked.

make_prolong

💳spends money ・ billing:write

プロキシを次の期間分更新します。選択した支払い先に請求されます。2回呼び出すと、2回分請求されます。

パラメータ

種類

説明

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: theorder_id 値はlist_proxies。これらの商品は注文単位で販売・更新されます。つまり、注文に含まれるすべての有効なプロキシが更新され、課金されます。

coupon

string

プロモーションコード

どのセレクタが適用されるかは、type:ipv4,isp およびmobile takeids またはips;ipv6,mix およびmix_isp takeorderIds. 注文全体を対象とするタイプの場合でも、ids またはips — アシスタントのツールがそれらを適切な順序に整理しますが — API自体はorderIds そこ。

よくある誤り: 更新手続き中の注文に対する2回目の更新依頼は、支払い前に拒否されます(コード57、「すでに処理中」)。この場合、請求は発生しません。しばらく待ってから確認してください。list_proxies やみくもに再試行するのではなく。「Prolongは適用されず、支払額は残高に戻されました」とは、更新が取り消され、その金額が残高に戻ったことを意味します。

replace_proxy

🟡changes account state ・ account:write

機能していないプロキシの交換を依頼してください。各プロキシは1日1回交換可能です。

パラメータ

種類

説明

ids 必須

(文字列 | 整数)[]

プロキシID

reason 必須

NOT_WORK |INCORRECT_LOCATION |CANT_CHANGE_NETWORK |LOW_SPEED |CUSTOM

理由

comment

string

以下の場合に必要reason はCUSTOM

set_proxy_comment

🟡changes account state ・ account:write

1つ以上のプロキシに同じコメントを設定します。以前のコメントを上書きします。空の文字列を指定すると、コメントがクリアされます。

パラメータ

種類

説明

ids 必須

(文字列 | 整数)[]

プロキシID

comment 必須

string

コメントテキスト

今後の手順

On this page