REST APIv1

Партнёрский API

API для интеграции мобильных прокси: заказ и продление портов, управление доступами и расчёты.

BASE URL

Значения в примерах условные. Актуальные цены, ID и данные подключения возвращаются в ответах API.

Начало работы

Авторизация

API доступен после активации партнёрского аккаунта. Создание и отзыв токена доступны только в кабинете GIGABIT. Новый токен заменяет предыдущий и отображается один раз.

Токен передаётся в заголовке HTTP-запроса Authorization по схеме Bearer.

HTTP

Authorization: Bearer gbp_PARTNER_TOKEN

Управление токеном в кабинете ↗

Формат запросов и ответов

Тело запроса передаётся в формате JSON. Примеры запросов и ответов находятся у каждого метода.

Параметр	Формат и значение
Тело запроса	JSON-объект и Content-Type: application/json. Если параметров нет, тело можно не передавать.
HTTP 202	Операция принята. Сервер возвращает id и status_url для проверки статуса.
GET /operations/{id}	queued: в очереди; processing: выполняется; ready: завершена; failed: ошибка. Результат находится в result, причина ошибки в error.
Даты	ISO 8601 с часовым поясом, например 2026-12-09T22:59:59+00:00.
Суммы	Поля _cents: целые евроценты. 4500 = 45,00 EUR.
Лимиты	Тело до 16 KiB; 600 запросов в час на аккаунт. При HTTP 429 задержка указана в Retry-After.

Успешный ответ

200 · JSON

{
  "success": true,
  "data": {
    "currency": "EUR",
    "balance_cents": 10000
  }
}

Ответ с ошибкой

401 · JSON

{
  "success": false,
  "error": "unauthenticated"
}

Баланс и оплата

Заказ и продление через API рассчитаны на один порт на 30 дней. Стоимость с индивидуальной скидкой списывается с нетто-баланса. Доступная сумма с учётом кредитного лимита и резервов указана в available_cents.

VAT определяется по реквизитам профиля и добавляется при пополнении через Stripe. При покупке портов VAT повторно не начисляется.

Ошибки

HTTP	error	Описание
400	`invalid_rotation_token_request`	Сброс токена не принимает дополнительных параметров.
400	`invalid_json`	Некорректный JSON в теле запроса.
400	`invalid_payment_request`	Неподдерживаемые или некорректные параметры запроса.
400	`invalid_payment_orders`	Некорректный номер или ID порта.
400	`invalid_partner_amount`	Сумма не соответствует ограничениям.
400	`invalid_pagination`	Некорректные параметры пагинации.
400	`invalid_partner_prefix`	Префикс логинов не соответствует ограничениям.
400	`invalid_rotation_interval`	Некорректные поля rotation или rotation_seconds.
401	`unauthenticated`	Токен отсутствует, недействителен или отозван.
403	`partner_required`	Требуется активный партнёрский аккаунт.
403	`payment_method_unavailable`	Способ оплаты недоступен для аккаунта.
403	`origin_not_allowed`	Источник запроса не разрешён.
404	`not_found`	Объект не найден или недоступен этому аккаунту.
409	`insufficient_partner_balance`	Недостаточно средств с учётом кредитного лимита и резервов.
409	`insufficient_withdrawable_balance`	Недостаточно средств, доступных для возврата.
409	`inventory_changed`	Наличие портов изменилось с момента просмотра каталога.
409	`partner_prefix_taken`	Префикс уже занят.
409	`record_changed_or_in_use`	Запись изменена или используется другой операцией.
409	`payment_busy`	Связанная операция ещё выполняется.
409	`rotation_busy`	Смена IP ещё выполняется.
409	`billing_required`	В профиле не заполнены платёжные реквизиты.
409	`rotation_interval_too_short`	Интервал меньше 20 секунд или ограничения сервера порта.
403 / 409	`order_expired`	Аренда неактивна. Смена доступов и IP доступна после продления.
429	`too_many_requests`	Лимит запросов исчерпан. Задержка указана в Retry-After.
502	`proxy_server_unavailable`	Сервер прокси временно недоступен.
502	`rotation_sync_pending`	Применение настройки смены IP ещё не подтверждено.
503	`database_unavailable`	Хранилище данных временно недоступно.
503	`stripe_unavailable`	Платёжный сервис временно недоступен.

Операции

Статус операции

GET

Возвращает состояние и результат операции аккаунта. Быстрая проверка, без повторного выполнения.

Параметры

Поле	Тип	Описание
`id`В пути · Обязательно	`string`	ID операции из ответа HTTP 202.

Вариант примера

Пример запроса

cURL

curl --request GET \
  --url 'https://api.gigabit.ltd/api/partner/v1/operations/op_0123456789abcdef0123456789abcdef' \
  --header "Authorization: Bearer $GIGABIT_API_TOKEN"

JavaScript · Node.js

const response = await fetch(
  "https://api.gigabit.ltd/api/partner/v1/operations/op_0123456789abcdef0123456789abcdef",
  {
    method: "GET",
    headers: {
      Authorization: `Bearer ${process.env.GIGABIT_API_TOKEN}`
    }
  }
);
const result = await response.json();
if (!response.ok) throw new Error(result.error);
console.log(result);

Python · requests

# python -m pip install requests
import os
import requests

response = requests.get(
    "https://api.gigabit.ltd/api/partner/v1/operations/op_0123456789abcdef0123456789abcdef",
    headers={"Authorization": f"Bearer {os.environ['GIGABIT_API_TOKEN']}"},
    timeout=30,
)
result = response.json()
if not response.ok:
    raise RuntimeError(result.get("error", f"HTTP {response.status_code}"))
print(result)

Пример ответа

200 · application/json

{
  "success": true,
  "data": {
    "id": "op_0123456789abcdef0123456789abcdef",
    "state": "queued",
    "error": null,
    "result": null,
    "created_at": "2026-11-10T12:00:00+00:00",
    "status_url": "/api/partner/v1/operations/op_0123456789abcdef0123456789abcdef"
  }
}

Пример запроса

cURL

curl --request GET \
  --url 'https://api.gigabit.ltd/api/partner/v1/operations/op_0123456789abcdef0123456789abcdef' \
  --header "Authorization: Bearer $GIGABIT_API_TOKEN"

JavaScript · Node.js

const response = await fetch(
  "https://api.gigabit.ltd/api/partner/v1/operations/op_0123456789abcdef0123456789abcdef",
  {
    method: "GET",
    headers: {
      Authorization: `Bearer ${process.env.GIGABIT_API_TOKEN}`
    }
  }
);
const result = await response.json();
if (!response.ok) throw new Error(result.error);
console.log(result);

Python · requests

# python -m pip install requests
import os
import requests

response = requests.get(
    "https://api.gigabit.ltd/api/partner/v1/operations/op_0123456789abcdef0123456789abcdef",
    headers={"Authorization": f"Bearer {os.environ['GIGABIT_API_TOKEN']}"},
    timeout=30,
)
result = response.json()
if not response.ok:
    raise RuntimeError(result.get("error", f"HTTP {response.status_code}"))
