API 概要

RaxyProxy REST API の認証、リクエスト形式、レスポンスエンベロープと全エンドポイントマップ。

ベース URL

https://raxyproxy.com/api/v1

すべてのエンドポイントは /api/v1. HTTPS is required.

認証

すべてのリクエストには Authorization ヘッダーに Bearer トークン形式で API キーを含めます。キーは API Keys page.

Authorization: Bearer raxy_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

example.sh

curl https://raxyproxy.com/api/v1/account \
     -H "Authorization: Bearer raxy_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

キーは秘密に

API キーはアカウントへの完全アクセスを付与します — リポジトリにコミットしないでください。環境変数またはシークレットマネージャーを使用してください。

エンドポイント

v1 のすべての公開エンドポイント。各行は詳細ページへのリンク。

メソッド	パス	目的
GET	`/account`	Profile, balance, 30d traffic, API key info
GET	`/packages`	List active and suspended packages
GET	`/packages/{id}`	Detailed package (includes proxy password)
GET	`/packages/{id}/proxies`	Generate ready-to-use proxy strings
GET	`/packages/{id}/stats`	Time-series usage (minute / hour / day)
GET	`/packages/{id}/stats/hosts`	Top destinations by traffic
GET	`/packages/{id}/stats/errors`	Recent error events per host / code
POST	`/packages/{id}/rotate-password`	Generate a new proxy password
PATCH	`/packages/{id}/threads`	Update max concurrent connections
PATCH	`/packages/{id}/protocols`	Enable/disable HTTP & SOCKS5
GET	`/packages/{id}/allowed-ips`	List whitelisted client IPs
POST	`/packages/{id}/allowed-ips`	Add an IP to the whitelist
DELETE	`/packages/{id}/allowed-ips/{ip}`	Remove an IP from the whitelist
GET	`/packages/{id}/blocked-hosts`	List domains the package may not reach
PUT	`/packages/{id}/blocked-hosts`	Replace the blocked-hosts list
GET	`/packages/{id}/default-geo`	Default geo applied without per-request params
PUT	`/packages/{id}/default-geo`	Update default geo (countries/states/cities/ASNs…)
POST	`/packages/{id}/top-up`	Add GB to the package using wallet balance
GET	`/packages/{id}/top-ups`	History of top-ups for this package
GET	`/locations/countries`	Available countries for a pool type
GET	`/locations/states`	States within selected countries
GET	`/locations/cities`	Cities within selected countries/states
GET	`/locations/zipcodes`	ZIP codes within selected countries/states
GET	`/locations/asns`	ASNs within selected countries/states/cities

レスポンスエンベロープ

すべての成功レスポンスは標準エンベロープでラップされます:

response.json

{
  "data": { ... },
  "meta": {
    "version": "v1"
  }
}

data field contains the actual payload (object or array depending on the endpoint). Paginated endpoints include additional keys inside meta.

エラー

エラー時、HTTP ステータスコードは問題のカテゴリを示します。ボディには機械可読コードと人間可読メッセージを含む error key with a machine-readable code and a human-readable message.

ステータス	コード	意味
`400`	`invalid_request`	不正なリクエスト — 無効なパラメータ
`401`	`unauthorized`	API キーが欠落または無効
`402`	`payment_required`	残高不足 — ウォレットをチャージしてください
`403`	`forbidden` / `insufficient_scope`	禁止 — キーに scope がない
`404`	`not_found`	リソースが見つかりません
`409`	`conflict`	競合 — 状態が操作を妨げる（例: IP がすでに whitelist 済み）
`422`	`validation_failed`	バリデーション失敗 — errors オブジェクトを確認
`429`	`rate_limited`	レート制限超過 — Retry-After ヘッダーを参照
`500`	`http_error`	内部サーバーエラー
`502`	`provider_error`	アップストリームプロバイダーエラー — 一時的、後で再試行

error.validation.json

{
  "error": {
    "code":    "validation_failed",
    "message": "Validation failed",
    "errors":  { "threads": ["The threads field must be between 1 and 2000."] }
  },
  "meta": { "version": "v1" }
}

レート制限

API キーごとの制限、エンドポイント種類別。到達時は 429 + Retry-After。

グループ	制限	エンドポイント
`api`	120 / min	/account, /packages, /packages/{id}
`stats-api`	60 / min	/stats, /stats/hosts, /stats/errors, /top-ups
`proxies-api`	30 / min	/proxies
`settings-api`	30 / min	all package mutations (rotate-password, allowed-ips, …)
`locations-api`	60 / min	/locations/*
`topup-api`	10 / min	/packages/{id}/top-up

HTTP/1.1 429 Too Many Requests
Retry-After: 12
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 0

OpenAPI / AI 仕様

ツール、SDK、AI アシスタント用の機械可読仕様:

フォーマット	URL	ユースケース
OpenAPI 3.0 JSON	`/openapi.json`	Swagger UI、Postman、SDK ジェネレーター
Plain text (LLM)	`/llms-api.txt`	ChatGPT、Claude、Cursor コンテキスト

← 前へ

Scrapy

アカウント