Reseller API v1
Base URL: https://jryhost.com/api/v1
Authentication
Create a token in your reseller area (API page). Send it on every request:
Authorization: Bearer hp_xxxxxxxx...
Accept: application/jsonTokens are shown once. Revoke a token any time. Only active reseller accounts can use the API.
Limits and errors
60 requests per minute per token (429 when exceeded, see the Retry-After header). Errors are always JSON:
{ "error": { "status": 422, "message": "Not enough wallet balance.", "fields": { "email": ["..."] } } }Status codes: 200 / 201 OK, 401 bad token, 403 not allowed, 404 not found, 422 invalid or refused, 429 slow down, 502 registrar problem.
Orders are paid at once from your wallet at wholesale price. If the balance is too low the order is refused (422).
Endpoints
| Method and path | What it does |
|---|---|
GET /me | Your name, wallet balance and currency, test-mode flags. |
GET /products | Products you can buy with your wholesale price (in your wallet currency). |
GET /wallet | Balance and the last 50 transactions. Top up in the web area. |
GET /clients, GET /clients/{id} | Your clients. |
POST /clients | Create a client: name, email, optional company, country, phone. |
POST /orders | Buy a product. Fields: product (slug), quantity, client_id (optional), domain (hosting, domains and SSL), cycle (monthly, quarterly, semiannual, yearly, see GET /products > cycles), options (object {"option_id": quantity}, see GET /products > options), note (customer request, e.g. another server location), epp (transfers), years, country and number (phone numbers), reference (your own text). |
GET /orders, GET /orders/{number} | Your orders. |
GET /services, GET /services/{id} | Services bought through you, with IP, username and password when ready. |
POST /services/{id}/suspend, /unsuspend | Suspend or unsuspend a hosting or server service. |
GET /domains/check?domain=example.com | Is the domain available? |
GET /numbers/search?country=GB&limit=5 | Find virtual numbers (country is a 2-letter code). |
Example
curl -X POST https://jryhost.com/api/v1/orders \
-H "Authorization: Bearer hp_xxxxxxxx" \
-H "Accept: application/json" \
-d product=linux-vps -d client_id=12 -d reference=my-order-77{ "data": { "number": "O261102AB12C", "status": "paid", "total": 7.2, "currency": "USD",
"items": [ { "name": "Linux VPS", "qty": 1, "status": "active", "service_id": 31 } ] } }Service status can be pending, active, suspended, failed or terminated. A failed service is retried by our staff.