print(result)

Пример ответа

200 · application/json

{
  "success": true,
  "data": {
    "id": "op_0123456789abcdef0123456789abcdef",
    "state": "ready",
    "error": null,
    "result": {
      "id": "partner_0123456789abcdef0123456789abcdef",
      "state": "ready",
      "error": null,
      "order_ids": [
        "a1b2c3d4e5f60123456789abcdef0123"
      ],
      "amount_cents": 4050,
      "currency": "EUR",
      "price": {
        "currency": "EUR",
        "base_net_cents": 4500,
        "net_cents": 4050,
        "vat_cents": 0,
        "total_cents": 4050,
        "tax_at_topup": true,
        "discount_percent": 10,
        "months": 1,
        "days": 30,
        "pricing_version": 1,
        "tax": {
          "mode": "vat",
          "rate_percent": 23,
          "vat_code": "23",
          "reverse_charge": false
        }
      }
    },
    "created_at": "2026-11-10T12:00:00+00:00",
    "status_url": "/api/partner/v1/operations/op_0123456789abcdef0123456789abcdef"
  }
}

Пример запроса

cURL

curl --request GET \
  --url 'https://api.gigabit.ltd/api/partner/v1/operations/op_0123456789abcdef0123456789abcdef' \
  --header "Authorization: Bearer $GIGABIT_API_TOKEN"

JavaScript · Node.js

const response = await fetch(
  "https://api.gigabit.ltd/api/partner/v1/operations/op_0123456789abcdef0123456789abcdef",
  {
    method: "GET",
    headers: {
      Authorization: `Bearer ${process.env.GIGABIT_API_TOKEN}`
    }
  }
);
const result = await response.json();
if (!response.ok) throw new Error(result.error);
console.log(result);

Python · requests

# python -m pip install requests
import os
import requests

response = requests.get(
    "https://api.gigabit.ltd/api/partner/v1/operations/op_0123456789abcdef0123456789abcdef",
    headers={"Authorization": f"Bearer {os.environ['GIGABIT_API_TOKEN']}"},
    timeout=30,
)
result = response.json()
if not response.ok:
    raise RuntimeError(result.get("error", f"HTTP {response.status_code}"))
print(result)

Пример ответа

200 · application/json

{
  "success": true,
  "data": {
    "id": "op_0123456789abcdef0123456789abcdef",
    "state": "failed",
    "error": "insufficient_partner_balance",
    "result": null,
    "created_at": "2026-11-10T12:00:00+00:00",
    "status_url": "/api/partner/v1/operations/op_0123456789abcdef0123456789abcdef"
  }
}

Поля ответов →

Баланс и расчёты

Баланс

GET

Текущий баланс, кредитный лимит, доступные средства, скидка и цены партнёра.

Тело не требуется.

Пример запроса

cURL

curl --request GET \
  --url 'https://api.gigabit.ltd/api/partner/v1/balance' \
  --header "Authorization: Bearer $GIGABIT_API_TOKEN"

JavaScript · Node.js

const response = await fetch(
  "https://api.gigabit.ltd/api/partner/v1/balance",
  {
    method: "GET",
    headers: {
      Authorization: `Bearer ${process.env.GIGABIT_API_TOKEN}`
    }
  }
);
const result = await response.json();
if (!response.ok) throw new Error(result.error);
console.log(result);

Python · requests

# python -m pip install requests
import os
import requests

response = requests.get(
    "https://api.gigabit.ltd/api/partner/v1/balance",
    headers={"Authorization": f"Bearer {os.environ['GIGABIT_API_TOKEN']}"},
    timeout=30,
)
result = response.json()
if not response.ok:
    raise RuntimeError(result.get("error", f"HTTP {response.status_code}"))
print(result)

Пример ответа

200 · application/json

{
  "success": true,
  "data": {
    "currency": "EUR",
    "balance_cents": 10000,
    "reserved_cents": 0,
    "credit_limit_cents": 10000,
    "debt_cents": 0,
    "available_cents": 20000,
    "withdrawable_cents": 10000,
    "discount_percent": 10,
    "prefix": "astra",
    "api_token_hint": "demo12",
    "monthly_net_cents": 4500,
    "payment_method": "card",
    "connection_domains": {
      "host": "",
      "api": ""
    },
    "paid_in_cents": 10000,
    "prices": [
      {
        "currency": "EUR",
        "base_net_cents": 4500,
        "net_cents": 4050,
        "vat_cents": 0,
        "total_cents": 4050,
        "tax_at_topup": true,
        "discount_percent": 10,
        "months": 1,
        "days": 30,
        "pricing_version": 1,
        "tax": {
          "mode": "vat",
          "rate_percent": 23,
          "vat_code": "23",
          "reverse_charge": false
        }
      }
    ],
    "topup_tax": {
      "mode": "vat",
      "rate_percent": 23,
      "vat_code": "23",
      "reverse_charge": false
    },
    "can_order_new_ports": true
  }
}

Поля ответов →

Пополнение баланса

POST

Создаёт ссылку на оплату через Stripe. amount_cents - сумма зачисления на баланс в евроцентах; total_cents - сумма оплаты с учётом применимого VAT.

Параметры

Поле	Тип	Описание
`amount_cents`Тело JSON · Обязательно	`integer`100-10000000	От 1 до 100 000 EUR, целые евроценты.

Пример запроса

cURL

curl --request POST \
  --url 'https://api.gigabit.ltd/api/partner/v1/topups' \
  --header "Authorization: Bearer $GIGABIT_API_TOKEN" \
  --header 'Content-Type: application/json' \
  --data '{
  "amount_cents": 10000
}'

JavaScript · Node.js

