プロキシと注文
Updated:
権限:account:read,account:write,課金:執筆
このグループでは
ツール | 機能の説明 | |
|---|---|---|
🟢 | ある種類のアクティブなプロキシ:IP、HTTP/SOCKSポート、認証情報、国、有効期限、自動更新状態、およびコメント。 | |
🟢 | プロキシを、1行に1つのプロキシという形式で、すぐに使えるリストとしてエクスポートしてください。 | |
🟢 | 製品タイプごとの利用可能な国、レンタル期間、およびプラン。 | |
🟢 | 新規注文の価格および割引(注文は行わない場合)。 | |
💳 | 新しいプロキシ注文を行ってください。 | |
🟢 | ご依頼内容(新しいものから順に)および、当該アカウントにすでに登録されている利用対象。 | |
🟢 | 発注済みの注文に対するプロキシが発行されたかどうかを確認します。 | |
🟢 | 特定のプロキシの更新価格(更新を行わない場合)。 | |
💳 | プロキシの有効期間をさらに延長してください。 | |
🟡 | 機能していないプロキシの交換を依頼してください。 | |
🟡 | 1つ以上のプロキシに同じコメントを設定してください。 |
list_proxies
🟢read-only ・ account:read
ある種類のアクティブなプロキシ:IP、HTTP/SOCKSポート、認証情報、国、有効期限、自動更新状態、およびコメント。password 明示的に要求しない限り、マスクされた状態で返されます。プロキシではstatus: "Ended" はまもなく終了、期限切れではありません —date_end が実際の有効期限です。
パラメータ | 種類 | 説明 |
|---|---|---|
| プロキシの種類 | 製品タイプ。 |
| 文字列 | 整数 | 注文は1件のみ |
| string | Alpha-3コード、例: |
| boolean | 最も最近発行されたプロキシのみ |
| boolean | まもなく期限切れとなるプロキシのみ |
| 整数 | 戻るページ(デフォルト |
| boolean | 戻る |
返却内容: {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.
パラメータ | 種類 | 説明 |
|---|---|---|
| プロキシの種類(以下を含む) | 製品タイプ |
| string |
|
|
| ポートタイプは1種類のみ(住宅用を除く) |
|
| 居住用のみ( |
|
| 居住地域限定:各行のゲートウェイ — ヨーロッパ(デフォルト)、米国、またはアジア。エントリポイントのみを記載してください。エグジットIPの場所はリスト設定から取得されます。 |
| string | Alpha-3コード(住宅用ではありません) |
| boolean | まもなく期限切れとなるプロキシのみ(個人向けは対象外) |
| 文字列 | 整数 | 居住地リストID ( |
| string | サブパッケージキー、以下を含む: |
| 整数 | 最大行数、住宅地限定 |
| boolean | 接続可能に戻す |
返却内容: 住宅用protocol 以下の行にその構成が示されています:socks5://host:port デフォルトでは、socks5://login:password@host:port withreveal: 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
新しいプロキシ注文を発行します。残高から引き落とされます。2回呼び出すと、2件の注文が作成されます。
パラメータ | 種類 | 説明 |
|---|---|---|
| プロキシの種類 | 製品タイプ(以下を使用)make_resident_order (一般ユーザー向け) |
| string | 出典:get_reference、例: |
| string | 出典:get_reference、例: |
| 整数 | プロキシの数( |
| string |
|
| string | プロキシの用途について、サイトやサービスの略称(Google、Instagram)として記載してください。必須項目: |
| string | プロモーションコード |
| boolean | 新しいプロキシ用のログインIDとパスワードを生成する |
|
| プロトコルの上書き |
|
| モバイル版のみ、必須 |
| 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、および注文履歴については。
パラメータ | 種類 | 説明 |
|---|---|---|
| 文字列 | 整数 | 1件のご注文( |
| string | 作成日範囲、 |
|
| マシンのステータスフィルター |
| boolean |
|
| boolean |
|
| 整数 | ページ分割は、デフォルトで1ページあたり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 は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回分請求されます。
パラメータ | 種類 | 説明 |
|---|---|---|
|
| 製品タイプ。住宅用パッケージは期間ごとに更新されるものではありません — トラフィックを購入するにはmake_resident_order |
| string | |
| string |
|
| string[] |
|
| (文字列 | 整数)[] |
|
| (文字列 | 整数)[] |
|
| 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回交換可能です。
パラメータ | 種類 | 説明 |
|---|---|---|
| (文字列 | 整数)[] | プロキシID |
|
| 理由 |
| string | 以下の場合に必要 |
set_proxy_comment
🟡changes account state ・ account:write
1つ以上のプロキシに同じコメントを設定します。以前のコメントを上書きします。空の文字列を指定すると、コメントがクリアされます。
パラメータ | 種類 | 説明 |
|---|---|---|
| (文字列 | 整数)[] | プロキシID |
| string | コメントテキスト |