API développeur pour les plans IP
Une petite API REST avec des réponses JSON : consultez les plans, pays et prix exacts sans clé, et vérifiez le crédit et achetez des plans avec votre clé API. Chaque réponse a ok: true ou false.
- URL de base
- https://proxyworld.cc/api/v1
- Authentification
- Authorization: Bearer pwk_...
- Format
- JSON over HTTPS
- Limite
- 300 requêtes par minute par clé
Points d'accès
| Méthode | Chemin | Clé | Fonction |
|---|---|---|---|
| GET | /plans | Non | Tous les plans avec prix unitaire par 30 jours, prix volume, quantité minimale et maximale et pays autorisés. |
| GET | /countries | Non | Les 24 pays avec ligne régionale, villes et disponibilité cloud. |
| GET | /price?plan=rotate-max&quantity=2&days=90 | Non | Total exact pour un plan, une quantité et une période (30, 90, 180 ou 360 jours). |
| GET | /balance | Oui | Crédit sur le compte en dollars américains. |
| POST | /orders | Oui | Achetez un plan à partir du crédit. Corps : plan, quantité, jours, pays (pour les plans qui en nécessitent un). |
| GET | /orders | Oui | Vos 100 dernières commandes avec statut et détails d'accès. |
| GET | /orders/{id} | Oui | Une commande par son code (PO-...). |
Exemples
cURL
curl -s https://proxyworld.cc/api/v1/price?plan=static-ip\&quantity=10\&days=30
curl -s -X POST https://proxyworld.cc/api/v1/orders \
-H "Authorization: Bearer pwk_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"plan":"static-ip","quantity":10,"days":30,"country":"DE"}'Python
import requests
KEY = "pwk_YOUR_KEY"
r = requests.post("https://proxyworld.cc/api/v1/orders",
headers={"Authorization": f"Bearer {KEY}"},
json={"plan": "rotate-max", "quantity": 2, "days": 90})
print(r.status_code, r.json())Node.js
const r = await fetch("https://proxyworld.cc/api/v1/orders", {
method: "POST",
headers: { Authorization: "Bearer pwk_YOUR_KEY", "Content-Type": "application/json" },
body: JSON.stringify({ plan: "cloud-pc-b", quantity: 2, days: 30, country: "NL" }),
});
console.log(r.status, await r.json());Réponse à POST /orders
{
"ok": true,
"order": {
"id": "PO-7KQ2M9XHTA",
"product": "static",
"plan": "static-ip",
"quantity": 10,
"days": 30,
"country": "DE",
"price": "40.20",
"status": "processing",
"status_text": "Setting up",
"created_at": "2026-11-05T09:00:00.000Z",
"active_at": null,
"ends_at": null,
"access": null
}
}Une nouvelle commande commence par être en traitement et devient active lorsque le service est prêt ; l'accès contient alors le code de connexion (plans app), la liste des proxies et l'utilisateur (plans proxy) ou les adresses Remote Desktop (PCs cloud). Interrogez GET /orders/{id} toutes les quelques secondes jusqu'à ce qu'elle change.
Erreurs
| HTTP | erreur | Signification |
|---|---|---|
| 400 | bad_plan, bad_qty, bad_days, bad_country | La demande est vérifiée avant tout débit. |
| 401 | unauthorized | Envoyez l'en-tête Authorization: Bearer pwk_... |
| 402 | funds | Le crédit est inférieur au prix ; la réponse inclut need, le montant manquant. Rien n'est débité. |
| 429 | rate_limited | Plus de 300 requêtes en une minute sur une clé. |
| 503 | network | Le service n'a pas pu être configuré pour le moment ; rien n'est débité. Réessayez plus tard. |
Créez ou remplacez votre clé dans la console sous API. La clé est affichée une seule fois et stockée uniquement sous forme de hachage ; la remplacer arrête immédiatement l'ancienne clé.