const response = await fetch(
  "https://api.gigabit.ltd/api/partner/v1/topups",
  {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.GIGABIT_API_TOKEN}`,
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "amount_cents": 10000
    })
  }
);
const result = await response.json();
if (!response.ok) throw new Error(result.error);
console.log(result);

Python · requests

# python -m pip install requests
import os
import requests

response = requests.post(
    "https://api.gigabit.ltd/api/partner/v1/topups",
    headers={"Authorization": f"Bearer {os.environ['GIGABIT_API_TOKEN']}"},
    json={'amount_cents': 10000},
    timeout=30,
)
result = response.json()
if not response.ok:
    raise RuntimeError(result.get("error", f"HTTP {response.status_code}"))
print(result)

Пример ответа

202 · application/json

{
  "success": true,
  "data": {
    "id": "op_0123456789abcdef0123456789abcdef",
    "state": "queued",
    "error": null,
    "result": null,
    "created_at": "2026-11-10T12:00:00+00:00",
    "status_url": "/api/partner/v1/operations/op_0123456789abcdef0123456789abcdef"
  }
}

Результат после выполнения

GET /operations/{id} · 200

{
  "success": true,
  "data": {
    "id": "op_0123456789abcdef0123456789abcdef",
    "state": "ready",
    "error": null,
    "result": {
      "id": "ptop_0123456789abcdef0123456789abcdef",
      "state": "pending",
      "url": "https://checkout.stripe.com/c/pay/EXAMPLE_SESSION",
      "amount_cents": 10000,
      "vat_cents": 2300,
      "total_cents": 12300,
      "currency": "EUR"
    },
    "created_at": "2026-11-10T12:00:00+00:00",
    "status_url": "/api/partner/v1/operations/op_0123456789abcdef0123456789abcdef"
  }
}

Поля ответов →

Статус пополнения

GET

Возвращает статус пополнения аккаунта. paid подтверждает зачисление средств. Возврат со страницы Stripe сам по себе не подтверждает оплату.

Состояния: creating, pending, paid, expired, failed.

Параметры

Поле	Тип	Описание
`id`В пути · Обязательно	`string`	ID пополнения из POST /topups.

Пример запроса

cURL

curl --request GET \
  --url 'https://api.gigabit.ltd/api/partner/v1/topups/ptop_0123456789abcdef0123456789abcdef' \
  --header "Authorization: Bearer $GIGABIT_API_TOKEN"

JavaScript · Node.js

const response = await fetch(
  "https://api.gigabit.ltd/api/partner/v1/topups/ptop_0123456789abcdef0123456789abcdef",
  {
    method: "GET",
    headers: {
      Authorization: `Bearer ${process.env.GIGABIT_API_TOKEN}`
    }
  }
);
const result = await response.json();
if (!response.ok) throw new Error(result.error);
console.log(result);

Python · requests

# python -m pip install requests
import os
import requests

response = requests.get(
    "https://api.gigabit.ltd/api/partner/v1/topups/ptop_0123456789abcdef0123456789abcdef",
    headers={"Authorization": f"Bearer {os.environ['GIGABIT_API_TOKEN']}"},
    timeout=30,
)
result = response.json()
if not response.ok:
    raise RuntimeError(result.get("error", f"HTTP {response.status_code}"))
print(result)

Пример ответа

200 · application/json

{
  "success": true,
  "data": {
    "id": "ptop_0123456789abcdef0123456789abcdef",
    "state": "pending",
    "url": "https://checkout.stripe.com/c/pay/EXAMPLE_SESSION",
    "amount_cents": 10000,
    "vat_cents": 2300,
    "total_cents": 12300,
    "currency": "EUR"
  }
}

Поля ответов →

История транзакций

GET

Операции от новых к старым, источники и комментарии, суммы и остаток после каждой операции. Технические резервы покупки скрыты по умолчанию.

Параметры

Поле	Тип	Описание
`offset`В строке запроса · Необязательно	`integer`0-∞	Число пропускаемых записей.
`limit`В строке запроса · Необязательно	`integer`1-100	Размер страницы: 1-100.
`include_reservations`В строке запроса · Необязательно	`string`1	1 - включить purchase_reserve и purchase_release.

Пример запроса

cURL

curl --request GET \
  --url 'https://api.gigabit.ltd/api/partner/v1/transactions?offset=0&limit=30' \
  --header "Authorization: Bearer $GIGABIT_API_TOKEN"

JavaScript · Node.js

const response = await fetch(
  "https://api.gigabit.ltd/api/partner/v1/transactions?offset=0&limit=30",
  {
    method: "GET",
    headers: {
      Authorization: `Bearer ${process.env.GIGABIT_API_TOKEN}`
    }
  }
);
const result = await response.json();
if (!response.ok) throw new Error(result.error);
console.log(result);

Python · requests

# python -m pip install requests
import os
import requests

response = requests.get(
    "https://api.gigabit.ltd/api/partner/v1/transactions?offset=0&limit=30",
    headers={"Authorization": f"Bearer {os.environ['GIGABIT_API_TOKEN']}"},
    timeout=30,
)
result = response.json()
if not response.ok:
    raise RuntimeError(result.get("error", f"HTTP {response.status_code}"))
print(result)

Пример ответа

200 · application/json

{
  "success": true,
  "data": {
    "items": [
      {
        "id": "ptop_0123456789abcdef0123456789abcdef:credit",
        "created_at": "2026-11-09T12:05:00+00:00",
        "currency": "EUR",
        "operation": "topup",
        "amount_cents": 10000,
        "reserved_delta_cents": 0,
        "source": "stripe",
        "comment": "",
        "reference": "ptop_0123456789abcdef0123456789abcdef",
        "balance_after_cents": 10000,
        "reserved_after_cents": 0,
        "sequence": 1
      }
    ],
    "total": 1,
    "offset": 0,
    "limit": 30
  }
}

Поля ответов →

Заявка на вывод средств

POST

Создаёт заявку и резервирует сумму до её рассмотрения. Доступная для вывода сумма указана в withdrawable_cents; кредитный лимит и невозвратные компенсации в неё не входят.

После обработки заявки result.state=requested означает ожидание решения. Операция остаётся processing до подтверждения выплаты или отклонения.

Параметры

Поле	Тип	Описание
`amount_cents`Тело JSON · Обязательно	`integer`100-100000000	Сумма EUR в центах, не выше доступной для вывода.
`comment`Тело JSON · Обязательно	`string`1-2000	Реквизиты или пояснение. Непустой текст после удаления пробелов по краям.

Пример запроса

cURL

curl --request POST \
  --url 'https://api.gigabit.ltd/api/partner/v1/withdrawals' \
  --header "Authorization: Bearer $GIGABIT_API_TOKEN" \
  --header 'Content-Type: application/json' \
  --data '{
  "amount_cents": 5000,
  "comment": "Please contact me to confirm payment details."
}'

JavaScript · Node.js

const response = await fetch(
  "https://api.gigabit.ltd/api/partner/v1/withdrawals",
  {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.GIGABIT_API_TOKEN}`,
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "amount_cents": 5000,
      "comment": "Please contact me to confirm payment details."
    })
  }
);
const result = await response.json();
if (!response.ok) throw new Error(result.error);
console.log(result);

Python · requests

# python -m pip install requests
import os
import requests

response = requests.post(
    "https://api.gigabit.ltd/api/partner/v1/withdrawals",
    headers={"Authorization": f"Bearer {os.environ['GIGABIT_API_TOKEN']}"},
    json={'amount_cents': 5000,
     'comment': 'Please contact me to confirm payment details.'},
    timeout=30,
)
result = response.json()
if not response.ok:
    raise RuntimeError(result.get("error", f"HTTP {response.status_code}"))
print(result)

Пример ответа

202 · application/json

{
  "success": true,
  "data": {
    "id": "op_0123456789abcdef0123456789abcdef",
    "state": "queued",
    "error": null,
    "result": null,
    "created_at": "2026-11-10T12:00:00+00:00",
    "status_url": "/api/partner/v1/operations/op_0123456789abcdef0123456789abcdef"
  }
}

Результат после выполнения

GET /operations/{id} · 200

{
  "success": true,
  "data": {
    "id": "op_0123456789abcdef0123456789abcdef",
    "state": "ready",
    "error": null,
    "result": {
      "id": "pout_0123456789abcdef0123456789abcdef",
      "state": "paid"
    },
    "created_at": "2026-11-10T12:00:00+00:00",
    "status_url": "/api/partner/v1/operations/op_0123456789abcdef0123456789abcdef"
  }
}

Поля ответов →

Каталог и заказы

Доступные порты

GET

Доступные номера портов, сгруппированные по оператору и локации.

Наличие проверяется при оформлении заказа. Просмотр каталога не резервирует порты.

Тело не требуется.

Пример запроса

cURL

curl --request GET \
  --url 'https://api.gigabit.ltd/api/partner/v1/catalog' \
  --header "Authorization: Bearer $GIGABIT_API_TOKEN"

JavaScript · Node.js

const response = await fetch(
  "https://api.gigabit.ltd/api/partner/v1/catalog",
  {
    method: "GET",
    headers: {
      Authorization: `Bearer ${process.env.GIGABIT_API_TOKEN}`
    }
  }
);
const result = await response.json();
if (!response.ok) throw new Error(result.error);
console.log(result);

Python · requests

# python -m pip install requests
import os
import requests

response = requests.get(
    "https://api.gigabit.ltd/api/partner/v1/catalog",
    headers={"Authorization": f"Bearer {os.environ['GIGABIT_API_TOKEN']}"},
    timeout=30,
)
result = response.json()
if not response.ok:
    raise RuntimeError(result.get("error", f"HTTP {response.status_code}"))
print(result)

Пример ответа

200 · application/json

{
  "success": true,
  "data": {
    "items": [
      {
        "operator": {
          "id": "operator-orange",
          "name": "Orange"
        },
        "location": {
          "id": "location-warsaw",
          "name": "Warsaw"
        },
        "ports": [
          {
            "id": "b1c2d3e4f5a60123456789abcdef0123",
            "number": 10001
          },
          {
            "id": "b2c3d4e5f6a70123456789abcdef0123",
            "number": 10002
          }
        ],
        "available": 2
      }
    ],
    "prices": [
      {
        "currency": "EUR",
        "base_net_cents": 4500,
        "net_cents": 4050,
        "vat_cents": 0,
        "total_cents": 4050,
        "tax_at_topup": true,
        "discount_percent": 10,
        "months": 1,
        "days": 30,
        "pricing_version": 1,
        "tax": {
          "mode": "vat",
          "rate_percent": 23,
          "vat_code": "23",
          "reverse_charge": false
        }
      }
    ]
  }
}

Поля ответов →

Заказ порта

POST

Заказ одного доступного порта на 30 дней по номеру или ID из каталога. Стоимость списывается с баланса.

Длительная операция возвращает HTTP 202 и созданный сервером id. Статус и результат доступны через GET /operations/{id}. Проверка статуса не создаёт новую операцию.

Параметры

Поле	Тип	Описание
`port_number`Тело JSON · Необязательно	`integer`1-65535	Номер порта из каталога. Передаётся одно из полей: port_number или port_id.
`port_id`Тело JSON · Необязательно	`string`1-120	ID порта из каталога, вместо port_number.

Вариант примера

Пример запроса

cURL

curl --request POST \
  --url 'https://api.gigabit.ltd/api/partner/v1/orders' \
  --header "Authorization: Bearer $GIGABIT_API_TOKEN" \
  --header 'Content-Type: application/json' \
  --data '{
  "port_number": 10001
}'

JavaScript · Node.js

const response = await fetch(
  "https://api.gigabit.ltd/api/partner/v1/orders",
  {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.GIGABIT_API_TOKEN}`,
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "port_number": 10001
    })
  }
);
const result = await response.json();
if (!response.ok) throw new Error(result.error);
console.log(result);

Python · requests

# python -m pip install requests
import os
import requests

response = requests.post(
    "https://api.gigabit.ltd/api/partner/v1/orders",
    headers={"Authorization": f"Bearer {os.environ['GIGABIT_API_TOKEN']}"},
    json={'port_number': 10001},
    timeout=30,
)
result = response.json()
if not response.ok:
    raise RuntimeError(result.get("error", f"HTTP {response.status_code}"))
print(result)

Пример ответа

202 · application/json

{
  "success": true,
  "data": {
    "id": "op_0123456789abcdef0123456789abcdef",
    "state": "queued",
    "error": null,
    "result": null,
    "created_at": "2026-11-10T12:00:00+00:00",
    "status_url": "/api/partner/v1/operations/op_0123456789abcdef0123456789abcdef"
  }
}

Результат после выполнения

GET /operations/{id} · 200

{
  "success": true,
  "data": {
    "id": "op_0123456789abcdef0123456789abcdef",
    "state": "ready",
    "error": null,
    "result": {
      "id": "partner_0123456789abcdef0123456789abcdef",
      "state": "ready",
      "error": null,
      "order_ids": [
        "a1b2c3d4e5f60123456789abcdef0123"
      ],
      "amount_cents": 4050,
      "currency": "EUR",
      "price": {
        "currency": "EUR",
        "base_net_cents": 4500,
        "net_cents": 4050,
        "vat_cents": 0,
        "total_cents": 4050,
        "tax_at_topup": true,
        "discount_percent": 10,
        "months": 1,
        "days": 30,
        "pricing_version": 1,
        "tax": {
          "mode": "vat",
          "rate_percent": 23,
          "vat_code": "23",
          "reverse_charge": false
        }
      }
    },
    "created_at": "2026-11-10T12:00:00+00:00",
    "status_url": "/api/partner/v1/operations/op_0123456789abcdef0123456789abcdef"
  }
}

Пример запроса

cURL

curl --request POST \
  --url 'https://api.gigabit.ltd/api/partner/v1/orders' \
  --header "Authorization: Bearer $GIGABIT_API_TOKEN" \
  --header 'Content-Type: application/json' \
  --data '{
  "port_id": "b1c2d3e4f5a60123456789abcdef0123"
}'

JavaScript · Node.js

const response = await fetch(
  "https://api.gigabit.ltd/api/partner/v1/orders",
  {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.GIGABIT_API_TOKEN}`,
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "port_id": "b1c2d3e4f5a60123456789abcdef0123"
    })
  }
);
const result = await response.json();
if (!response.ok) throw new Error(result.error);
console.log(result);

Python · requests

# python -m pip install requests
import os
import requests

response = requests.post(
    "https://api.gigabit.ltd/api/partner/v1/orders",
    headers={"Authorization": f"Bearer {os.environ['GIGABIT_API_TOKEN']}"},
    json={'port_id': 'b1c2d3e4f5a60123456789abcdef0123'},
    timeout=30,
)
result = response.json()
if not response.ok:
    raise RuntimeError(result.get("error", f"HTTP {response.status_code}"))
print(result)

Пример ответа

202 · application/json

{
  "success": true,
  "data": {
    "id": "op_0123456789abcdef0123456789abcdef",
    "state": "queued",
    "error": null,
    "result": null,
    "created_at": "2026-11-10T12:00:00+00:00",
    "status_url": "/api/partner/v1/operations/op_0123456789abcdef0123456789abcdef"
  }
}

Результат после выполнения

GET /operations/{id} · 200

{
  "success": true,
  "data": {
    "id": "op_0123456789abcdef0123456789abcdef",
    "state": "ready",
    "error": null,
    "result": {
      "id": "partner_0123456789abcdef0123456789abcdef",
      "state": "ready",
      "error": null,
      "order_ids": [
        "a1b2c3d4e5f60123456789abcdef0123"
      ],
      "amount_cents": 4050,
      "currency": "EUR",
      "price": {
        "currency": "EUR",
        "base_net_cents": 4500,
        "net_cents": 4050,
        "vat_cents": 0,
        "total_cents": 4050,
        "tax_at_topup": true,
        "discount_percent": 10,
        "months": 1,
        "days": 30,
        "pricing_version": 1,
        "tax": {
          "mode": "vat",
          "rate_percent": 23,
          "vat_code": "23",
          "reverse_charge": false
        }
      }
    },
    "created_at": "2026-11-10T12:00:00+00:00",
    "status_url": "/api/partner/v1/operations/op_0123456789abcdef0123456789abcdef"
  }
}

Поля ответов →

Список портов

GET

Текущие порты аккаунта: срок аренды, данные подключения, IP и таймер смены IP.

Для смены IP выполняется GET-запрос по полной ссылке rotation_url из данных порта. Заголовок Authorization не требуется. Ссылка уже содержит токен порта.

Тело не требуется.

Пример запроса

cURL

curl --request GET \
  --url 'https://api.gigabit.ltd/api/partner/v1/orders' \
  --header "Authorization: Bearer $GIGABIT_API_TOKEN"

JavaScript · Node.js

const response = await fetch(
  "https://api.gigabit.ltd/api/partner/v1/orders",
  {
    method: "GET",
    headers: {
      Authorization: `Bearer ${process.env.GIGABIT_API_TOKEN}`
    }
  }
);
const result = await response.json();
if (!response.ok) throw new Error(result.error);
console.log(result);

Python · requests

# python -m pip install requests
import os
import requests

response = requests.get(
    "https://api.gigabit.ltd/api/partner/v1/orders",
    headers={"Authorization": f"Bearer {os.environ['GIGABIT_API_TOKEN']}"},
    timeout=30,
)
result = response.json()
if not response.ok:
    raise RuntimeError(result.get("error", f"HTTP {response.status_code}"))
print(result)

Пример ответа

200 · application/json

{
  "success": true,
  "data": {
    "items": [
      {
        "id": "a1b2c3d4e5f60123456789abcdef0123",
        "port_id": "b1c2d3e4f5a60123456789abcdef0123",
        "number": 10001,
        "host": "l1.gigabit.ltd",
        "username": "astra_a1b2c3d4e5f",
        "proxy_password": "EXAMPLE_ONLY_22_CHARS_x",
        "status": "active",
        "expires": "2026-12-09T22:59:59+00:00",
        "operator": "Orange",
        "cityName": "Warsaw",
        "ip": "198.51.100.42",
        "rotation_url": "https://api.gigabit.ltd/change_ip?token=EXAMPLE_ROTATION_TOKEN_REPLACE_ME",
        "rotation": true,
        "rotation_seconds": 120,
        "connection_options": {
          "custom": {
            "host": "proxy.example.com",
            "rotation_url": "https://api.example.com/change_ip?token=EXAMPLE_ROTATION_TOKEN_REPLACE_ME"
          }
        }
      }
    ]
  }
}

Поля ответов →

Данные порта

GET

Данные заказа, принадлежащего аккаунту. Недоступный или несуществующий заказ возвращает 404.

Параметры

Поле	Тип	Описание
`id`В пути · Обязательно	`string`	ID заказа (id) или порта (port_id) из списка портов.

Пример запроса

cURL

curl --request GET \
  --url 'https://api.gigabit.ltd/api/partner/v1/orders/a1b2c3d4e5f60123456789abcdef0123' \
  --header "Authorization: Bearer $GIGABIT_API_TOKEN"

JavaScript · Node.js

const response = await fetch(
  "https://api.gigabit.ltd/api/partner/v1/orders/a1b2c3d4e5f60123456789abcdef0123",
  {
    method: "GET",
    headers: {
      Authorization: `Bearer ${process.env.GIGABIT_API_TOKEN}`
    }
  }
);
const result = await response.json();
if (!response.ok) throw new Error(result.error);
console.log(result);

Python · requests

# python -m pip install requests
import os
import requests

response = requests.get(
    "https://api.gigabit.ltd/api/partner/v1/orders/a1b2c3d4e5f60123456789abcdef0123",
    headers={"Authorization": f"Bearer {os.environ['GIGABIT_API_TOKEN']}"},
    timeout=30,
)
result = response.json()
if not response.ok:
    raise RuntimeError(result.get("error", f"HTTP {response.status_code}"))
print(result)

Пример ответа

200 · application/json

{
  "success": true,
  "data": {
    "id": "a1b2c3d4e5f60123456789abcdef0123",
    "port_id": "b1c2d3e4f5a60123456789abcdef0123",
    "number": 10001,
    "host": "l1.gigabit.ltd",
    "username": "astra_a1b2c3d4e5f",
    "proxy_password": "EXAMPLE_ONLY_22_CHARS_x",
    "status": "active",
    "expires": "2026-12-09T22:59:59+00:00",
    "operator": "Orange",
    "cityName": "Warsaw",
    "ip": "198.51.100.42",
    "rotation_url": "https://api.gigabit.ltd/change_ip?token=EXAMPLE_ROTATION_TOKEN_REPLACE_ME",
    "rotation": true,
    "rotation_seconds": 120,
    "connection_options": {
      "custom": {
        "host": "proxy.example.com",
        "rotation_url": "https://api.example.com/change_ip?token=EXAMPLE_ROTATION_TOKEN_REPLACE_ME"
      }
    }
  }
}

Поля ответов →

Продление порта

POST

Добавляет 30 дней к аренде одного порта с оплатой с баланса. В запросе нужен только номер порта или его ID в адресе.

Параметры

Поле	Тип	Описание
`id`В пути · Обязательно	`string`	Номер порта или ID порта. Также принимается id заказа из GET /orders.

Вариант примера

Пример запроса

cURL

curl --request POST \
  --url 'https://api.gigabit.ltd/api/partner/v1/orders/10001/renew' \
  --header "Authorization: Bearer $GIGABIT_API_TOKEN" \
  --header 'Content-Type: application/json' \
  --data '{}'

JavaScript · Node.js

const response = await fetch(
  "https://api.gigabit.ltd/api/partner/v1/orders/10001/renew",
  {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.GIGABIT_API_TOKEN}`,
      "Content-Type": "application/json"
    },
    body: JSON.stringify({})
  }
);
const result = await response.json();
if (!response.ok) throw new Error(result.error);
console.log(result);

Python · requests

# python -m pip install requests
import os
import requests

response = requests.post(
    "https://api.gigabit.ltd/api/partner/v1/orders/10001/renew",
    headers={"Authorization": f"Bearer {os.environ['GIGABIT_API_TOKEN']}"},
    json={},
    timeout=30,
)
result = response.json()
if not response.ok:
    raise RuntimeError(result.get("error", f"HTTP {response.status_code}"))
print(result)

Пример ответа

202 · application/json

{
  "success": true,
  "data": {
    "id": "op_0123456789abcdef0123456789abcdef",
    "state": "queued",
    "error": null,
    "result": null,
    "created_at": "2026-11-10T12:00:00+00:00",
    "status_url": "/api/partner/v1/operations/op_0123456789abcdef0123456789abcdef"
  }
}

Результат после выполнения

GET /operations/{id} · 200

{
  "success": true,
  "data": {
    "id": "op_0123456789abcdef0123456789abcdef",
    "state": "ready",
    "error": null,
    "result": {
      "id": "partner_0123456789abcdef0123456789abcdef",
      "state": "ready",
      "error": null,
      "order_ids": [
        "a1b2c3d4e5f60123456789abcdef0123"
      ],
      "amount_cents": 4050,
      "currency": "EUR",
      "price": {
        "currency": "EUR",
        "base_net_cents": 4500,
        "net_cents": 4050,
        "vat_cents": 0,
        "total_cents": 4050,
        "tax_at_topup": true,
        "discount_percent": 10,
        "months": 1,
        "days": 30,
        "pricing_version": 1,
        "tax": {
          "mode": "vat",
          "rate_percent": 23,
          "vat_code": "23",
          "reverse_charge": false
        }
      }
    },
    "created_at": "2026-11-10T12:00:00+00:00",
    "status_url": "/api/partner/v1/operations/op_0123456789abcdef0123456789abcdef"
  }
}

Пример запроса

cURL

curl --request POST \
  --url 'https://api.gigabit.ltd/api/partner/v1/orders/b1c2d3e4f5a60123456789abcdef0123/renew' \
  --header "Authorization: Bearer $GIGABIT_API_TOKEN" \
  --header 'Content-Type: application/json' \
  --data '{}'

JavaScript · Node.js

const response = await fetch(
  "https://api.gigabit.ltd/api/partner/v1/orders/b1c2d3e4f5a60123456789abcdef0123/renew",
  {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.GIGABIT_API_TOKEN}`,
      "Content-Type": "application/json"
    },
    body: JSON.stringify({})
  }
);
const result = await response.json();
if (!response.ok) throw new Error(result.error);
console.log(result);

Python · requests

# python -m pip install requests
import os
import requests

response = requests.post(
    "https://api.gigabit.ltd/api/partner/v1/orders/b1c2d3e4f5a60123456789abcdef0123/renew",
    headers={"Authorization": f"Bearer {os.environ['GIGABIT_API_TOKEN']}"},
    json={},
    timeout=30,
)
result = response.json()
if not response.ok:
    raise RuntimeError(result.get("error", f"HTTP {response.status_code}"))
print(result)

Пример ответа

202 · application/json

{
  "success": true,
  "data": {
    "id": "op_0123456789abcdef0123456789abcdef",
    "state": "queued",
    "error": null,
    "result": null,
    "created_at": "2026-11-10T12:00:00+00:00",
    "status_url": "/api/partner/v1/operations/op_0123456789abcdef0123456789abcdef"
  }
}

Результат после выполнения

GET /operations/{id} · 200

{
  "success": true,
  "data": {
    "id": "op_0123456789abcdef0123456789abcdef",
    "state": "ready",
    "error": null,
    "result": {
      "id": "partner_0123456789abcdef0123456789abcdef",
      "state": "ready",
      "error": null,
      "order_ids": [
        "a1b2c3d4e5f60123456789abcdef0123"
      ],
      "amount_cents": 4050,
      "currency": "EUR",
      "price": {
        "currency": "EUR",
        "base_net_cents": 4500,
        "net_cents": 4050,
        "vat_cents": 0,
        "total_cents": 4050,
        "tax_at_topup": true,
        "discount_percent": 10,
        "months": 1,
        "days": 30,
        "pricing_version": 1,
        "tax": {
          "mode": "vat",
          "rate_percent": 23,
          "vat_code": "23",
          "reverse_charge": false
        }
      }
    },
    "created_at": "2026-11-10T12:00:00+00:00",
    "status_url": "/api/partner/v1/operations/op_0123456789abcdef0123456789abcdef"
  }
}

Поля ответов →

Доступы и смена IP

Сброс токена смены IP

POST

Создаёт новый токен смены IP и возвращает готовую ссылку. Старый токен и все ссылки с ним сразу перестают работать. Пароль прокси и таймер не меняются.

Ответ возвращается сразу, без фоновой операции. Новая ссылка также доступна в поле rotation_url данных порта.

Параметры

Поле	Тип	Описание
`id`В пути · Обязательно	`string`	ID заказа из поля id в списке портов.

Пример запроса

cURL

curl --request POST \
  --url 'https://api.gigabit.ltd/api/partner/v1/orders/a1b2c3d4e5f60123456789abcdef0123/rotation-token' \
  --header "Authorization: Bearer $GIGABIT_API_TOKEN" \
  --header 'Content-Type: application/json' \
  --data '{}'

JavaScript · Node.js

const response = await fetch(
  "https://api.gigabit.ltd/api/partner/v1/orders/a1b2c3d4e5f60123456789abcdef0123/rotation-token",
  {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.GIGABIT_API_TOKEN}`,
      "Content-Type": "application/json"
    },
    body: JSON.stringify({})
  }
);
const result = await response.json();
if (!response.ok) throw new Error(result.error);
console.log(result);

Python · requests

# python -m pip install requests
import os
import requests

response = requests.post(
    "https://api.gigabit.ltd/api/partner/v1/orders/a1b2c3d4e5f60123456789abcdef0123/rotation-token",
    headers={"Authorization": f"Bearer {os.environ['GIGABIT_API_TOKEN']}"},
    json={},
    timeout=30,
)
result = response.json()
if not response.ok:
    raise RuntimeError(result.get("error", f"HTTP {response.status_code}"))
print(result)

Пример ответа

200 · application/json

{
  "success": true,
  "data": {
    "rotation_token": "0123456789abcdef0123456789abcdef",
    "rotation_url": "https://api.gigabit.ltd/change_ip?token=0123456789abcdef0123456789abcdef"
  }
}

Смена доступов по ID

POST

Сервер генерирует новый пароль. При change_login=true одновременно генерируется новый логин с актуальным префиксом партнёра. Работает только для активной аренды.

Новые данные доступны в result после применения. При ошибке operation_superseded более новая команда уже изменила доступы.

Параметры

Поле	Тип	Описание
`id`В пути · Обязательно	`string`	ID заказа (id) или порта (port_id) из списка портов.
`change_login`Тело JSON · Необязательно	`boolean`	true - новый логин с текущим префиксом и новый пароль. false - только пароль. На старом общем доступе создаётся отдельная пара и без флага.

Вариант примера

Пример запроса

cURL

curl --request POST \
  --url 'https://api.gigabit.ltd/api/partner/v1/orders/a1b2c3d4e5f60123456789abcdef0123/password' \
  --header "Authorization: Bearer $GIGABIT_API_TOKEN" \
  --header 'Content-Type: application/json' \
  --data '{
  "change_login": true
}'

JavaScript · Node.js

const response = await fetch(
  "https://api.gigabit.ltd/api/partner/v1/orders/a1b2c3d4e5f60123456789abcdef0123/password",
  {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.GIGABIT_API_TOKEN}`,
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "change_login": true
    })
  }
);
const result = await response.json();
if (!response.ok) throw new Error(result.error);
console.log(result);

Python · requests

# python -m pip install requests
import os
import requests

response = requests.post(
    "https://api.gigabit.ltd/api/partner/v1/orders/a1b2c3d4e5f60123456789abcdef0123/password",
    headers={"Authorization": f"Bearer {os.environ['GIGABIT_API_TOKEN']}"},
    json={'change_login': True},
    timeout=30,
)
result = response.json()
if not response.ok:
    raise RuntimeError(result.get("error", f"HTTP {response.status_code}"))
print(result)

Пример ответа

202 · application/json

{
  "success": true,
  "data": {
    "id": "op_0123456789abcdef0123456789abcdef",
    "state": "queued",
    "error": null,
    "result": null,
    "created_at": "2026-11-10T12:00:00+00:00",
    "status_url": "/api/partner/v1/operations/op_0123456789abcdef0123456789abcdef"
  }
}

Результат после выполнения

GET /operations/{id} · 200

{
  "success": true,
  "data": {
    "id": "op_0123456789abcdef0123456789abcdef",
    "state": "ready",
    "error": null,
    "result": {
      "state": "synced",
      "username": "astra_b2c3d4e5f6a",
      "password": "EXAMPLE_NEW_PASSWORD_xx"
    },
    "created_at": "2026-11-10T12:00:00+00:00",
    "status_url": "/api/partner/v1/operations/op_0123456789abcdef0123456789abcdef"
  }
}

Пример запроса

cURL

curl --request POST \
  --url 'https://api.gigabit.ltd/api/partner/v1/orders/a1b2c3d4e5f60123456789abcdef0123/password' \
  --header "Authorization: Bearer $GIGABIT_API_TOKEN" \
  --header 'Content-Type: application/json' \
  --data '{
  "change_login": false
}'

JavaScript · Node.js

const response = await fetch(
  "https://api.gigabit.ltd/api/partner/v1/orders/a1b2c3d4e5f60123456789abcdef0123/password",
  {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.GIGABIT_API_TOKEN}`,
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "change_login": false
    })
  }
);
const result = await response.json();
if (!response.ok) throw new Error(result.error);
console.log(result);

Python · requests

# python -m pip install requests
import os
import requests

response = requests.post(
    "https://api.gigabit.ltd/api/partner/v1/orders/a1b2c3d4e5f60123456789abcdef0123/password",
    headers={"Authorization": f"Bearer {os.environ['GIGABIT_API_TOKEN']}"},
    json={'change_login': False},
    timeout=30,
)
result = response.json()
if not response.ok:
    raise RuntimeError(result.get("error", f"HTTP {response.status_code}"))
print(result)

Пример ответа

202 · application/json

{
  "success": true,
  "data": {
    "id": "op_0123456789abcdef0123456789abcdef",
    "state": "queued",
    "error": null,
    "result": null,
    "created_at": "2026-11-10T12:00:00+00:00",
    "status_url": "/api/partner/v1/operations/op_0123456789abcdef0123456789abcdef"
  }
}

Результат после выполнения

GET /operations/{id} · 200

{
  "success": true,
  "data": {
    "id": "op_0123456789abcdef0123456789abcdef",
    "state": "ready",
    "error": null,
    "result": {
      "state": "synced",
      "username": "astra_a1b2c3d4e5f",
      "password": "EXAMPLE_NEW_PASSWORD_xx"
    },
    "created_at": "2026-11-10T12:00:00+00:00",
    "status_url": "/api/partner/v1/operations/op_0123456789abcdef0123456789abcdef"
  }
}

Поля ответов →

Таймер смены IP

GET

Текущее состояние таймера. При rotation=true возвращается rotation_seconds. При выключенном таймере возвращается только rotation=false.

Параметры

Поле	Тип	Описание
`id`В пути · Обязательно	`string`	ID заказа (id) или порта (port_id) из списка портов.

Вариант примера

Пример запроса

cURL

curl --request GET \
  --url 'https://api.gigabit.ltd/api/partner/v1/orders/a1b2c3d4e5f60123456789abcdef0123/rotation' \
  --header "Authorization: Bearer $GIGABIT_API_TOKEN"

JavaScript · Node.js

const response = await fetch(
  "https://api.gigabit.ltd/api/partner/v1/orders/a1b2c3d4e5f60123456789abcdef0123/rotation",
  {
    method: "GET",
    headers: {
      Authorization: `Bearer ${process.env.GIGABIT_API_TOKEN}`
    }
  }
);
const result = await response.json();
if (!response.ok) throw new Error(result.error);
console.log(result);

Python · requests

# python -m pip install requests
import os
import requests

response = requests.get(
    "https://api.gigabit.ltd/api/partner/v1/orders/a1b2c3d4e5f60123456789abcdef0123/rotation",
    headers={"Authorization": f"Bearer {os.environ['GIGABIT_API_TOKEN']}"},
    timeout=30,
)
result = response.json()
if not response.ok:
    raise RuntimeError(result.get("error", f"HTTP {response.status_code}"))
print(result)

Пример ответа

200 · application/json

{
  "success": true,
  "data": {
    "rotation": true,
    "rotation_seconds": 120
  }
}

Пример запроса

cURL

curl --request GET \
  --url 'https://api.gigabit.ltd/api/partner/v1/orders/a1b2c3d4e5f60123456789abcdef0123/rotation' \
  --header "Authorization: Bearer $GIGABIT_API_TOKEN"

JavaScript · Node.js

const response = await fetch(
  "https://api.gigabit.ltd/api/partner/v1/orders/a1b2c3d4e5f60123456789abcdef0123/rotation",
  {
    method: "GET",
    headers: {
      Authorization: `Bearer ${process.env.GIGABIT_API_TOKEN}`
    }
  }
);
const result = await response.json();
if (!response.ok) throw new Error(result.error);
console.log(result);

Python · requests

# python -m pip install requests
import os
import requests

response = requests.get(
    "https://api.gigabit.ltd/api/partner/v1/orders/a1b2c3d4e5f60123456789abcdef0123/rotation",
    headers={"Authorization": f"Bearer {os.environ['GIGABIT_API_TOKEN']}"},
    timeout=30,
)
result = response.json()
if not response.ok:
    raise RuntimeError(result.get("error", f"HTTP {response.status_code}"))
print(result)

Пример ответа

200 · application/json

{
  "success": true,
  "data": {
    "rotation": false
  }
}

Поля ответов →

Настройка таймера

PUT

Для включения передаются rotation=true и rotation_seconds, целое число от 20 до 86400 секунд. Значение меньше 20 возвращает ошибку rotation_interval_too_short. Для отключения передаётся только rotation=false.

Операция остаётся processing до подтверждения применения таймера.

Параметры

Поле	Тип	Описание
`id`В пути · Обязательно	`string`	ID заказа (id) или порта (port_id) из списка портов.
`rotation`Тело JSON · Обязательно	`boolean`	true - включить таймер; false - выключить.
`rotation_seconds`Тело JSON · Необязательно	`integer`20-86400	Обязательно при rotation=true. При rotation=false поле не передаётся.

Вариант примера

Пример запроса

cURL

curl --request PUT \
  --url 'https://api.gigabit.ltd/api/partner/v1/orders/a1b2c3d4e5f60123456789abcdef0123/rotation' \
  --header "Authorization: Bearer $GIGABIT_API_TOKEN" \
  --header 'Content-Type: application/json' \
  --data '{
  "rotation": true,
  "rotation_seconds": 120
}'

JavaScript · Node.js

const response = await fetch(
  "https://api.gigabit.ltd/api/partner/v1/orders/a1b2c3d4e5f60123456789abcdef0123/rotation",
  {
    method: "PUT",
    headers: {
      Authorization: `Bearer ${process.env.GIGABIT_API_TOKEN}`,
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "rotation": true,
      "rotation_seconds": 120
    })
  }
);
const result = await response.json();
if (!response.ok) throw new Error(result.error);
console.log(result);

Python · requests

# python -m pip install requests
import os
import requests

response = requests.put(
    "https://api.gigabit.ltd/api/partner/v1/orders/a1b2c3d4e5f60123456789abcdef0123/rotation",
    headers={"Authorization": f"Bearer {os.environ['GIGABIT_API_TOKEN']}"},
    json={'rotation': True, 'rotation_seconds': 120},
    timeout=30,
)
result = response.json()
if not response.ok:
    raise RuntimeError(result.get("error", f"HTTP {response.status_code}"))
print(result)

Пример ответа

202 · application/json

{
  "success": true,
  "data": {
    "id": "op_0123456789abcdef0123456789abcdef",
    "state": "queued",
    "error": null,
    "result": null,
    "created_at": "2026-11-10T12:00:00+00:00",
    "status_url": "/api/partner/v1/operations/op_0123456789abcdef0123456789abcdef"
  }
}

Результат после выполнения

GET /operations/{id} · 200

{
  "success": true,
  "data": {
    "id": "op_0123456789abcdef0123456789abcdef",
    "state": "ready",
    "error": null,
    "result": {
      "rotation": true,
      "rotation_seconds": 120
    },
    "created_at": "2026-11-10T12:00:00+00:00",
    "status_url": "/api/partner/v1/operations/op_0123456789abcdef0123456789abcdef"
  }
}

Пример запроса

cURL

curl --request PUT \
  --url 'https://api.gigabit.ltd/api/partner/v1/orders/a1b2c3d4e5f60123456789abcdef0123/rotation' \
  --header "Authorization: Bearer $GIGABIT_API_TOKEN" \
  --header 'Content-Type: application/json' \
  --data '{
  "rotation": false
}'

JavaScript · Node.js

const response = await fetch(
  "https://api.gigabit.ltd/api/partner/v1/orders/a1b2c3d4e5f60123456789abcdef0123/rotation",
  {
    method: "PUT",
    headers: {
      Authorization: `Bearer ${process.env.GIGABIT_API_TOKEN}`,
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "rotation": false
    })
  }
);
const result = await response.json();
if (!response.ok) throw new Error(result.error);
console.log(result);

Python · requests

# python -m pip install requests
import os
import requests

response = requests.put(
    "https://api.gigabit.ltd/api/partner/v1/orders/a1b2c3d4e5f60123456789abcdef0123/rotation",
    headers={"Authorization": f"Bearer {os.environ['GIGABIT_API_TOKEN']}"},
    json={'rotation': False},
    timeout=30,
)
result = response.json()
if not response.ok:
    raise RuntimeError(result.get("error", f"HTTP {response.status_code}"))
print(result)

Пример ответа

202 · application/json

{
  "success": true,
  "data": {
    "id": "op_0123456789abcdef0123456789abcdef",
    "state": "queued",
    "error": null,
    "result": null,
    "created_at": "2026-11-10T12:00:00+00:00",
    "status_url": "/api/partner/v1/operations/op_0123456789abcdef0123456789abcdef"
  }
}

Результат после выполнения

GET /operations/{id} · 200

{
  "success": true,
  "data": {
    "id": "op_0123456789abcdef0123456789abcdef",
    "state": "ready",
    "error": null,
    "result": {
      "rotation": false
    },
    "created_at": "2026-11-10T12:00:00+00:00",
    "status_url": "/api/partner/v1/operations/op_0123456789abcdef0123456789abcdef"
  }
}

Поля ответов →

Профиль партнёра

Префикс логинов

PUT

Префикс - начало логинов портов, например название бренда. Логины генерируются в формате prefix_random: при prefix=astra новый порт получит логин вида astra_a1b2c3d4e5f. Случайная часть создаётся отдельно для каждого порта.

Изменение префикса не меняет уже выданные логины. Новые порты и смена логина через change_login=true используют текущий префикс. Префикс должен быть уникальным; занятый возвращает 409 partner_prefix_taken.

Параметры

Поле	Тип	Описание
`prefix`Тело JSON · Обязательно	`string`2-24	2-24 символа: латиница, цифры и дефис; первый символ - буква. Приводится к нижнему регистру. proxy и gigabit зарезервированы.

Пример запроса

cURL

curl --request PUT \
  --url 'https://api.gigabit.ltd/api/partner/v1/profile' \
  --header "Authorization: Bearer $GIGABIT_API_TOKEN" \
  --header 'Content-Type: application/json' \
  --data '{
  "prefix": "astra"
}'

JavaScript · Node.js

const response = await fetch(
  "https://api.gigabit.ltd/api/partner/v1/profile",
  {
    method: "PUT",
    headers: {
      Authorization: `Bearer ${process.env.GIGABIT_API_TOKEN}`,
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "prefix": "astra"
    })
  }
);
const result = await response.json();
if (!response.ok) throw new Error(result.error);
console.log(result);

Python · requests

# python -m pip install requests
import os
import requests

response = requests.put(
    "https://api.gigabit.ltd/api/partner/v1/profile",
    headers={"Authorization": f"Bearer {os.environ['GIGABIT_API_TOKEN']}"},
    json={'prefix': 'astra'},
    timeout=30,
)
result = response.json()
if not response.ok:
    raise RuntimeError(result.get("error", f"HTTP {response.status_code}"))
print(result)

Пример ответа

200 · application/json

{
  "success": true,
  "data": {
    "prefix": "astra"
  }
}

Поля ответов