ProxyLite OpenAPI
Поддерживает управление личными учетными записями, ресурсами агентов и групповыми биллингами через префикс OpenAPI сайта.
Метод аутентификации зависит от определения безопасности каждой операции:
- apiKeyAuth: передать личный или групповой ключ API через параметр запроса app_key; бэкэнд также совместим с параметрами key, appkey, openid и параметрами тела запроса POST.
- BearerAuth: авторизация: носитель <JWT>, используемый для токенов входа в Интернет. Не думайте о ключах API как о JWT.
- Командный API-ключ привязан к фиксированной команде; интерфейсы, поддерживающие пространство команды, могут опускать team_id, а явный ввод должен соответствовать команде привязки клавиш.
- Интерфейсы, поддерживающие только личное пространство, будут отклонять командный ключ API; командные операции по-прежнему следуют разрешениям на ресурсы члена холдинга.
Ответ JSON содержит код, сообщение, данные, request_id. код=200 означает, что бизнес успешен; HTTP 200 также может содержать код бизнес-ошибки. msg меняется в зависимости от языка запроса, и клиент должен использовать код для определения результата. Некоторые интерфейсы экспорта также поддерживают текст, CSV или XML; подробности см. в определении операции. Поля суммы, потока, даты и подкачки подчиняются схеме каждого интерфейса.
Базовые URL:
Аутентификация
- HTTP-аутентификация, схема: bearer
- API-ключ (apiKeyAuth)
- Имя параметра: app_key, in: query. Личный или командный ключ API. Рекомендуемый параметр запроса app_key; также совместим с ключом/appkey/openid и телом запроса POST. Ключи команды могут получить доступ только к поддерживаемым интерфейсам связанной команды.
Управление счетами агентства
Список аккаунтов агентов (GET /end-point/whitelist-account/list)
Примеры кода
# Также можно использовать wget
curl -X GET https://api.proxylite.com/end-point/whitelist-account/list \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
GET /end-point/whitelist-account/list
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| team_id | query | ResourceSpaceId | false | Идентификатор ресурсного пространства; опустите личное пространство или передайте пустую строку; Ключ команды можно опустить и он должен соответствовать ключу при передаче. |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "string",
"data": {
"list": [
{
"id": 0,
"username": "string",
"password": "string",
"created_at": "string",
"remark": "string",
"product_type": 9,
"usage_flow": 0,
"limit_flow": 102400,
"status": 0
}
]
}
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | Запрос успешен | Inline |
Схема ответа
Status Code 200
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| » code | responseCode | false | нет | Код состояния, 200 успешно, 3 app_key недействительны |
| » msg | string | false | нет | сообщение о состоянии |
| » data | object | false | нет | none |
| »» list | [object] | false | нет | none |
| »»» id | integer | false | нет | Номер счета |
| »»» username | string | false | нет | Имя учетной записи агента |
| »»» password | string | false | нет | Пароль от учетной записи агента |
| »»» created_at | string | false | нет | Добавить время |
| »»» remark | string | false | нет | Примечания |
| »»» product_type | productTypes | false | нет | Тип пакета, 9 пакетов динамического трафика для жилых помещений, 11 динамических IP для жилых помещений, 14 статических IP-адресов для центров обработки данных, 25 статических IP-адресов для жилых помещений |
| »»» usage_flow | integer | false | нет | Использованный трафик, ед.: КБ |
| »»» limit_flow | integer | false | нет | Настраиваемый лимит трафика: максимальная единица ГБ — 102400, 0 — без ограничений. |
| »»» status | integer | false | нет | Статус «Включено»: 1 включен, 0 отключен. |
Допустимые значения
| Свойство | Значение |
|---|---|
| product_type | 9 |
| product_type | 11 |
| product_type | 14 |
| product_type | 25 |
Обнаружение ограничений трафика, которые можно установить на прокси-аккаунты
Примеры кода
# Также можно использовать wget
curl -X POST https://api.proxylite.com/end-point/whitelist-account/check \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
POST /end-point/whitelist-account/check
Body parameter
{
"team_id": "A1b2C3d4E5f6",
"account": "string"
}
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| body | body | object | false | нет |
| » team_id | body | any | false | Идентификация пространства государственных ресурсов; опустите team_id или передайте пустую строку при запросе личного пространства и пустую строку при ответе на личное пространство; и число 0, и строка «0» незаконны, а в командном пространстве используется 6-12-значный публичный идентификатор команды. |
| »» anonymous | body | string | false | нет |
| »» anonymous | body | TeamPublicId | false | Публичный логотип команды, первый символ — буква ASCII, остальные символы содержат только буквы и цифры ASCII; числовой первичный ключ базы данных не выдан |
| » account | body | string | false | Передайте имя учетной записи при редактировании существующей учетной записи агента. |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {
"isAgent": 0,
"trendMax": 0,
"staticMax": 0,
"maxLimit": 0,
"minLimit": 0
},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | Запрос успешен | Inline |
Схема ответа
Допустимые значения
| Свойство | Значение |
|---|---|
| isAgent | 0 |
| isAgent | 1 |
Получите квоту субсчета динамического агента и использованное количество.
Примеры кода
# Также можно использовать wget
curl -X GET https://api.proxylite.com/end-point/whitelist-account/child-account \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
GET /end-point/whitelist-account/child-account
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| team_id | query | ResourceSpaceId | false | Идентификатор ресурсного пространства; личное пространство опустить или передать пустую строку |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {
"totalChildAccount": 0,
"usedChildAccount": 0
},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | Запрос успешен | Inline |
Схема ответа
Добавить аккаунт агента. (POST /end-point/whitelist-account/add)
Примеры кода
# Также можно использовать wget
curl -X POST https://api.proxylite.com/end-point/whitelist-account/add \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
POST /end-point/whitelist-account/add
Body parameter
{
"team_id": "A1b2C3d4E5f6",
"app_key": "stringstringstringstringstringst",
"accounts": "user01:pass,user02:pass,user03:pass",
"remark": "",
"product_type": 9
}
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| body | body | object | false | нет |
| » team_id | body | any | false | Идентификация пространства государственных ресурсов; опустите team_id или передайте пустую строку при запросе личного пространства и пустую строку при ответе на личное пространство; и число 0, и строка «0» незаконны, а в командном пространстве используется 6-12-значный публичный идентификатор команды. |
| »» anonymous | body | string | false | нет |
| »» anonymous | body | TeamPublicId | false | Публичный логотип команды, первый символ — буква ASCII, остальные символы содержат только буквы и цифры ASCII; числовой первичный ключ базы данных не выдан |
| » app_key | body | string | false | Ключ авторизации |
| » accounts | body | string | true | Пароль учетной записи. Введите его в формате имя пользователя:пароль. Учетная запись и пароль поддерживают только цифры и буквы. Запрещено вводить любые специальные символы и пробелы. Двоеточие разделяет учетную запись и пароль. Поддерживается пакетное добавление, а учетные записи агентов разделяются английскими запятыми (,). |
| » remark | body | string | false | Описание аккаунта агента |
| » product_type | body | productTypes | false | Тип пакета, 9 пакетов динамического трафика для жилых помещений, 11 динамических IP для жилых помещений, 14 статических IP-адресов для центров обработки данных, 25 статических IP-адресов для жилых помещений |
Допустимые значения
| Parameter | Value |
|---|---|
| » product_type | 9 |
| » product_type | 11 |
| » product_type | 14 |
| » product_type | 25 |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "string",
"data": null
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | Запрос успешен | Inline |
Схема ответа
Status Code 200
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| » code | integer | false | нет | Код состояния, 200 успешно, 3 app_key недействителен, 156 учетная запись не аутентифицирована. |
| » msg | string | false | нет | сообщение о состоянии |
| » data | null | false | нет | none |
Удалить прокси-аккаунт (POST /end-point/whitelist-account/delete)
Примеры кода
# Также можно использовать wget
curl -X POST https://api.proxylite.com/end-point/whitelist-account/delete \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
POST /end-point/whitelist-account/delete
Обратите внимание, что после удаления его невозможно восстановить, а использованный трафик нельзя запросить. Для удаления потребуется время ожидания примерно 5 минут, в течение которого все еще может взиматься плата.
Body parameter
{
"team_id": "A1b2C3d4E5f6",
"app_key": "stringstringstringstringstringst",
"accounts": "user01,user02"
}
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| body | body | object | false | нет |
| » team_id | body | any | false | Идентификация пространства государственных ресурсов; опустите team_id или передайте пустую строку при запросе личного пространства и пустую строку при ответе на личное пространство; и число 0, и строка «0» незаконны, а в командном пространстве используется 6-12-значный публичный идентификатор команды. |
| »» anonymous | body | string | false | нет |
| »» anonymous | body | TeamPublicId | false | Публичный логотип команды, первый символ — буква ASCII, остальные символы содержат только буквы и цифры ASCII; числовой первичный ключ базы данных не выдан |
| » app_key | body | string | false | Ключ авторизации |
| » accounts | body | string | true | Аккаунт агента, поддерживаются только цифры и буквы. Поддержка пакетных операций, английские запятые (,) для отдельных учетных записей агентов. |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "string",
"data": null
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | Запрос успешен | Inline |
Схема ответа
Status Code 200
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| » code | integer | false | нет | Код состояния, 200 успешно, 3 app_key недействителен, 156 учетная запись не аутентифицирована. |
| » msg | string | false | нет | сообщение о состоянии |
| » data | null | false | нет | none |
Отключить прокси-аккаунт (POST /end-point/whitelist-account/disable)
Примеры кода
# Также можно использовать wget
curl -X POST https://api.proxylite.com/end-point/whitelist-account/disable \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
POST /end-point/whitelist-account/disable
Для отключения потребуется время ожидания примерно 5 минут, в течение этого времени еще может взиматься плата.
Body parameter
{
"team_id": "A1b2C3d4E5f6",
"app_key": "stringstringstringstringstringst",
"accounts": "user01,user02"
}
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| body | body | object | false | нет |
| » team_id | body | any | false | Идентификация пространства государственных ресурсов; опустите team_id или передайте пустую строку при запросе личного пространства и пустую строку при ответе на личное пространство; и число 0, и строка «0» незаконны, а в командном пространстве используется 6-12-значный публичный идентификатор команды. |
| »» anonymous | body | string | false | нет |
| »» anonymous | body | TeamPublicId | false | Публичный логотип команды, первый символ — буква ASCII, остальные символы содержат только буквы и цифры ASCII; числовой первичный ключ базы данных не выдан |
| » app_key | body | string | false | Ключ авторизации |
| » accounts | body | string | true | Аккаунт агента, поддерживаются только цифры и буквы. Поддержка пакетных операций, английские запятые (,) для отдельных учетных записей агентов. |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "string",
"data": null
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | Запрос успешен | Inline |
Схема ответа
Status Code 200
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| » code | integer | false | нет | Код состояния, 200 успешно, 3 app_key недействителен, 156 учетная запись не аутентифицирована. |
| » msg | string | false | нет | сообщение о состоянии |
| » data | null | false | нет | none |
Включить прокси-аккаунт (POST /end-point/whitelist-account/enable)
Примеры кода
# Также можно использовать wget
curl -X POST https://api.proxylite.com/end-point/whitelist-account/enable \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
POST /end-point/whitelist-account/enable
Body parameter
{
"team_id": "A1b2C3d4E5f6",
"app_key": "stringstringstringstringstringst",
"accounts": "user01,user02"
}
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| body | body | object | false | нет |
| » team_id | body | any | false | Идентификация пространства государственных ресурсов; опустите team_id или передайте пустую строку при запросе личного пространства и пустую строку при ответе на личное пространство; и число 0, и строка «0» незаконны, а в командном пространстве используется 6-12-значный публичный идентификатор команды. |
| »» anonymous | body | string | false | нет |
| »» anonymous | body | TeamPublicId | false | Публичный логотип команды, первый символ — буква ASCII, остальные символы содержат только буквы и цифры ASCII; числовой первичный ключ базы данных не выдан |
| » app_key | body | string | false | Ключ авторизации |
| » accounts | body | string | true | Аккаунт агента, поддерживаются только цифры и буквы. Поддержка пакетных операций, английские запятые (,) для отдельных учетных записей агентов. |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "string",
"data": null
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | Запрос успешен | Inline |
Схема ответа
Status Code 200
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| » code | integer | false | нет | Код состояния, 200 успешно, 3 app_key недействителен, 156 учетная запись не аутентифицирована. |
| » msg | string | false | нет | сообщение о состоянии |
| » data | null | false | нет | none |
Изменить пароль учетной записи агента
Примеры кода
# Также можно использовать wget
curl -X POST https://api.proxylite.com/end-point/whitelist-account/change-password \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
POST /end-point/whitelist-account/change-password
Обратите внимание, что после изменения существует 5-минутный период ожидания, в течение которого старый пароль можно использовать в обычном режиме.
Body parameter
{
"team_id": "A1b2C3d4E5f6",
"app_key": "stringstringstringstringstringst",
"account": "user",
"password": "pass"
}
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| body | body | object | false | нет |
| » team_id | body | any | false | Идентификация пространства государственных ресурсов; опустите team_id или передайте пустую строку при запросе личного пространства и пустую строку при ответе на личное пространство; и число 0, и строка «0» незаконны, а в командном пространстве используется 6-12-значный публичный идентификатор команды. |
| »» anonymous | body | string | false | нет |
| »» anonymous | body | TeamPublicId | false | Публичный логотип команды, первый символ — буква ASCII, остальные символы содержат только буквы и цифры ASCII; числовой первичный ключ базы данных не выдан |
| » app_key | body | string | false | Ключ авторизации |
| » account | body | string | true | Аккаунт агента, поддерживаются только цифры и буквы. |
| » password | body | string | true | Новый пароль для учетной записи агента поддерживает только цифры и буквы. |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "string",
"data": null
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | Запрос успешен | Inline |
Схема ответа
Status Code 200
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| » code | integer | false | нет | Код состояния, 200 успешно, 3 app_key недействителен, 156 учетная запись не аутентифицирована. |
| » msg | string | false | нет | сообщение о состоянии |
| » data | null | false | нет | none |
Изменить примечания к учетной записи агента
Примеры кода
# Также можно использовать wget
curl -X POST https://api.proxylite.com/end-point/whitelist-account/change-remark \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
POST /end-point/whitelist-account/change-remark
Body parameter
{
"team_id": "A1b2C3d4E5f6",
"app_key": "stringstringstringstringstringst",
"account": "user",
"remark": ""
}
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| body | body | object | false | нет |
| » team_id | body | any | false | Идентификация пространства государственных ресурсов; опустите team_id или передайте пустую строку при запросе личного пространства и пустую строку при ответе на личное пространство; и число 0, и строка «0» незаконны, а в командном пространстве используется 6-12-значный публичный идентификатор команды. |
| »» anonymous | body | string | false | нет |
| »» anonymous | body | TeamPublicId | false | Публичный логотип команды, первый символ — буква ASCII, остальные символы содержат только буквы и цифры ASCII; числовой первичный ключ базы данных не выдан |
| » app_key | body | string | false | Ключ авторизации |
| » account | body | string | true | Аккаунт агента, поддерживаются только цифры и буквы. |
| » remark | body | string | true | Новые примечания для аккаунтов агентств длиной до 32 китайских иероглифов или 64 английских символов. |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "string",
"data": null
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | Запрос успешен | Inline |
Схема ответа
Status Code 200
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| » code | integer | false | нет | Код состояния, 200 успешно, 3 app_key недействителен, 156 учетная запись не аутентифицирована. |
| » msg | string | false | нет | сообщение о состоянии |
| » data | null | false | нет | none |
Изменить лимит трафика прокси-аккаунта
Примеры кода
# Также можно использовать wget
curl -X POST https://api.proxylite.com/end-point/whitelist-account/change-limit \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
POST /end-point/whitelist-account/change-limit
Обратите внимание, что статистика трафика может запаздывать в течение 5 минут, то есть фактически потребляемый трафик может превышать этот лимит.
Body parameter
{
"team_id": "A1b2C3d4E5f6",
"app_key": "stringstringstringstringstringst",
"account": "user",
"limit": 0
}
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| body | body | object | false | нет |
| » team_id | body | any | false | Идентификация пространства государственных ресурсов; опустите team_id или передайте пустую строку при запросе личного пространства и пустую строку при ответе на личное пространство; и число 0, и строка «0» незаконны, а в командном пространстве используется 6-12-значный публичный идентификатор команды. |
| »» anonymous | body | string | false | нет |
| »» anonymous | body | TeamPublicId | false | Публичный логотип команды, первый символ — буква ASCII, остальные символы содержат только буквы и цифры ASCII; числовой первичный ключ базы данных не выдан |
| » app_key | body | string | false | Ключ авторизации |
| » account | body | string | true | Аккаунт агента, поддерживаются только цифры и буквы. |
| » limit | body | integer | false | Лимит трафика, единица измерения: ГБ, 0 означает отсутствие верхнего предела. |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "string",
"data": null
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | Запрос успешен | Inline |
Схема ответа
Status Code 200
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| » code | integer | false | нет | Код состояния, 200 успешно, 3 app_key недействителен, 156 учетная запись не аутентифицирована. |
| » msg | string | false | нет | сообщение о состоянии |
| » data | null | false | нет | none |
Быстро создать учетную запись агента
Примеры кода
# Также можно использовать wget
curl -X POST https://api.proxylite.com/end-point/whitelist-account/quick-add \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
POST /end-point/whitelist-account/quick-add
Body parameter
{
"team_id": "A1b2C3d4E5f6",
"product_type": 0
}
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| body | body | object | true | нет |
| » team_id | body | any | false | Идентификация пространства государственных ресурсов; опустите team_id или передайте пустую строку при запросе личного пространства и пустую строку при ответе на личное пространство; и число 0, и строка «0» незаконны, а в командном пространстве используется 6-12-значный публичный идентификатор команды. |
| »» anonymous | body | string | false | нет |
| »» anonymous | body | TeamPublicId | false | Публичный логотип команды, первый символ — буква ASCII, остальные символы содержат только буквы и цифры ASCII; числовой первичный ключ базы данных не выдан |
| » product_type | body | integer | true | нет |
Примеры ответов
Ответ 200
{
"code": 0,
"msg": "string",
"request_id": "string",
"data": {
"username": "string",
"password": "string"
}
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | Новая учетная запись и пароль будут возвращены, когда бизнес будет успешным. | Inline |
Схема ответа
Status Code 200
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| » code | integer | false | нет | none |
| » msg | string | false | нет | none |
| » request_id | string | false | нет | none |
| » data | any | false | нет | none |
oneOf
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| »» anonymous | object | false | нет | none |
| »»» username | string | true | нет | none |
| »»» password | string | true | нет | none |
xor
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| »» anonymous | null | false | нет | none |
Изменить дневной лимит трафика агентского аккаунта
Примеры кода
# Также можно использовать wget
curl -X POST https://api.proxylite.com/end-point/whitelist-account/change-daily-limit \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
POST /end-point/whitelist-account/change-daily-limit
Body parameter
{
"team_id": "A1b2C3d4E5f6",
"account": "string",
"daily_limit": 0
}
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| body | body | object | true | нет |
| » team_id | body | any | false | Идентификация пространства государственных ресурсов; опустите team_id или передайте пустую строку при запросе личного пространства и пустую строку при ответе на личное пространство; и число 0, и строка «0» незаконны, а в командном пространстве используется 6-12-значный публичный идентификатор команды. |
| »» anonymous | body | string | false | нет |
| »» anonymous | body | TeamPublicId | false | Публичный логотип команды, первый символ — буква ASCII, остальные символы содержат только буквы и цифры ASCII; числовой первичный ключ базы данных не выдан |
| » account | body | string | true | нет |
| » daily_limit | body | integer | false | Единица ГБ |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | Операция прошла успешно | WebV1SuccessResponse |
Изменить информацию об учетной записи агента (POST /end-point/whitelist-account/change)
Примеры кода
# Также можно использовать wget
curl -X POST https://api.proxylite.com/end-point/whitelist-account/change \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
POST /end-point/whitelist-account/change
Body parameter
{
"team_id": "A1b2C3d4E5f6",
"account": "string",
"password": "string",
"remark": "string",
"limit": 0,
"daily_limit": 0,
"status": 0,
"udp": 0
}
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| body | body | object | true | нет |
| » team_id | body | any | false | Идентификация пространства государственных ресурсов; опустите team_id или передайте пустую строку при запросе личного пространства и пустую строку при ответе на личное пространство; и число 0, и строка «0» незаконны, а в командном пространстве используется 6-12-значный публичный идентификатор команды. |
| »» anonymous | body | string | false | нет |
| »» anonymous | body | TeamPublicId | false | Публичный логотип команды, первый символ — буква ASCII, остальные символы содержат только буквы и цифры ASCII; числовой первичный ключ базы данных не выдан |
| » account | body | string | true | нет |
| » password | body | string | false | нет |
| » remark | body | string | false | нет |
| » limit | body | integer | false | Общий лимит трафика в ГБ |
| » daily_limit | body | integer | false | Суточный лимит трафика в ГБ |
| » status | body | integer | false | нет |
| » udp | body | integer | false | нет |
Допустимые значения
| Parameter | Value |
|---|---|
| » status | 0 |
| » status | 1 |
| » udp | 0 |
| » udp | 1 |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | Операция прошла успешно | WebV1SuccessResponse |
Обновить кэш аутентификации учетной записи прокси текущего ресурсного пространства.
Примеры кода
# Также можно использовать wget
curl -X POST https://api.proxylite.com/end-point/whitelist-account/refresh \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
POST /end-point/whitelist-account/refresh
Body parameter
{
"team_id": "A1b2C3d4E5f6"
}
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| body | body | object | false | нет |
| » team_id | body | any | false | Идентификация пространства государственных ресурсов; опустите team_id или передайте пустую строку при запросе личного пространства и пустую строку при ответе на личное пространство; и число 0, и строка «0» незаконны, а в командном пространстве используется 6-12-значный публичный идентификатор команды. |
| »» anonymous | body | string | false | нет |
| »» anonymous | body | TeamPublicId | false | Публичный логотип команды, первый символ — буква ASCII, остальные символы содержат только буквы и цифры ASCII; числовой первичный ключ базы данных не выдан |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | Операция прошла успешно | WebV1SuccessResponse |
Квота аккаунта агентства для указанных типов продуктов
Примеры кода
# Также можно использовать wget
curl -X GET https://api.proxylite.com/end-point/whitelist-account/quota?product_type=0 \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
GET /end-point/whitelist-account/quota
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| team_id | query | ResourceSpaceId | false | нет |
| product_type | query | integer | true | нет |
Примеры ответов
Ответ 200
{
"code": 0,
"msg": "string",
"request_id": "string",
"data": {
"usage": 0,
"limit": 0,
"expand": 0
}
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | Запрос успешен | Inline |
Схема ответа
Status Code 200
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| » code | integer | false | нет | none |
| » msg | string | false | нет | none |
| » request_id | string | false | нет | none |
| » data | object | false | нет | none |
| »» usage | integer | true | нет | none |
| »» limit | integer | true | нет | none |
| »» expand | integer | true | нет | none |
Квоты агентского счета для всех типов продуктов
Примеры кода
# Также можно использовать wget
curl -X GET https://api.proxylite.com/end-point/whitelist-account/quotas \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
GET /end-point/whitelist-account/quotas
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| team_id | query | ResourceSpaceId | false | нет |
Примеры ответов
Ответ 200
{
"code": 0,
"msg": "string",
"request_id": "string",
"data": {
"list": [
{
"product_type": 0,
"limit": 0,
"usage": 0
}
]
}
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | Запрос успешен | Inline |
Схема ответа
Status Code 200
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| » code | integer | false | нет | none |
| » msg | string | false | нет | none |
| » request_id | string | false | нет | none |
| » data | object | false | нет | none |
| »» list | [object] | false | нет | none |
| »»» product_type | integer | false | нет | none |
| »»» limit | integer | false | нет | none |
| »»» usage | integer | false | нет | none |
Список аккаунтов агентов (GET /end-point/proxy-account/list)
Примеры кода
# Также можно использовать wget
curl -X GET https://api.proxylite.com/end-point/proxy-account/list \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
GET /end-point/proxy-account/list
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| team_id | query | ResourceSpaceId | false | Идентификатор ресурсного пространства; опустите личное пространство или передайте пустую строку; Ключ команды можно опустить и он должен соответствовать ключу при передаче. |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "string",
"data": {
"list": [
{
"id": 0,
"username": "string",
"password": "string",
"created_at": "string",
"remark": "string",
"product_type": 9,
"usage_flow": 0,
"limit_flow": 102400,
"status": 0
}
]
}
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | Запрос успешен | Inline |
Схема ответа
Status Code 200
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| » code | responseCode | false | нет | Код состояния, 200 успешно, 3 app_key недействительны |
| » msg | string | false | нет | сообщение о состоянии |
| » data | object | false | нет | none |
| »» list | [object] | false | нет | none |
| »»» id | integer | false | нет | Номер счета |
| »»» username | string | false | нет | Имя учетной записи агента |
| »»» password | string | false | нет | Пароль от учетной записи агента |
| »»» created_at | string | false | нет | Добавить время |
| »»» remark | string | false | нет | Примечания |
| »»» product_type | productTypes | false | нет | Тип пакета, 9 пакетов динамического трафика для жилых помещений, 11 динамических IP для жилых помещений, 14 статических IP-адресов для центров обработки данных, 25 статических IP-адресов для жилых помещений |
| »»» usage_flow | integer | false | нет | Использованный трафик, ед.: КБ |
| »»» limit_flow | integer | false | нет | Настраиваемый лимит трафика: максимальная единица ГБ — 102400, 0 — без ограничений. |
| »»» status | integer | false | нет | Статус «Включено»: 1 включен, 0 отключен. |
Допустимые значения
| Свойство | Значение |
|---|---|
| product_type | 9 |
| product_type | 11 |
| product_type | 14 |
| product_type | 25 |
Добавить аккаунт агента. (POST /end-point/proxy-account/add)
Примеры кода
# Также можно использовать wget
curl -X POST https://api.proxylite.com/end-point/proxy-account/add \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
POST /end-point/proxy-account/add
Body parameter
{
"team_id": "A1b2C3d4E5f6",
"app_key": "stringstringstringstringstringst",
"accounts": "user01:pass,user02:pass,user03:pass",
"remark": "",
"product_type": 9
}
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| body | body | object | false | нет |
| » team_id | body | any | false | Идентификация пространства государственных ресурсов; опустите team_id или передайте пустую строку при запросе личного пространства и пустую строку при ответе на личное пространство; и число 0, и строка «0» незаконны, а в командном пространстве используется 6-12-значный публичный идентификатор команды. |
| »» anonymous | body | string | false | нет |
| »» anonymous | body | TeamPublicId | false | Публичный логотип команды, первый символ — буква ASCII, остальные символы содержат только буквы и цифры ASCII; числовой первичный ключ базы данных не выдан |
| » app_key | body | string | false | Ключ авторизации |
| » accounts | body | string | true | Пароль учетной записи. Введите его в формате имя пользователя:пароль. Учетная запись и пароль поддерживают только цифры и буквы. Запрещено вводить любые специальные символы и пробелы. Двоеточие разделяет учетную запись и пароль. Поддерживается пакетное добавление, а учетные записи агентов разделяются английскими запятыми (,). |
| » remark | body | string | false | Описание аккаунта агента |
| » product_type | body | productTypes | false | Тип пакета, 9 пакетов динамического трафика для жилых помещений, 11 динамических IP для жилых помещений, 14 статических IP-адресов для центров обработки данных, 25 статических IP-адресов для жилых помещений |
Допустимые значения
| Parameter | Value |
|---|---|
| » product_type | 9 |
| » product_type | 11 |
| » product_type | 14 |
| » product_type | 25 |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "string",
"data": null
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | Запрос успешен | Inline |
Схема ответа
Status Code 200
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| » code | integer | false | нет | Код состояния, 200 успешно, 3 app_key недействителен, 156 учетная запись не аутентифицирована. |
| » msg | string | false | нет | сообщение о состоянии |
| » data | null | false | нет | none |
Удалить прокси-аккаунт (POST /end-point/proxy-account/delete)
Примеры кода
# Также можно использовать wget
curl -X POST https://api.proxylite.com/end-point/proxy-account/delete \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
POST /end-point/proxy-account/delete
Обратите внимание, что после удаления его невозможно восстановить, а использованный трафик нельзя запросить. Для удаления потребуется время ожидания примерно 5 минут, в течение которого все еще может взиматься плата.
Body parameter
{
"team_id": "A1b2C3d4E5f6",
"app_key": "stringstringstringstringstringst",
"accounts": "user01,user02"
}
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| body | body | object | false | нет |
| » team_id | body | any | false | Идентификация пространства государственных ресурсов; опустите team_id или передайте пустую строку при запросе личного пространства и пустую строку при ответе на личное пространство; и число 0, и строка «0» незаконны, а в командном пространстве используется 6-12-значный публичный идентификатор команды. |
| »» anonymous | body | string | false | нет |
| »» anonymous | body | TeamPublicId | false | Публичный логотип команды, первый символ — буква ASCII, остальные символы содержат только буквы и цифры ASCII; числовой первичный ключ базы данных не выдан |
| » app_key | body | string | false | Ключ авторизации |
| » accounts | body | string | true | Аккаунт агента, поддерживаются только цифры и буквы. Поддержка пакетных операций, английские запятые (,) для отдельных учетных записей агентов. |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "string",
"data": null
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | Запрос успешен | Inline |
Схема ответа
Status Code 200
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| » code | integer | false | нет | Код состояния, 200 успешно, 3 app_key недействителен, 156 учетная запись не аутентифицирована. |
| » msg | string | false | нет | сообщение о состоянии |
| » data | null | false | нет | none |
Включить прокси-аккаунт (POST /end-point/proxy-account/enable)
Примеры кода
# Также можно использовать wget
curl -X POST https://api.proxylite.com/end-point/proxy-account/enable \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
POST /end-point/proxy-account/enable
Body parameter
{
"team_id": "A1b2C3d4E5f6",
"app_key": "stringstringstringstringstringst",
"accounts": "user01,user02"
}
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| body | body | object | false | нет |
| » team_id | body | any | false | Идентификация пространства государственных ресурсов; опустите team_id или передайте пустую строку при запросе личного пространства и пустую строку при ответе на личное пространство; и число 0, и строка «0» незаконны, а в командном пространстве используется 6-12-значный публичный идентификатор команды. |
| »» anonymous | body | string | false | нет |
| »» anonymous | body | TeamPublicId | false | Публичный логотип команды, первый символ — буква ASCII, остальные символы содержат только буквы и цифры ASCII; числовой первичный ключ базы данных не выдан |
| » app_key | body | string | false | Ключ авторизации |
| » accounts | body | string | true | Аккаунт агента, поддерживаются только цифры и буквы. Поддержка пакетных операций, английские запятые (,) для отдельных учетных записей агентов. |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "string",
"data": null
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | Запрос успешен | Inline |
Схема ответа
Status Code 200
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| » code | integer | false | нет | Код состояния, 200 успешно, 3 app_key недействителен, 156 учетная запись не аутентифицирована. |
| » msg | string | false | нет | сообщение о состоянии |
| » data | null | false | нет | none |
Отключить прокси-аккаунт (POST /end-point/proxy-account/disable)
Примеры кода
# Также можно использовать wget
curl -X POST https://api.proxylite.com/end-point/proxy-account/disable \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
POST /end-point/proxy-account/disable
Для отключения потребуется время ожидания примерно 5 минут, в течение этого времени еще может взиматься плата.
Body parameter
{
"team_id": "A1b2C3d4E5f6",
"app_key": "stringstringstringstringstringst",
"accounts": "user01,user02"
}
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| body | body | object | false | нет |
| » team_id | body | any | false | Идентификация пространства государственных ресурсов; опустите team_id или передайте пустую строку при запросе личного пространства и пустую строку при ответе на личное пространство; и число 0, и строка «0» незаконны, а в командном пространстве используется 6-12-значный публичный идентификатор команды. |
| »» anonymous | body | string | false | нет |
| »» anonymous | body | TeamPublicId | false | Публичный логотип команды, первый символ — буква ASCII, остальные символы содержат только буквы и цифры ASCII; числовой первичный ключ базы данных не выдан |
| » app_key | body | string | false | Ключ авторизации |
| » accounts | body | string | true | Аккаунт агента, поддерживаются только цифры и буквы. Поддержка пакетных операций, английские запятые (,) для отдельных учетных записей агентов. |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "string",
"data": null
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | Запрос успешен | Inline |
Схема ответа
Status Code 200
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| » code | integer | false | нет | Код состояния, 200 успешно, 3 app_key недействителен, 156 учетная запись не аутентифицирована. |
| » msg | string | false | нет | сообщение о состоянии |
| » data | null | false | нет | none |
Изменить информацию об учетной записи агента (POST /end-point/proxy-account/change)
Примеры кода
# Также можно использовать wget
curl -X POST https://api.proxylite.com/end-point/proxy-account/change \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
POST /end-point/proxy-account/change
Измените пароль учетной записи прокси, примечания, лимит трафика, дневной лимит трафика, включенный статус или переключатель UDP.
Body parameter
{
"team_id": "A1b2C3d4E5f6",
"app_key": "string",
"account": "string",
"password": "string",
"remark": "string",
"limit": 0,
"daily_limit": 0,
"status": 0,
"udp": 0
}
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| body | body | object | false | нет |
| » team_id | body | any | false | Идентификация пространства государственных ресурсов; опустите team_id или передайте пустую строку при запросе личного пространства и пустую строку при ответе на личное пространство; и число 0, и строка «0» незаконны, а в командном пространстве используется 6-12-значный публичный идентификатор команды. |
| »» anonymous | body | string | false | нет |
| »» anonymous | body | TeamPublicId | false | Публичный логотип команды, первый символ — буква ASCII, остальные символы содержат только буквы и цифры ASCII; числовой первичный ключ базы данных не выдан |
| » app_key | body | string | false | Ключ авторизации |
| » account | body | string | true | Имя учетной записи агента |
| » password | body | string | false | Новый пароль, 6-16 цифр или букв; если он не передан, он не будет изменен. |
| » remark | body | string | false | Новая заметка |
| » limit | body | integer | false | Лимит трафика, ГБ, 0 означает отсутствие лимита. |
| » daily_limit | body | integer | false | Суточный лимит трафика в ГБ, 0 означает отсутствие лимита. |
| » status | body | integer | false | Статус включен |
| » udp | body | integer | false | Переключатель поддержки UDP, действует только для типов пакетов 14, 16, 21 и 25. |
Допустимые значения
| Parameter | Value |
|---|---|
| » status | 0 |
| » status | 1 |
| » udp | 0 |
| » udp | 1 |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "string",
"data": null
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | Запрос успешен | Inline |
Схема ответа
Status Code 200
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| » code | integer | false | нет | Код состояния, 200 успехов |
| » msg | string | false | нет | сообщение о состоянии |
| » data | null | false | нет | none |
Создать информацию о прокси-соединении
Примеры кода
# Также можно использовать wget
curl -X GET https://api.proxylite.com/end-point/whitelist-account/format?ac=0 \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
GET /end-point/whitelist-account/format
Поддерживает личные и командные ключи API. Возвращаются только учетные записи агентов, имеющие доступ к текущему пространству ресурсов. Поддерживаются типы пакетов 9, 11 и 12. JSON/XML возвращает структурированный список учетных записей; txt/csv возвращает строку подключения, склеенную в формате f.
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| ac | query | integer,string | true | Идентификатор учетной записи агента или имя пользователя; совместимый аккаунт параметров |
| ae | query | string | false | нет |
| st | query | string | false | нет |
| ct | query | string | false | нет |
| lf | query | integer | false | нет |
| n | query | integer | false | нет |
| f | query | integer | false | Влияет только на формат строки подключения txt/csv. |
| type | query | string | false | нет |
| lb | query | string | false | нет |
| ep | query | string | false | нет |
| team_id | query | ResourceSpaceId | false | нет |
Допустимые значения
| Parameter | Value |
|---|---|
| f | 1 |
| f | 2 |
| f | 3 |
| f | 4 |
| f | 5 |
| type | json |
| type | xml |
| type | txt |
| type | csv |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {
"list": [
{
"username": "string",
"password": "string",
"server": "string",
"port": 0
}
]
},
"request_id": "string"
}
"string"
<?xml version="1.0" encoding="UTF-8" ?>
<WebV1SuccessResponse>
<code>200</code>
<msg>SUCCESS</msg>
<data/>
<request_id>string</request_id>
</WebV1SuccessResponse>
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | HTTP успешен; пожалуйста, проверьте бизнес-код, 200 означает успех. | WebV1SuccessResponse |
Управление заказами
Создание заказа, запрос, отмена и т. д.
список заказов
Примеры кода
# Также можно использовать wget
curl -X GET https://api.proxylite.com/end-point/order/list \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
GET /end-point/order/list
Заказы в командном пространстве дополнительно возвращают создателя с указанием фактического члена заказа; администраторы и суперадминистраторы могут видеть полную контактную информацию, а другие роли возвращают менее конфиденциальную контактную информацию.
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| team_id | query | ResourceSpaceId | false | Идентификатор пространства ресурса заказа; личное пространство опустить или передать пустую строку |
| page_no | query | integer | false | нет |
| page_size | query | integer | false | нет |
| trade_no | query | string | false | номер заказа |
| start_time | query | string(date-time) | false | Время начала (включительно), например 2024-01-01 00:00:00. |
| end_time | query | string(date-time) | false | Время окончания (не включено) |
| status | query | integer | false | Статус заказа |
| product_type | query | integer | false | тип продукта |
| invoice | query | integer | false | Статус счета: 0 без ограничений 1 счет выставлен -1 счет не выставлен (может быть перевыставлен) |
| pay_fee_status | query | integer | false | Проверка длинных и коротких платежей: 1 Переплата 2 Недоплата |
Detailed descriptions
status: Статус заказа
| Статус | Описание |
|---|---|
| 0 | Ожидает платежа |
| 1 | Платный |
| 2 | Отменено из-за сверхурочной работы и неуплаты |
| 3 | Возвращен |
product_type: тип продукта
| Тип продукта | Описание |
|---|---|
| 3 | Пополнение баланса |
| 9 | Пакет динамического трафика |
| 11 | Пакет динамического глобального времени V2 |
| 12 | Долгосрочный пакет трафика IDC |
| 13 | Пакет статического IP-трафика для жилых помещений |
| 14 | Пакет статического IP для центра обработки данных |
| 15 | Долгосрочный пакет трафика интернет-провайдера |
| 16 | Статический пакет трафика |
| 17 | Пакет динамического IP-адреса |
| 18 | веб-скребок |
| 19 | Продление статического IP-адреса |
| 20 | Квота на замену статических IP |
| 21 | Пакет статического трафика v2 |
| 24 | Дополнительный пакет статического трафика |
| 25 | Пакет статического IP для жилых помещений |
| 26 | Заказ на замену. Некоторые каналы оплаты требуют, чтобы пользователи вручную вводили сумму, например виртуальную валюту. Если произошла задержка платежа, вам необходимо связаться со службой поддержки клиентов, чтобы произвести погашение с помощью этого продукта |
| 27 | Серп |
| 28 | Видео |
Допустимые значения
| Parameter | Value |
|---|---|
| status | 0 |
| status | 1 |
| status | 2 |
| status | 3 |
| product_type | 3 |
| product_type | 9 |
| product_type | 11 |
| product_type | 12 |
| product_type | 14 |
| product_type | 16 |
| product_type | 17 |
| product_type | 18 |
| product_type | 19 |
| product_type | 21 |
| product_type | 24 |
| product_type | 25 |
| product_type | 26 |
| product_type | 27 |
| product_type | 28 |
| invoice | -1 |
| invoice | 0 |
| invoice | 1 |
| pay_fee_status | 1 |
| pay_fee_status | 2 |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {
"list": [
{
"id": 0,
"trade_no": "string",
"out_trade_no": "string",
"product_id": 0,
"product_type": 0,
"amount": 0,
"unit_price": 0.1,
"total_fee": 0.1,
"goods_fee": 0.1,
"pay_fee": 0.1,
"discount_fee": 0.1,
"handling_fee": 0.1,
"refund_fee": 0.1,
"pm_id": 0,
"pm_title": "string",
"pm_logo": "string",
"status": 0,
"title": "string",
"detail": "string",
"region_desc": "string",
"pay_at": "2019-08-24T14:15:22Z",
"pay_timestamp": 0,
"created_at": "2019-08-24T14:15:22Z",
"pay_fee_status": 0,
"invoice": {
"name": "string",
"org_name": "string",
"first_name": "string",
"last_name": "string",
"phone": "string",
"email": "[email protected]",
"role_type": 0,
"vat_id": "string",
"address_country": "string",
"address_city": "string",
"address_line1": "string",
"address_line2": "string",
"address_postal_code": "string"
}
}
],
"pagination": {
"total": 0,
"page_no": 0,
"page_size": 0,
"total_pages": 0
}
},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | успех | Inline |
Схема ответа
Создать заказ
Примеры кода
# Также можно использовать wget
curl -X POST https://api.proxylite.com/end-point/order/create \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
POST /end-point/order/create
Поскольку существует множество типов пакетов и каждый пакет имеет разные конфигурации, пожалуйста, заполните параметры в соответствии с реальной ситуацией. Неправильное заполнение параметров может привести к сбою создания заказа.
примеры:
Обновить статический IP-адрес
{
"pid": идентификатор пакета, // полученный из интерфейса /openapi/product
"upids": "1,2,3,4,5,6", // Получаем соответствующее поле идентификатора из интерфейса /openapi/ip/get-static-ip
"pm_id": 1 // Получено из интерфейса /openapi/Payment/list или /openapi/Payment/groups.
}
Покупка статического жилого IP
{
"pid": идентификатор пакета, // полученный из интерфейса /openapi/product
"pm_id": идентификатор метода оплаты, // полученный из интерфейса /openapi/pay/list или /openapi/pay/groups
"region_list": "JP,15,333|DE,10,444|US,5,555" // Формат: регион, количество, ASN|регион, количество, ASN (номер ASN необязателен)
}
Покупка статического IP-адреса дата-центра
{
"pid": идентификатор пакета, // полученный из интерфейса /openapi/product
"pm_id": идентификатор метода оплаты, // полученный из интерфейса /openapi/pay/list или /openapi/pay/groups
"region_list": "JP,15,333|DE,10,444|US,5,555" // Формат: регион, количество, ASN|регион, количество, ASN (номер ASN необязателен)
}
Динамическая покупка жилого трафика
{
"pid": идентификатор пакета, // полученный из интерфейса /openapi/product
«pm_id»: идентификатор метода оплаты // Получен из интерфейса /openapi/pay/list или /openapi/pay/groups.
}
Покупка статического ротационного трафика
{
"pid": идентификатор пакета, // полученный из интерфейса /openapi/product
«pm_id»: идентификатор метода оплаты // Получен из интерфейса /openapi/pay/list или /openapi/pay/groups.
}
Динамическая покупка безлимитного трафика
{
"pid": идентификатор пакета, // полученный из интерфейса /openapi/product
"pm_id": идентификатор метода оплаты, // полученный из интерфейса /openapi/pay/list или /openapi/pay/groups
«product_sku_bandwidth_id»: идентификатор спецификации пропускной способности,
«product_sku_concurrency_id»: идентификатор спецификации параллелизма.
}
Пополнение баланса
{
"pid": идентификатор пакета, // полученный из интерфейса /openapi/product
"pm_id": идентификатор метода оплаты, // полученный из интерфейса /openapi/pay/list или /openapi/pay/groups
"recharge_amount": сумма пополнения
}
Body parameter
{
"team_id": "A1b2C3d4E5f6",
"pid": 0,
"upids": "string",
"amount": 0,
"pm_id": 0,
"region_list": "string",
"coupon_sn": "string",
"use_invitation_registration_discount": true,
"renew_duration": 0,
"product_sku_bandwidth_id": 0,
"product_sku_concurrency_id": 0,
"product_sku_duration_id": 0,
"etd": 1,
"recharge_amount": 0
}
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| body | body | object | true | нет |
| » team_id | body | any | false | Идентификация пространства государственных ресурсов; опустите team_id или передайте пустую строку при запросе личного пространства и пустую строку при ответе на личное пространство; и число 0, и строка «0» незаконны, а в командном пространстве используется 6-12-значный публичный идентификатор команды. |
| »» anonymous | body | string | false | нет |
| »» anonymous | body | TeamPublicId | false | Публичный логотип команды, первый символ — буква ASCII, остальные символы содержат только буквы и цифры ASCII; числовой первичный ключ базы данных не выдан |
| » pid | body | integer | true | Идентификатор пакета из поля id, возвращаемого интерфейсом /openapi/product. |
| » upids | body | string | false | Список идентификаторов пакетов продления (через запятую) из поля id, возвращаемого интерфейсом /openapi/user-product/list или /openapi/ip/get-static-ip. |
| » amount | body | number | false | Количество приобретенных новых пакетов |
| » pm_id | body | integer | true | Идентификатор способа оплаты из поля id, возвращаемого интерфейсом /openapi/Payment/list или /openapi/Payment/groups. |
| » region_list | body | string | false | При покупке статического IP укажите регион+количество+номер ASN. Формат: регион, количество, ASN |
| » coupon_sn | body | string | false | Номер купона |
| » use_invitation_registration_discount | body | boolean | false | Использовать ли скидку на регистрацию приглашения |
| » renew_duration | body | integer | false | Обновление статического IP-адреса необязательно. |
| » product_sku_bandwidth_id | body | integer | false | Пакет 11: Идентификатор пакета пропускной способности |
| » product_sku_concurrency_id | body | integer | false | Пакет 11: Идентификатор одновременного пакета |
| » product_sku_duration_id | body | integer | false | Тип пакета=11Обязательно: идентификатор спецификации продолжительности |
| » etd | body | integer | false | Кратность продолжительности, полученная из пакета Extension_of_time_days, 2 представляет количество дней × 2, цена увеличится. |
| » recharge_amount | body | integer | false | Пакет 3: Сумма пополнения |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {
"id": 0,
"trade_no": "string",
"out_trade_no": "string",
"product_id": 0,
"product_type": 0,
"amount": 0,
"unit_price": 0.1,
"total_fee": 0.1,
"goods_fee": 0.1,
"pay_fee": 0.1,
"discount_fee": 0.1,
"handling_fee": 0.1,
"refund_fee": 0.1,
"pm_id": 0,
"pm_title": "string",
"pm_logo": "string",
"status": 0,
"title": "string",
"detail": "string",
"region_desc": "string",
"pay_at": "2019-08-24T14:15:22Z",
"pay_timestamp": 0,
"created_at": "2019-08-24T14:15:22Z",
"pay_fee_status": 0,
"invoice": {
"name": "string",
"org_name": "string",
"first_name": "string",
"last_name": "string",
"phone": "string",
"email": "[email protected]",
"role_type": 0,
"vat_id": "string",
"address_country": "string",
"address_city": "string",
"address_line1": "string",
"address_line2": "string",
"address_postal_code": "string"
}
},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | Создано успешно | Inline |
Схема ответа
Отменить заказ
Примеры кода
# Также можно использовать wget
curl -X POST https://api.proxylite.com/end-point/order/close \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
POST /end-point/order/close
Body parameter
{
"team_id": "A1b2C3d4E5f6",
"trade_no": "string"
}
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| body | body | object | true | нет |
| » team_id | body | any | false | Идентификация пространства государственных ресурсов; опустите team_id или передайте пустую строку при запросе личного пространства и пустую строку при ответе на личное пространство; и число 0, и строка «0» незаконны, а в командном пространстве используется 6-12-значный публичный идентификатор команды. |
| »» anonymous | body | string | false | нет |
| »» anonymous | body | TeamPublicId | false | Публичный логотип команды, первый символ — буква ASCII, остальные символы содержат только буквы и цифры ASCII; числовой первичный ключ базы данных не выдан |
| » trade_no | body | string | true | нет |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | Операция прошла успешно | WebV1SuccessResponse |
Детали заказа
Примеры кода
# Также можно использовать wget
curl -X GET https://api.proxylite.com/end-point/order/info?trade_no=string \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
GET /end-point/order/info
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| team_id | query | ResourceSpaceId | false | нет |
| trade_no | query | string | true | нет |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {
"id": 0,
"trade_no": "string",
"out_trade_no": "string",
"product_id": 0,
"product_type": 0,
"amount": 0,
"unit_price": 0.1,
"total_fee": 0.1,
"goods_fee": 0.1,
"pay_fee": 0.1,
"discount_fee": 0.1,
"handling_fee": 0.1,
"refund_fee": 0.1,
"pm_id": 0,
"pm_title": "string",
"pm_logo": "string",
"status": 0,
"title": "string",
"detail": "string",
"region_desc": "string",
"pay_at": "2019-08-24T14:15:22Z",
"pay_timestamp": 0,
"created_at": "2019-08-24T14:15:22Z",
"pay_fee_status": 0,
"invoice": {
"name": "string",
"org_name": "string",
"first_name": "string",
"last_name": "string",
"phone": "string",
"email": "[email protected]",
"role_type": 0,
"vat_id": "string",
"address_country": "string",
"address_city": "string",
"address_line1": "string",
"address_line2": "string",
"address_postal_code": "string"
}
},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | HTTP успешен; пожалуйста, продолжайте оценивать код тела ответа | Inline |
Схема ответа
Детали заказа V2
Примеры кода
# Также можно использовать wget
curl -X GET https://api.proxylite.com/end-point/order/info-v2?order_id=string \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
GET /end-point/order/info-v2
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| team_id | query | ResourceSpaceId | false | нет |
| order_id | query | string | true | Зашифрованный идентификатор заказа на стороне клиента |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {
"id": 0,
"trade_no": "string",
"out_trade_no": "string",
"product_id": 0,
"product_type": 0,
"amount": 0,
"unit_price": 0.1,
"total_fee": 0.1,
"goods_fee": 0.1,
"pay_fee": 0.1,
"discount_fee": 0.1,
"handling_fee": 0.1,
"refund_fee": 0.1,
"pm_id": 0,
"pm_title": "string",
"pm_logo": "string",
"status": 0,
"title": "string",
"detail": "string",
"region_desc": "string",
"pay_at": "2019-08-24T14:15:22Z",
"pay_timestamp": 0,
"created_at": "2019-08-24T14:15:22Z",
"pay_fee_status": 0,
"invoice": {
"name": "string",
"org_name": "string",
"first_name": "string",
"last_name": "string",
"phone": "string",
"email": "[email protected]",
"role_type": 0,
"vat_id": "string",
"address_country": "string",
"address_city": "string",
"address_line1": "string",
"address_line2": "string",
"address_postal_code": "string"
}
},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | HTTP-успех; когда заказ оплачен или отменен, данные заказа могут содержать код бизнес-ошибки. | Inline |
Схема ответа
Повторное выставление счета для исторических заказов
Примеры кода
# Также можно использовать wget
curl -X POST https://api.proxylite.com/end-point/order/reissue-invoice \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
POST /end-point/order/reissue-invoice
Body parameter
{
"team_id": "A1b2C3d4E5f6",
"trade_no_list": [
"string"
]
}
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| body | body | object | true | нет |
| » team_id | body | any | false | Идентификация пространства государственных ресурсов; опустите team_id или передайте пустую строку при запросе личного пространства и пустую строку при ответе на личное пространство; и число 0, и строка «0» незаконны, а в командном пространстве используется 6-12-значный публичный идентификатор команды. |
| »» anonymous | body | string | false | нет |
| »» anonymous | body | TeamPublicId | false | Публичный логотип команды, первый символ — буква ASCII, остальные символы содержат только буквы и цифры ASCII; числовой первичный ключ базы данных не выдан |
| » trade_no_list | body | [string] | true | нет |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | Операция прошла успешно | WebV1SuccessResponse |
Заказать предварительную проверку
Примеры кода
# Также можно использовать wget
curl -X POST https://api.proxylite.com/end-point/order/check \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
POST /end-point/order/check
Вызывается перед созданием заказа и используется для предварительного просмотра цен, скидок, сведений о продлении IP-адреса и т. д. Фактически заказ не будет создан. Параметры точно такие же, как у /openapi/order/create.
Body parameter
{
"team_id": "A1b2C3d4E5f6",
"pid": 0,
"upids": "string",
"amount": 1,
"pm_id": 0,
"region_list": "string",
"coupon_sn": "string",
"renew_duration": "1m",
"product_sku_bandwidth_id": 0,
"product_sku_concurrency_id": 0,
"product_sku_duration_id": 0,
"etd": 1,
"recharge_amount": 0
}
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| body | body | object | true | нет |
| » team_id | body | any | false | Идентификация пространства государственных ресурсов; опустите team_id или передайте пустую строку при запросе личного пространства и пустую строку при ответе на личное пространство; и число 0, и строка «0» незаконны, а в командном пространстве используется 6-12-значный публичный идентификатор команды. |
| »» anonymous | body | string | false | нет |
| »» anonymous | body | TeamPublicId | false | Публичный логотип команды, первый символ — буква ASCII, остальные символы содержат только буквы и цифры ASCII; числовой первичный ключ базы данных не выдан |
| » pid | body | integer | true | Идентификатор пакета |
| » upids | body | string | false | Продление IP: список идентификаторов пользовательских пакетов, разделенных запятыми. |
| » amount | body | integer | false | Количество покупки |
| » pm_id | body | integer | true | Идентификатор способа оплаты |
| » region_list | body | string | false | Статический IP-регион покупки + количество, формат: ID региона, количество |
| » coupon_sn | body | string | false | Номер купона |
| » renew_duration | body | string | false | Период продления IP: 1м=1 месяц, 2м=2 месяца, em=конец следующего месяца |
| » product_sku_bandwidth_id | body | integer | false | Тип пакета=11Обязательно: идентификатор спецификации пропускной способности |
| » product_sku_concurrency_id | body | integer | false | Тип пакета=11Обязательно: идентификатор спецификации параллелизма. |
| » product_sku_duration_id | body | integer | false | Тип пакета=11Обязательно: идентификатор спецификации продолжительности |
| » etd | body | integer | false | Длительность кратна, получена из пакета Extension_of_time_days |
| » recharge_amount | body | number | false | Тип пакета=3Обязательно: сумма пополнения |
Допустимые значения
| Parameter | Value |
|---|---|
| » renew_duration | 1m |
| » renew_duration | 2m |
| » renew_duration | em |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {
"product_id": 0,
"amount": 0,
"discount_fee": 0.1,
"total_fee": 0.1,
"pay_fee": 0.1,
"product_type": 0,
"title": "string",
"detail": "string",
"ip_result": [
{
"ip": "string",
"price": 0.1,
"country_code": "string",
"current_time": "2019-08-24T14:15:22Z",
"renewal_time": "2019-08-24T14:15:22Z",
"country": {
"name_zh_cn": "string",
"flag": "string",
"square_flag": "string"
}
}
]
},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | Предполетная подготовка прошла успешно | Inline |
Схема ответа
Управление ключами API
Управление ключами API для личных и групповых ресурсов
Список ключей API
Примеры кода
# Также можно использовать wget
curl -X GET https://api.proxylite.com/end-point/api-keys \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
GET /end-point/api-keys
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| team_id | query | ResourceSpaceId | false | Идентификатор ресурсного пространства; личное пространство опустить или передать пустую строку |
| page | query | integer | false | нет |
| pageSize | query | integer | false | нет |
Примеры ответов
Ответ 200
{
"code": 0,
"msg": "string",
"request_id": "string",
"data": {
"list": [
{
"id": 1,
"api_key": "string",
"team_user_id": 0,
"remark": "string",
"status": 0,
"created_at": "string",
"updated_at": "string"
}
],
"total": 0,
"page": 1,
"pageSize": 1
}
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | HTTP успешен; пожалуйста, продолжайте оценивать код тела ответа | Inline |
Схема ответа
Status Code 200
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| » code | integer | true | нет | none |
| » msg | string | true | нет | none |
| » request_id | string | true | нет | none |
| » data | object | true | нет | none |
| »» list | [UserApiKeyMetadata] | true | нет | none |
| »»» id | integer | true | нет | API Key ID |
| »»» api_key | string | true | нет | Ответ создания – это полный Ключ; список команд — это замаскированное значение |
| »»» team_user_id | integer | true | нет | Ключ группы фактически содержит идентификатор участника, а личный ключ равен 0. |
| »»» remark | string | true | нет | Примечания |
| »»» status | integer | true | нет | 0=отключить, 1=включить |
| »»» created_at | string | true | нет | время создания |
| »»» updated_at | string,null | false | нет | Время обновления |
| »» total | integer | true | нет | none |
| »» page | integer | true | нет | none |
| »» pageSize | integer | true | нет | none |
Допустимые значения
| Свойство | Значение |
|---|---|
| status | 0 |
| status | 1 |
Создать ключ API
Примеры кода
# Также можно использовать wget
curl -X POST https://api.proxylite.com/end-point/api-keys/create \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
POST /end-point/api-keys/create
Body parameter
{
"team_id": "A1b2C3d4E5f6",
"remark": "string"
}
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| body | body | object | true | нет |
| » team_id | body | any | false | Идентификация пространства государственных ресурсов; опустите team_id или передайте пустую строку при запросе личного пространства и пустую строку при ответе на личное пространство; и число 0, и строка «0» незаконны, а в командном пространстве используется 6-12-значный публичный идентификатор команды. |
| »» anonymous | body | string | false | нет |
| »» anonymous | body | TeamPublicId | false | Публичный логотип команды, первый символ — буква ASCII, остальные символы содержат только буквы и цифры ASCII; числовой первичный ключ базы данных не выдан |
| » remark | body | string | false | нет |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {
"id": 1,
"api_key": "string",
"team_user_id": 0,
"remark": "string",
"status": 0,
"created_at": "string",
"updated_at": "string"
},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | Верните полный ключ API, когда бизнес будет успешным, только на этот раз | Inline |
Схема ответа
Допустимые значения
| Свойство | Значение |
|---|---|
| status | 0 |
| status | 1 |
Включить ключ API
Примеры кода
# Также можно использовать wget
curl -X POST https://api.proxylite.com/end-point/api-keys/enable \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
POST /end-point/api-keys/enable
Body parameter
{
"team_id": "A1b2C3d4E5f6",
"id": 1
}
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| body | body | object | true | нет |
| » team_id | body | any | false | Идентификация пространства государственных ресурсов; опустите team_id или передайте пустую строку при запросе личного пространства и пустую строку при ответе на личное пространство; и число 0, и строка «0» незаконны, а в командном пространстве используется 6-12-значный публичный идентификатор команды. |
| »» anonymous | body | string | false | нет |
| »» anonymous | body | TeamPublicId | false | Публичный логотип команды, первый символ — буква ASCII, остальные символы содержат только буквы и цифры ASCII; числовой первичный ключ базы данных не выдан |
| » id | body | integer | true | API Key ID |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | Операция прошла успешно | WebV1SuccessResponse |
Деактивировать ключ API
Примеры кода
# Также можно использовать wget
curl -X POST https://api.proxylite.com/end-point/api-keys/disable \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
POST /end-point/api-keys/disable
Body parameter
{
"team_id": "A1b2C3d4E5f6",
"id": 1
}
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| body | body | object | true | нет |
| » team_id | body | any | false | Идентификация пространства государственных ресурсов; опустите team_id или передайте пустую строку при запросе личного пространства и пустую строку при ответе на личное пространство; и число 0, и строка «0» незаконны, а в командном пространстве используется 6-12-значный публичный идентификатор команды. |
| »» anonymous | body | string | false | нет |
| »» anonymous | body | TeamPublicId | false | Публичный логотип команды, первый символ — буква ASCII, остальные символы содержат только буквы и цифры ASCII; числовой первичный ключ базы данных не выдан |
| » id | body | integer | true | API Key ID |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | Операция прошла успешно | WebV1SuccessResponse |
Удалить ключ API
Примеры кода
# Также можно использовать wget
curl -X POST https://api.proxylite.com/end-point/api-keys/delete \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
POST /end-point/api-keys/delete
Body parameter
{
"team_id": "A1b2C3d4E5f6",
"id": 1
}
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| body | body | object | true | нет |
| » team_id | body | any | false | Идентификация пространства государственных ресурсов; опустите team_id или передайте пустую строку при запросе личного пространства и пустую строку при ответе на личное пространство; и число 0, и строка «0» незаконны, а в командном пространстве используется 6-12-значный публичный идентификатор команды. |
| »» anonymous | body | string | false | нет |
| »» anonymous | body | TeamPublicId | false | Публичный логотип команды, первый символ — буква ASCII, остальные символы содержат только буквы и цифры ASCII; числовой первичный ключ базы данных не выдан |
| » id | body | integer | true | API Key ID |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | Операция прошла успешно | WebV1SuccessResponse |
Изменить примечания к ключу API
Примеры кода
# Также можно использовать wget
curl -X POST https://api.proxylite.com/end-point/api-keys/update-remark \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
POST /end-point/api-keys/update-remark
Body parameter
{
"team_id": "A1b2C3d4E5f6",
"id": 1,
"remark": "string"
}
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| body | body | object | true | нет |
| » team_id | body | any | false | Идентификация пространства государственных ресурсов; опустите team_id или передайте пустую строку при запросе личного пространства и пустую строку при ответе на личное пространство; и число 0, и строка «0» незаконны, а в командном пространстве используется 6-12-значный публичный идентификатор команды. |
| »» anonymous | body | string | false | нет |
| »» anonymous | body | TeamPublicId | false | Публичный логотип команды, первый символ — буква ASCII, остальные символы содержат только буквы и цифры ASCII; числовой первичный ключ базы данных не выдан |
| » id | body | integer | true | нет |
| » remark | body | string | true | нет |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | Операция прошла успешно | WebV1SuccessResponse |
Ежемесячный счет за продление
Выставление счетов в режиме реального времени, предварительная проверка, размещение заказов и история ежемесячных совокупных продлений
Текущий ежемесячный сводный счет за продление
Примеры кода
# Также можно использовать wget
curl -X GET https://api.proxylite.com/end-point/monthly-renewal-bill \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
GET /end-point/monthly-renewal-bill
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| team_id | query | ResourceSpaceId | false | нет |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {
"batch": {
"type": "current",
"start_at": "string",
"end_at": "string",
"target_expired_at": "string",
"timezone": "string"
},
"currency": "string",
"total_fee": 0,
"items": [
{
"id": 0,
"user_product_id": 1,
"product_id": 1,
"product_type": 0,
"parent_product_type": 0,
"title": "string",
"expired_at": "string",
"target_expired_at": "string",
"renew_days": 1,
"unit_month_price": 0,
"pay_fee": 0,
"currency": "string",
"bandwidth": 0,
"bandwidth_mbsp": 0,
"concurrency": 0,
"ip": "string",
"country_code": "string",
"paid_at": "string",
"refunded_at": "string",
"created_at": "string",
"updated_at": "string"
}
]
},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | Запрос успешен | Inline |
Схема ответа
Допустимые значения
| Свойство | Значение |
|---|---|
| type | current |
| type | next |
Проверка ежемесячных сводных заказов на продление
Примеры кода
# Также можно использовать wget
curl -X POST https://api.proxylite.com/end-point/monthly-renewal-bill/check \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
POST /end-point/monthly-renewal-bill/check
Body parameter
{
"team_id": "A1b2C3d4E5f6",
"user_product_ids": [
1
],
"user_coupon_id": 1,
"coupon_sn": "string"
}
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| body | body | MonthlyRenewalRequest | true | нет |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {
"batch": {
"type": "current",
"start_at": "string",
"end_at": "string",
"target_expired_at": "string",
"timezone": "string"
},
"currency": "string",
"total_fee": 0,
"discount_fee": 0,
"pay_fee": 0,
"items": [
{
"id": 0,
"user_product_id": 1,
"product_id": 1,
"product_type": 0,
"parent_product_type": 0,
"title": "string",
"expired_at": "string",
"target_expired_at": "string",
"renew_days": 1,
"unit_month_price": 0,
"pay_fee": 0,
"currency": "string",
"bandwidth": 0,
"bandwidth_mbsp": 0,
"concurrency": 0,
"ip": "string",
"country_code": "string",
"paid_at": "string",
"refunded_at": "string",
"created_at": "string",
"updated_at": "string"
}
],
"user_coupon_id": 0
},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | Запрос успешен | Inline |
Схема ответа
Допустимые значения
| Свойство | Значение |
|---|---|
| type | current |
| type | next |
Создайте ежемесячный сводный заказ на продление
Примеры кода
# Также можно использовать wget
curl -X POST https://api.proxylite.com/end-point/monthly-renewal-bill/create \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
POST /end-point/monthly-renewal-bill/create
Body parameter
{
"team_id": "A1b2C3d4E5f6",
"user_product_ids": [
1
],
"user_coupon_id": 1,
"coupon_sn": "string"
}
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| body | body | MonthlyRenewalRequest | true | нет |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {
"trade_no": "string",
"total_fee": 0,
"discount_fee": 0,
"pay_fee": 0,
"currency": "string",
"user_coupon_id": 0
},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | Запрос успешен | Inline |
Схема ответа
Ежемесячная сводка счетов за историю продления
Примеры кода
# Также можно использовать wget
curl -X GET https://api.proxylite.com/end-point/monthly-renewal-bill/history \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
GET /end-point/monthly-renewal-bill/history
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| team_id | query | ResourceSpaceId | false | нет |
| trade_no | query | string | false | нет |
| start_date | query | string(date) | false | нет |
| end_date | query | string(date) | false | нет |
| page | query | integer | false | нет |
| size | query | integer | false | нет |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {
"total": 0,
"page": 1,
"size": 1,
"list": [
{
"id": 1,
"trade_no": "string",
"status": 0,
"pay_fee": 0,
"currency": "string",
"pay_at": "string",
"created_at": "string",
"pay_method": 0,
"pm_id": 0,
"pay_channel": 0,
"pm_title": "string",
"pm_logo": "string",
"items": [
{
"id": 0,
"user_product_id": 1,
"product_id": 1,
"product_type": 0,
"parent_product_type": 0,
"title": "string",
"expired_at": "string",
"target_expired_at": "string",
"renew_days": 1,
"unit_month_price": 0,
"pay_fee": 0,
"currency": "string",
"bandwidth": 0,
"bandwidth_mbsp": 0,
"concurrency": 0,
"ip": "string",
"country_code": "string",
"paid_at": "string",
"refunded_at": "string",
"created_at": "string",
"updated_at": "string"
}
]
}
]
},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | Запрос успешен | Inline |
Схема ответа
Управление счетами
Заголовок счета, приложение для выставления счета и заказы, подлежащие выставлению счетов
Детали заголовка счета-фактуры
Примеры кода
# Также можно использовать wget
curl -X GET https://api.proxylite.com/end-point/user-invoice/info \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
GET /end-point/user-invoice/info
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| team_id | query | ResourceSpaceId | false | нет |
| invoice_code | query | string | false | нет |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {
"invoice_code": "string",
"name": "string",
"org_name": "string",
"first_name": "string",
"last_name": "string",
"phone": "string",
"email": "[email protected]",
"role_type": 1,
"invoice_type": 0,
"vat_id": "string",
"tax_no": "string",
"address_country": "string",
"address_city": "string",
"address_line1": "string",
"address_line2": "string",
"address_postal_code": "string",
"bank_name": "string",
"bank_account": "string",
"is_def": true
},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | HTTP успешен; пожалуйста, продолжайте оценивать код тела ответа | Inline |
Схема ответа
Допустимые значения
| Свойство | Значение |
|---|---|
| role_type | 1 |
| role_type | 2 |
| invoice_type | 0 |
| invoice_type | 1 |
| invoice_type | 2 |
Создать или изменить заголовок счета-фактуры
Примеры кода
# Также можно использовать wget
curl -X POST https://api.proxylite.com/end-point/user-invoice/create \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
POST /end-point/user-invoice/create
Body parameter
{
"invoice_code": "string",
"name": "string",
"org_name": "string",
"first_name": "string",
"last_name": "string",
"phone": "string",
"email": "[email protected]",
"role_type": 1,
"invoice_type": 0,
"vat_id": "string",
"tax_no": "string",
"address_country": "string",
"address_city": "string",
"address_line1": "string",
"address_line2": "string",
"address_postal_code": "string",
"bank_name": "string",
"bank_account": "string",
"is_def": true,
"team_id": "A1b2C3d4E5f6",
"new_invoice_code": false
}
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| body | body | any | true | нет |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": null,
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | Запрос успешен, данные пустые | Inline |
Схема ответа
Список заголовков счетов-фактур
Примеры кода
# Также можно использовать wget
curl -X GET https://api.proxylite.com/end-point/user-invoice/list \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
GET /end-point/user-invoice/list
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| team_id | query | ResourceSpaceId | false | нет |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {
"list": [
{
"invoice_code": "string",
"name": "string",
"org_name": "string",
"first_name": "string",
"last_name": "string",
"phone": "string",
"email": "[email protected]",
"role_type": 1,
"invoice_type": 0,
"vat_id": "string",
"tax_no": "string",
"address_country": "string",
"address_city": "string",
"address_line1": "string",
"address_line2": "string",
"address_postal_code": "string",
"bank_name": "string",
"bank_account": "string",
"is_def": true,
"created_at": 0
}
]
},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | Запрос успешен | Inline |
Схема ответа
Допустимые значения
| Свойство | Значение |
|---|---|
| role_type | 1 |
| role_type | 2 |
| invoice_type | 0 |
| invoice_type | 1 |
| invoice_type | 2 |
Удалить заголовок счета-фактуры
Примеры кода
# Также можно использовать wget
curl -X POST https://api.proxylite.com/end-point/user-invoice/delete \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
POST /end-point/user-invoice/delete
Body parameter
{
"team_id": "A1b2C3d4E5f6",
"invoice_code": "string"
}
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| body | body | object | true | нет |
| » team_id | body | any | false | Идентификация пространства государственных ресурсов; опустите team_id или передайте пустую строку при запросе личного пространства и пустую строку при ответе на личное пространство; и число 0, и строка «0» незаконны, а в командном пространстве используется 6-12-значный публичный идентификатор команды. |
| »» anonymous | body | string | false | нет |
| »» anonymous | body | TeamPublicId | false | Публичный логотип команды, первый символ — буква ASCII, остальные символы содержат только буквы и цифры ASCII; числовой первичный ключ базы данных не выдан |
| » invoice_code | body | string | true | нет |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": null,
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | Запрос успешен, данные пустые | Inline |
Схема ответа
Список записей для выставления счетов
Примеры кода
# Также можно использовать wget
curl -X GET https://api.proxylite.com/end-point/user-invoice/record-list \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
GET /end-point/user-invoice/record-list
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| team_id | query | ResourceSpaceId | false | нет |
| status | query | integer | false | нет |
Допустимые значения
| Parameter | Value |
|---|---|
| status | 0 |
| status | 1 |
| status | 2 |
| status | 3 |
| status | 4 |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {
"list": [
{
"id": 1,
"invoice_no": "string",
"invoice_amount": 0,
"invoice_download_url": "string",
"status": 0,
"remark": "string",
"order_ids": [
0
],
"created_at": 0,
"invoice_info": {
"invoice_code": "string",
"name": "string",
"org_name": "string",
"role_type": 1,
"invoice_type": 0
}
}
]
},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | Запрос успешен | Inline |
Схема ответа
Допустимые значения
| Свойство | Значение |
|---|---|
| role_type | 1 |
| role_type | 2 |
| invoice_type | 0 |
| invoice_type | 1 |
| invoice_type | 2 |
Подать заявку на выставление счета
Примеры кода
# Также можно использовать wget
curl -X POST https://api.proxylite.com/end-point/user-invoice/submit \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
POST /end-point/user-invoice/submit
Body parameter
{
"team_id": "A1b2C3d4E5f6",
"invoice_code": "string",
"order_ids": [
0
]
}
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| body | body | object | true | нет |
| » team_id | body | any | false | Идентификация пространства государственных ресурсов; опустите team_id или передайте пустую строку при запросе личного пространства и пустую строку при ответе на личное пространство; и число 0, и строка «0» незаконны, а в командном пространстве используется 6-12-значный публичный идентификатор команды. |
| »» anonymous | body | string | false | нет |
| »» anonymous | body | TeamPublicId | false | Публичный логотип команды, первый символ — буква ASCII, остальные символы содержат только буквы и цифры ASCII; числовой первичный ключ базы данных не выдан |
| » invoice_code | body | string | true | нет |
| » order_ids | body | [integer] | true | нет |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {
"invoice_id": 1
},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | Запрос успешен | Inline |
Схема ответа
Отменить заявку на выставление счета
Примеры кода
# Также можно использовать wget
curl -X POST https://api.proxylite.com/end-point/user-invoice/cancel \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
POST /end-point/user-invoice/cancel
Body parameter
{
"team_id": "A1b2C3d4E5f6",
"invoice_id": 1,
"reason": "string"
}
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| body | body | object | true | нет |
| » team_id | body | any | false | Идентификация пространства государственных ресурсов; опустите team_id или передайте пустую строку при запросе личного пространства и пустую строку при ответе на личное пространство; и число 0, и строка «0» незаконны, а в командном пространстве используется 6-12-значный публичный идентификатор команды. |
| »» anonymous | body | string | false | нет |
| »» anonymous | body | TeamPublicId | false | Публичный логотип команды, первый символ — буква ASCII, остальные символы содержат только буквы и цифры ASCII; числовой первичный ключ базы данных не выдан |
| » invoice_id | body | integer | true | нет |
| » reason | body | string | false | нет |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": null,
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | Запрос успешен, данные пустые | Inline |
Схема ответа
Статистика суммы счета
Примеры кода
# Также можно использовать wget
curl -X GET https://api.proxylite.com/end-point/user-invoice/statistics \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
GET /end-point/user-invoice/statistics
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| team_id | query | ResourceSpaceId | false | нет |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {
"invoiceable_amount": 0,
"invoiced_amount": 0,
"processing_amount": 0
},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | Запрос успешен | Inline |
Схема ответа
Список заказов, по которым можно выставить счет
Примеры кода
# Также можно использовать wget
curl -X GET https://api.proxylite.com/end-point/user-invoice/invoiceable-orders \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
GET /end-point/user-invoice/invoiceable-orders
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| team_id | query | ResourceSpaceId | false | нет |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {
"list": [
{
"id": 1,
"order_no": "string",
"pay_fee": 0,
"created_at": 0
}
]
},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | Запрос успешен | Inline |
Схема ответа
Управление командой
Создание команды, запрос, изменение названия и расформирование
Создать команду
Примеры кода
# Также можно использовать wget
curl -X POST https://api.proxylite.com/end-point/team/create \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
POST /end-point/team/create
Body parameter
{
"name": "string"
}
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| body | body | object | true | нет |
| » name | body | string | true | Название команды |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {
"id": "A1b2C3d4E5f6",
"name": "string",
"super_admin_user_id": 1,
"status": 0,
"current_role": 1,
"dissolving_at": "string",
"dissolved_at": "string",
"created_at": "string",
"updated_at": "string"
},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | HTTP успешен; пожалуйста, продолжайте оценивать код тела ответа | Inline |
Схема ответа
Допустимые значения
| Свойство | Значение |
|---|---|
| status | 0 |
| status | 1 |
| status | 2 |
| status | 3 |
| current_role | 1 |
| current_role | 2 |
| current_role | 3 |
| current_role | 4 |
| current_role | null |
Список команд, доступных текущему пользователю
Примеры кода
# Также можно использовать wget
curl -X GET https://api.proxylite.com/end-point/team/list \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
GET /end-point/team/list
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| page | query | integer | false | нет |
| page_size | query | integer | false | нет |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {
"list": [
{
"id": "A1b2C3d4E5f6",
"name": "string",
"super_admin_user_id": 1,
"status": 0,
"current_role": 1,
"dissolving_at": "string",
"dissolved_at": "string",
"created_at": "string",
"updated_at": "string"
}
],
"total": 0,
"page": 1,
"page_size": 1
},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | HTTP успешен; пожалуйста, продолжайте оценивать код тела ответа | Inline |
Схема ответа
Допустимые значения
| Свойство | Значение |
|---|---|
| status | 0 |
| status | 1 |
| status | 2 |
| status | 3 |
| current_role | 1 |
| current_role | 2 |
| current_role | 3 |
| current_role | 4 |
| current_role | null |
Детали команды
Примеры кода
# Также можно использовать wget
curl -X GET https://api.proxylite.com/end-point/team/detail?team_id=A1b2C3d4E5f6 \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
GET /end-point/team/detail
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| team_id | query | TeamPublicId | true | нет |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {
"id": "A1b2C3d4E5f6",
"name": "string",
"super_admin_user_id": 1,
"status": 0,
"current_role": 1,
"dissolving_at": "string",
"dissolved_at": "string",
"created_at": "string",
"updated_at": "string"
},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | HTTP успешен; пожалуйста, продолжайте оценивать код тела ответа | Inline |
Схема ответа
Допустимые значения
| Свойство | Значение |
|---|---|
| status | 0 |
| status | 1 |
| status | 2 |
| status | 3 |
| current_role | 1 |
| current_role | 2 |
| current_role | 3 |
| current_role | 4 |
| current_role | null |
Изменить название команды
Примеры кода
# Также можно использовать wget
curl -X POST https://api.proxylite.com/end-point/team/update-name \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
POST /end-point/team/update-name
Body parameter
{
"team_id": "A1b2C3d4E5f6",
"name": "string"
}
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| body | body | object | true | нет |
| » team_id | body | TeamPublicId | true | Публичный логотип команды, первый символ — буква ASCII, остальные символы содержат только буквы и цифры ASCII; числовой первичный ключ базы данных не выдан |
| » name | body | string | true | нет |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {
"id": "A1b2C3d4E5f6",
"name": "string",
"super_admin_user_id": 1,
"status": 0,
"current_role": 1,
"dissolving_at": "string",
"dissolved_at": "string",
"created_at": "string",
"updated_at": "string"
},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | HTTP успешен; пожалуйста, продолжайте оценивать код тела ответа | Inline |
Схема ответа
Допустимые значения
| Свойство | Значение |
|---|---|
| status | 0 |
| status | 1 |
| status | 2 |
| status | 3 |
| current_role | 1 |
| current_role | 2 |
| current_role | 3 |
| current_role | 4 |
| current_role | null |
Расформировать команду
Примеры кода
# Также можно использовать wget
curl -X POST https://api.proxylite.com/end-point/team/dissolve \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
POST /end-point/team/dissolve
Это могут делать только суперадминистраторы команды. Имя в запросе должно точно совпадать с текущим названием команды. Этот интерфейс обеспечивает двухэтапную проверку операций: код = 348 возвращается, если он не находится в 15-минутном состоянии доверия; Вызывающий должен получить код проверки в соответствии с доступными методами в данных ответа, а затем повторить попытку с помощьюverify_type иverify_code. Может быть вызван повторно, чтобы продолжить незавершенный процесс растворения.
Body parameter
{
"team_id": "A1b2C3d4E5f6",
"name": "华东研发团队",
"verify_type": "email",
"verify_code": "123456"
}
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| body | body | object | true | нет |
| » team_id | body | TeamPublicId | true | Публичный логотип команды, первый символ — буква ASCII, остальные символы содержат только буквы и цифры ASCII; числовой первичный ключ базы данных не выдан |
| » name | body | string | true | Подтверждение названия команды должно совпадать с текущим названием команды. |
| » verify_type | body | string | false | Вторичный метод проверки; отправить вместе сverify_code, когда требуется проверка |
| » verify_code | body | string | false | Двухэтапный код проверки; не требуется в 15-минутном состоянии доверия |
Допустимые значения
| Parameter | Value |
|---|---|
| » verify_type | phone |
| » verify_type | |
| » verify_type | |
| » verify_type | totp |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {
"id": "A1b2C3d4E5f6",
"name": "string",
"super_admin_user_id": 1,
"status": 0,
"current_role": 1,
"dissolving_at": "string",
"dissolved_at": "string",
"created_at": "string",
"updated_at": "string"
},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | HTTP успешен; пожалуйста, продолжайте оценивать код тела ответа | Inline |
Схема ответа
Допустимые значения
| Свойство | Значение |
|---|---|
| status | 0 |
| status | 1 |
| status | 2 |
| status | 3 |
| current_role | 1 |
| current_role | 2 |
| current_role | 3 |
| current_role | 4 |
| current_role | null |
Статус расформирования группы запроса
Примеры кода
# Также можно использовать wget
curl -X GET https://api.proxylite.com/end-point/team/dissolve-status?team_id=A1b2C3d4E5f6 \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
GET /end-point/team/dissolve-status
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| team_id | query | TeamPublicId | true | нет |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {
"id": "A1b2C3d4E5f6",
"name": "string",
"super_admin_user_id": 1,
"status": 0,
"current_role": 1,
"dissolving_at": "string",
"dissolved_at": "string",
"created_at": "string",
"updated_at": "string"
},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | HTTP успешен; пожалуйста, продолжайте оценивать код тела ответа | Inline |
Схема ответа
Допустимые значения
| Свойство | Значение |
|---|---|
| status | 0 |
| status | 1 |
| status | 2 |
| status | 3 |
| current_role | 1 |
| current_role | 2 |
| current_role | 3 |
| current_role | 4 |
| current_role | null |
член команды
Списки членов команды, корректировка ролей, удаления и выходы
Список членов команды
Примеры кода
# Также можно использовать wget
curl -X GET https://api.proxylite.com/end-point/team/members?team_id=A1b2C3d4E5f6 \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
GET /end-point/team/members
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| team_id | query | TeamPublicId | true | нет |
| page | query | integer | false | нет |
| page_size | query | integer | false | нет |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {
"list": [
{
"team_member_id": 1,
"team_id": "A1b2C3d4E5f6",
"user_id": 1,
"role": 1,
"status": 0,
"joined_at": "string",
"nickname": "string",
"username": "string"
}
],
"total": 0,
"page": 1,
"page_size": 1
},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | HTTP успешен; пожалуйста, продолжайте оценивать код тела ответа | Inline |
Схема ответа
Допустимые значения
| Свойство | Значение |
|---|---|
| role | 1 |
| role | 2 |
| role | 3 |
| role | 4 |
| status | 0 |
| status | 1 |
| status | 2 |
| status | 3 |
Единый список членов команды
Примеры кода
# Также можно использовать wget
curl -X GET https://api.proxylite.com/end-point/team/people?team_id=A1b2C3d4E5f6 \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
GET /end-point/team/people
Действительные члены возвращаются; суперадминистраторы и администраторы также видят ожидающие приглашения. Другие статусы приглашений остаются только в списке истории приглашений.
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| team_id | query | TeamPublicId | true | нет |
| page | query | integer | false | нет |
| page_size | query | integer | false | нет |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {
"list": [
{
"record_type": "member",
"record_id": 1,
"team_id": "A1b2C3d4E5f6",
"user_id": 0,
"inviter_user_id": 0,
"invite_type": 0,
"invite_country_code": 999,
"invite_target": "string",
"delivery_type": 0,
"role": 1,
"status": 0,
"display_name": "string",
"nickname": "string",
"username": "string",
"email": "string",
"phone": "string",
"joined_at": "string",
"expired_at": "string",
"created_at": "string"
}
],
"total": 0,
"page": 1,
"page_size": 1
},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | HTTP успешен; пожалуйста, продолжайте оценивать код тела ответа | Inline |
Схема ответа
Допустимые значения
| Свойство | Значение |
|---|---|
| record_type | member |
| record_type | invitation |
| invite_type | 0 |
| invite_type | 1 |
| invite_type | 2 |
| invite_type | 3 |
| delivery_type | 0 |
| delivery_type | 1 |
| delivery_type | 2 |
| delivery_type | 3 |
| role | 1 |
| role | 2 |
| role | 3 |
| role | 4 |
| status | 0 |
| status | 1 |
Настройка ролей участников
Примеры кода
# Также можно использовать wget
curl -X POST https://api.proxylite.com/end-point/team/members/update-role \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
POST /end-point/team/members/update-role
Body parameter
{
"team_id": "A1b2C3d4E5f6",
"team_member_id": 1,
"role": 2
}
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| body | body | object | true | нет |
| » team_id | body | TeamPublicId | true | Публичный логотип команды, первый символ — буква ASCII, остальные символы содержат только буквы и цифры ASCII; числовой первичный ключ базы данных не выдан |
| » team_member_id | body | integer | true | нет |
| » role | body | integer | true | нет |
Допустимые значения
| Parameter | Value |
|---|---|
| » role | 2 |
| » role | 3 |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {
"team_member_id": 1,
"team_id": "A1b2C3d4E5f6",
"user_id": 1,
"role": 1,
"status": 0,
"joined_at": "string",
"nickname": "string",
"username": "string"
},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | HTTP успешен; пожалуйста, продолжайте оценивать код тела ответа | Inline |
Схема ответа
Допустимые значения
| Свойство | Значение |
|---|---|
| role | 1 |
| role | 2 |
| role | 3 |
| role | 4 |
| status | 0 |
| status | 1 |
| status | 2 |
| status | 3 |
Удалить члена команды
Примеры кода
# Также можно использовать wget
curl -X POST https://api.proxylite.com/end-point/team/members/remove \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
POST /end-point/team/members/remove
Body parameter
{
"team_id": "A1b2C3d4E5f6",
"team_member_id": 1
}
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| body | body | object | true | нет |
| » team_id | body | TeamPublicId | true | Публичный логотип команды, первый символ — буква ASCII, остальные символы содержат только буквы и цифры ASCII; числовой первичный ключ базы данных не выдан |
| » team_member_id | body | integer | true | нет |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {
"team_member_id": 1,
"team_id": "A1b2C3d4E5f6",
"user_id": 1,
"role": 1,
"status": 0,
"joined_at": "string",
"nickname": "string",
"username": "string"
},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | HTTP успешен; когда бизнес успешен data.status=3 | Inline |
Схема ответа
Допустимые значения
| Свойство | Значение |
|---|---|
| role | 1 |
| role | 2 |
| role | 3 |
| role | 4 |
| status | 0 |
| status | 1 |
| status | 2 |
| status | 3 |
Выйти из команды
Примеры кода
# Также можно использовать wget
curl -X POST https://api.proxylite.com/end-point/team/members/leave \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
POST /end-point/team/members/leave
Body parameter
{
"team_id": "A1b2C3d4E5f6"
}
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| body | body | object | true | нет |
| » team_id | body | TeamPublicId | true | Публичный логотип команды, первый символ — буква ASCII, остальные символы содержат только буквы и цифры ASCII; числовой первичный ключ базы данных не выдан |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {
"team_member_id": 1,
"team_id": "A1b2C3d4E5f6",
"user_id": 1,
"role": 1,
"status": 0,
"joined_at": "string",
"nickname": "string",
"username": "string"
},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | HTTP успешен; когда бизнес успешен, data.status=2 | Inline |
Схема ответа
Допустимые значения
| Свойство | Значение |
|---|---|
| role | 1 |
| role | 2 |
| role | 3 |
| role | 4 |
| status | 0 |
| status | 1 |
| status | 2 |
| status | 3 |
Приглашение команды
Создание, запрос и обработка приглашений членов команды
Создать командное приглашение
Примеры кода
# Также можно использовать wget
curl -X POST https://api.proxylite.com/end-point/team/invitations/create \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
POST /end-point/team/invitations/create
Создавайте приглашения по зарегистрированному пользователю, адресу электронной почты или номеру мобильного телефона. Если адрес электронной почты или номер мобильного телефона соответствует пользователю на этом сайте, ответ будет нормализован до приглашения_type=1. Внешний интерфейс может отправить шаблон относительного пути URL-адреса приглашения этого сайта, а сервер только заменяет в нем одноразовым токеном приглашения. После того, как незарегистрированная цель зарегистрируется с использованием приглашенного номера мобильного телефона или завершит проверку с использованием приглашенного электронного письма, сервер привяжет все еще действительное приглашение к новому пользователю, поменяет токен и повторно отправит только непрочитанное сообщение на сайте; старый токен в исходном электронном письме или текстовом сообщении станет недействительным. Если приглашение по электронной почте не было автоматически привязано, текущую учетную запись, зарегистрированную с приглашенным адресом электронной почты, можно принять напрямую, не дожидаясь email_verify.
Body parameter
{
"team_id": "A1b2C3d4E5f6",
"invite_type": 1,
"role": 2,
"user_id": 1,
"email": "[email protected]",
"country_code": 1,
"phone": "string",
"invitation_url_template": "/team/invitation/{{token}}"
}
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| body | body | object | true | нет |
| » team_id | body | TeamPublicId | true | Публичный логотип команды, первый символ — буква ASCII, остальные символы содержат только буквы и цифры ASCII; числовой первичный ключ базы данных не выдан |
| » invite_type | body | integer | true | 1=Зарегистрированный пользователь, 2=Электронная почта, 3=Номер мобильного телефона |
| » role | body | integer | true | 2=администратор, 3=обычный член |
| » user_id | body | integer | false | Требуется, если инвайт_тип=1 |
| body | string(email) | false | Требуется, если инвайт_тип=2 | |
| » country_code | body | integer | false | Требуется, если инвайт_тип=3 |
| » phone | body | string | false | Требуется, если инвайт_тип=3 |
| » invitation_url_template | body | string | false | Шаблон относительного пути, определенный в интерфейсе этого веб-сайта; должен начинаться с одного /, не должен содержать доменных имен или символов новой строки и должен и может содержать только один заполнитель |
| » anonymous | body | object | false | нет |
| »» invite_type | body | any | false | нет |
| » anonymous | body | object | false | нет |
| »» invite_type | body | any | false | нет |
| » anonymous | body | object | false | нет |
| »» invite_type | body | any | false | нет |
Допустимые значения
| Parameter | Value |
|---|---|
| » invite_type | 1 |
| » invite_type | 2 |
| » invite_type | 3 |
| » role | 2 |
| » role | 3 |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {
"invitation": {
"id": 1,
"team_id": "A1b2C3d4E5f6",
"inviter_user_id": 1,
"invitee_user_id": 0,
"invite_type": 1,
"invite_country_code": 999,
"invite_target": "string",
"delivery_type": 1,
"role": 2,
"status": 0,
"accepted_by_user_id": 0,
"expired_at": "2026-07-17 10:00:00",
"accepted_at": null,
"rejected_at": null,
"cancelled_at": null,
"created_at": "2026-07-10 10:00:00"
},
"invitation_token": "string",
"invitation_url": "http://example.com",
"notification_channels": {
"email": "queued",
"sms": "queued",
"site_inner_message": "created"
}
},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | HTTP успешен; пожалуйста, продолжайте оценивать код тела ответа, 200 означает успех в бизнесе | Inline |
Схема ответа
Допустимые значения
| Свойство | Значение |
|---|---|
| invite_type | 1 |
| invite_type | 2 |
| invite_type | 3 |
| delivery_type | 1 |
| delivery_type | 2 |
| delivery_type | 3 |
| role | 2 |
| role | 3 |
| status | 0 |
| status | 1 |
| status | 2 |
| status | 3 |
| status | 4 |
| queued | |
| failed | |
| skipped | |
| sms | queued |
| sms | failed |
| sms | skipped |
| site_inner_message | created |
| site_inner_message | exists |
| site_inner_message | failed |
Список приглашенных команд
Примеры кода
# Также можно использовать wget
curl -X GET https://api.proxylite.com/end-point/team/invitations?team_id=A1b2C3d4E5f6 \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
GET /end-point/team/invitations
Доступно только суперадминистраторам или администраторам команды; ожидающие приглашения, срок действия которых истек, будут обновлены до истекших перед возвращением.
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| team_id | query | TeamPublicId | true | Публичный имидж команды |
| page | query | integer | false | Номер страницы, начиная с 1 |
| page_size | query | integer | false | Количество на странице |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {
"list": [
{
"id": 1,
"team_id": "A1b2C3d4E5f6",
"inviter_user_id": 1,
"invitee_user_id": 0,
"invite_type": 1,
"invite_country_code": 999,
"invite_target": "string",
"delivery_type": 1,
"role": 2,
"status": 0,
"accepted_by_user_id": 0,
"expired_at": "2026-07-17 10:00:00",
"accepted_at": null,
"rejected_at": null,
"cancelled_at": null,
"created_at": "2026-07-10 10:00:00"
}
],
"total": 0,
"page": 1,
"page_size": 1
},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | HTTP успешен; пожалуйста, продолжайте оценивать код тела ответа | Inline |
Схема ответа
Допустимые значения
| Свойство | Значение |
|---|---|
| invite_type | 1 |
| invite_type | 2 |
| invite_type | 3 |
| delivery_type | 1 |
| delivery_type | 2 |
| delivery_type | 3 |
| role | 2 |
| role | 3 |
| status | 0 |
| status | 1 |
| status | 2 |
| status | 3 |
| status | 4 |
Предварительный просмотр приглашения команды
Примеры кода
# Также можно использовать wget
curl -X GET https://api.proxylite.com/end-point/team/invitations/preview?invitation_token=string \
-H 'Accept: application/json'
GET /end-point/team/invitations/preview
Предварительный просмотр приглашений анонимно, используя одноразовый пригласительный_токен; В ссылке не используется цифровой идентификатор приглашения.
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| invitation_token | query | string | true | Непустой одноразовый токен открытого текста, передаваемый по ссылке приглашения. |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {
"team_name": "string",
"role": 2,
"status": 0,
"expired_at": "string"
},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | HTTP успешен; пожалуйста, продолжайте оценивать код тела ответа | Inline |
Схема ответа
Допустимые значения
| Свойство | Значение |
|---|---|
| role | 2 |
| role | 3 |
| status | 0 |
| status | 1 |
| status | 2 |
| status | 3 |
| status | 4 |
Повторно отправить уведомление о приглашении в команду
Примеры кода
# Также можно использовать wget
curl -X POST https://api.proxylite.com/end-point/team/invitations/resend \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
POST /end-point/team/invitations/resend
Реинвестируйте в первоначальный канал отправки; зарегистрированные пользователи также отправляют сообщения сайта. При повторной отправке токена он будет заменен, и все предыдущие ссылки-приглашения немедленно станут недействительными.
Body parameter
{
"team_id": "A1b2C3d4E5f6",
"invitation_id": 1
}
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| body | body | object | true | нет |
| » team_id | body | TeamPublicId | true | Публичный логотип команды, первый символ — буква ASCII, остальные символы содержат только буквы и цифры ASCII; числовой первичный ключ базы данных не выдан |
| » invitation_id | body | integer | true | Идентификатор приглашения |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {
"invitation": {
"id": 1,
"team_id": "A1b2C3d4E5f6",
"inviter_user_id": 1,
"invitee_user_id": 0,
"invite_type": 1,
"invite_country_code": 999,
"invite_target": "string",
"delivery_type": 1,
"role": 2,
"status": 0,
"accepted_by_user_id": 0,
"expired_at": "2026-07-17 10:00:00",
"accepted_at": null,
"rejected_at": null,
"cancelled_at": null,
"created_at": "2026-07-10 10:00:00"
},
"invitation_url": "http://example.com",
"notification_channels": {
"email": "queued",
"sms": "queued",
"site_inner_message": "created"
}
},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | HTTP успешен; пожалуйста, продолжайте оценивать код тела ответа | Inline |
Схема ответа
Допустимые значения
| Свойство | Значение |
|---|---|
| invite_type | 1 |
| invite_type | 2 |
| invite_type | 3 |
| delivery_type | 1 |
| delivery_type | 2 |
| delivery_type | 3 |
| role | 2 |
| role | 3 |
| status | 0 |
| status | 1 |
| status | 2 |
| status | 3 |
| status | 4 |
| queued | |
| failed | |
| skipped | |
| sms | queued |
| sms | failed |
| sms | skipped |
| site_inner_message | created |
| site_inner_message | exists |
| site_inner_message | failed |
Принять приглашение команды
Примеры кода
# Также можно использовать wget
curl -X POST https://api.proxylite.com/end-point/team/invitations/accept \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
POST /end-point/team/invitations/accept
Пользователь, вошедший в систему в данный момент, использует одноразовый маркер приглашения для принятия приглашения, который должен соответствовать цели приглашения и принадлежать сайту, которому принадлежит приглашение; нет необходимости передавать team_id.
Body parameter
{
"invitation_token": "string"
}
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| body | body | object | true | нет |
| » invitation_token | body | string | true | Токен одноразового приглашения с открытым текстом |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {
"team_member_id": 1,
"team_id": "A1b2C3d4E5f6",
"user_id": 1,
"role": 1,
"status": 0,
"joined_at": "string",
"nickname": "string",
"username": "string"
},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | HTTP успешен; когда бизнес успешен, данные являются объектом-членом | Inline |
Схема ответа
Допустимые значения
| Свойство | Значение |
|---|---|
| role | 1 |
| role | 2 |
| role | 3 |
| role | 4 |
| status | 0 |
| status | 1 |
| status | 2 |
| status | 3 |
Отклонить приглашение команды
Примеры кода
# Также можно использовать wget
curl -X POST https://api.proxylite.com/end-point/team/invitations/reject \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
POST /end-point/team/invitations/reject
Пользователь, вошедший в систему в настоящий момент, использует одноразовый маркер приглашения, чтобы отклонять приглашения, соответствующие этому пользователю; нет необходимости передавать team_id.
Body parameter
{
"invitation_token": "string"
}
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| body | body | object | true | нет |
| » invitation_token | body | string | true | Токен одноразового приглашения с открытым текстом |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {
"id": 1,
"team_id": "A1b2C3d4E5f6",
"inviter_user_id": 1,
"invitee_user_id": 0,
"invite_type": 1,
"invite_country_code": 999,
"invite_target": "string",
"delivery_type": 1,
"role": 2,
"status": 0,
"accepted_by_user_id": 0,
"expired_at": "2026-07-17 10:00:00",
"accepted_at": null,
"rejected_at": null,
"cancelled_at": null,
"created_at": "2026-07-10 10:00:00"
},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | HTTP успешен; когда бизнес успешен, data.status=2 | Inline |
Схема ответа
Допустимые значения
| Свойство | Значение |
|---|---|
| invite_type | 1 |
| invite_type | 2 |
| invite_type | 3 |
| delivery_type | 1 |
| delivery_type | 2 |
| delivery_type | 3 |
| role | 2 |
| role | 3 |
| status | 0 |
| status | 1 |
| status | 2 |
| status | 3 |
| status | 4 |
Отменить приглашение в команду
Примеры кода
# Также можно использовать wget
curl -X POST https://api.proxylite.com/end-point/team/invitations/cancel \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
POST /end-point/team/invitations/cancel
Чтобы отменить ожидающее приглашение в указанную команду, оператор должен иметь право приглашать целевого персонажа.
Body parameter
{
"team_id": "A1b2C3d4E5f6",
"invitation_id": 1
}
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| body | body | object | true | нет |
| » team_id | body | TeamPublicId | true | Публичный логотип команды, первый символ — буква ASCII, остальные символы содержат только буквы и цифры ASCII; числовой первичный ключ базы данных не выдан |
| » invitation_id | body | integer | true | Идентификатор приглашения |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {
"id": 1,
"team_id": "A1b2C3d4E5f6",
"inviter_user_id": 1,
"invitee_user_id": 0,
"invite_type": 1,
"invite_country_code": 999,
"invite_target": "string",
"delivery_type": 1,
"role": 2,
"status": 0,
"accepted_by_user_id": 0,
"expired_at": "2026-07-17 10:00:00",
"accepted_at": null,
"rejected_at": null,
"cancelled_at": null,
"created_at": "2026-07-10 10:00:00"
},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | HTTP успешен; когда бизнес успешен data.status=3 | Inline |
Схема ответа
Допустимые значения
| Свойство | Значение |
|---|---|
| invite_type | 1 |
| invite_type | 2 |
| invite_type | 3 |
| delivery_type | 1 |
| delivery_type | 2 |
| delivery_type | 3 |
| role | 2 |
| role | 3 |
| status | 0 |
| status | 1 |
| status | 2 |
| status | 3 |
| status | 4 |
Активы команды
Запрос активов команды и передача личного/командного пространства
Информация о пакете команды
Примеры кода
# Также можно использовать wget
curl -X GET https://api.proxylite.com/end-point/team/product-info?team_id=A1b2C3d4E5f6 \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
GET /end-point/team/product-info
Возвращает сводку пакета указанного пространства ресурсов группы. Поля соответствуют полям пакета /web_v1/user/info. Не возвращает профиль суперадминистратора команды, баланс или внутренний числовой идентификатор команды. Пожалуйста, используйте /web_v1/credit/info для получения подробной информации о кредитном пакете.
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| team_id | query | TeamPublicId | true | нет |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {
"team_id": "A1b2C3d4E5f6",
"product_types": [
0
],
"product_residence_remain_count": 0,
"product_residence_total_count": 0,
"pdrue2_timestamp": 0,
"remain": 0,
"total_amount": 0,
"scraping_remain": 0,
"scraping_total_amount": 0,
"scraping_timestamp": "string",
"scraping_timestamp2": 0,
"common_scraping_remain": 0,
"common_scraping_total_amount": 0,
"common_scraping_timestamp": "string",
"common_scraping_timestamp2": 0,
"pdidcr_count": 0,
"pdidcr_total": 0,
"pdidcr_traffic_remain": 0,
"pdidcr_traffic_total": 0,
"p_sitai_ip_count": 0,
"p_sitai_ip": 0,
"p_sitai_ip_total": 0,
"p_sitai_remain": 0,
"p_sitai_total": 0,
"pdidc_count": 0,
"pdidc_total": 0,
"pdidc_ip_count": 0,
"pdidc_ip_all_count": 0,
"pdispr_count": 0,
"pdispr_total": 0,
"pdispr_traffic_remain": 0,
"pdispr_traffic_total": 0,
"product_datacenter_isp_traffic_ip_count": 0,
"product_datacenter_isp_traffc_ip": 0,
"product_datacenter_isp_traffc_ip_total": 0,
"product_datacenter_isp_traffic_ip": 0,
"product_datacenter_isp_traffic_ip_total": 0,
"product_datacenter_isp_traffc_remain": 0,
"product_datacenter_isp_traffc_total": 0,
"product_datacenter_isp_traffic_remain": 0,
"product_datacenter_isp_traffic_total": 0,
"product_datacenter_isp_ip": 0,
"product_datacenter_isp_ip_total": 0,
"product_datacenter_isp_ip_count": 0,
"product_datacenter_isp_ip_all_count": 0,
"product_datacenter_isp_ip_traffic_remain": 0,
"product_datacenter_isp_ip_traffic_total": 0,
"product_agent_residence_remain_count": 0,
"product_agent_residence_total_count": 0,
"product_serp_remain": 0,
"product_serp_total": 0,
"product_serp_timestamp": "string",
"product_serp_timestamp2": 0,
"product_video_remain": 0,
"product_video_total": 0,
"product_video_timestamp": "string",
"product_video_timestamp2": 0
},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | HTTP успешен; пожалуйста, продолжайте оценивать код тела ответа | Inline |
Схема ответа
Список активов команды
Примеры кода
# Также можно использовать wget
curl -X GET https://api.proxylite.com/end-point/team/assets?team_id=A1b2C3d4E5f6 \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
GET /end-point/team/assets
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| team_id | query | TeamPublicId | true | нет |
| page | query | integer | false | нет |
| page_size | query | integer | false | нет |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {
"list": [
{
"id": 1,
"user_id": 1,
"team_id": "A1b2C3d4E5f6",
"team_user_id": 0,
"product_id": 1,
"product_type": 0,
"parent_product_type": 0,
"status": 0,
"total_amount": 0,
"remain": 0,
"bandwidth": 0,
"concurrency": 0,
"expired_at": "string",
"created_at": "string",
"ip": "string",
"country_code": "string",
"country_name": "string",
"asn": "string",
"port": 0
}
],
"total": 0,
"page": 1,
"page_size": 1
},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | HTTP успешен; пожалуйста, продолжайте оценивать код тела ответа | Inline |
Схема ответа
Личные активы, которые можно передать команде
Примеры кода
# Также можно использовать wget
curl -X GET https://api.proxylite.com/end-point/team/assets/personal-candidates?team_id=A1b2C3d4E5f6 \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
GET /end-point/team/assets/personal-candidates
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| team_id | query | TeamPublicId | true | нет |
| page | query | integer | false | нет |
| page_size | query | integer | false | нет |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {
"list": [
{
"id": 1,
"user_id": 1,
"team_id": "A1b2C3d4E5f6",
"team_user_id": 0,
"product_id": 1,
"product_type": 0,
"parent_product_type": 0,
"status": 0,
"total_amount": 0,
"remain": 0,
"bandwidth": 0,
"concurrency": 0,
"expired_at": "string",
"created_at": "string",
"ip": "string",
"country_code": "string",
"country_name": "string",
"asn": "string",
"port": 0
}
],
"total": 0,
"page": 1,
"page_size": 1
},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | HTTP успешен; пожалуйста, продолжайте оценивать код тела ответа | Inline |
Схема ответа
Передача личных активов команде
Примеры кода
# Также можно использовать wget
curl -X POST https://api.proxylite.com/end-point/team/assets/move-in \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
POST /end-point/team/assets/move-in
Body parameter
{
"team_id": "A1b2C3d4E5f6",
"user_product_id": 1
}
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| body | body | object | true | нет |
| » team_id | body | TeamPublicId | true | Публичный логотип команды, первый символ — буква ASCII, остальные символы содержат только буквы и цифры ASCII; числовой первичный ключ базы данных не выдан |
| » user_product_id | body | integer | true | нет |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {
"id": 1,
"user_id": 1,
"team_id": "A1b2C3d4E5f6",
"team_user_id": 0,
"product_id": 1,
"product_type": 0,
"parent_product_type": 0,
"status": 0,
"total_amount": 0,
"remain": 0,
"bandwidth": 0,
"concurrency": 0,
"expired_at": "string",
"created_at": "string",
"ip": "string",
"country_code": "string",
"country_name": "string",
"asn": "string",
"port": 0
},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | HTTP успешен; пожалуйста, продолжайте оценивать код тела ответа | Inline |
Схема ответа
Активы команды возвращены отдельным лицам
Примеры кода
# Также можно использовать wget
curl -X POST https://api.proxylite.com/end-point/team/assets/move-out \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
POST /end-point/team/assets/move-out
Body parameter
{
"team_id": "A1b2C3d4E5f6",
"user_product_id": 1
}
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| body | body | object | true | нет |
| » team_id | body | TeamPublicId | true | Публичный логотип команды, первый символ — буква ASCII, остальные символы содержат только буквы и цифры ASCII; числовой первичный ключ базы данных не выдан |
| » user_product_id | body | integer | true | нет |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {
"id": 1,
"user_id": 1,
"team_id": "A1b2C3d4E5f6",
"team_user_id": 0,
"product_id": 1,
"product_type": 0,
"parent_product_type": 0,
"status": 0,
"total_amount": 0,
"remain": 0,
"bandwidth": 0,
"concurrency": 0,
"expired_at": "string",
"created_at": "string",
"ip": "string",
"country_code": "string",
"country_name": "string",
"asn": "string",
"port": 0
},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | HTTP успешен; пожалуйста, продолжайте оценивать код тела ответа | Inline |
Схема ответа
Управление баллами
Информация о пакете баллов, автоматическое пополнение, учет потребления и статистика
Получить информацию о пакете баллов (GET /web_v1/credit/info)
Примеры кода
# Также можно использовать wget
curl -X GET https://api.proxylite.com/web_v1/credit/info \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
GET /web_v1/credit/info
Запросите сводную информацию о пакете точек текущего пространства ресурсов. Для группового пространства требуется разрешение USE_ASSETS; этот интерфейс поддерживает статус входа, личный ключ API и ключ API команды одновременно.
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| team_id | query | ResourceSpaceId | false | Идентификатор ресурсного пространства; личное пространство опущено или передана пустая строка; Ключ API команды можно опустить и он должен соответствовать ключу при передаче. |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | HTTP успешен; когда бизнес успешен, данные представляют собой уровень баллов, общую сумму, оставшуюся сумму, время сброса и статус автоматического пополнения. | Inline |
Схема ответа
Настройте баланс для автоматического пополнения баллов
Примеры кода
# Также можно использовать wget
curl -X POST https://api.proxylite.com/web_v1/credit/update-auto-supplement \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
POST /web_v1/credit/update-auto-supplement
Установите переключатель автоматического пополнения текущего ресурсного пространства в состоянии входа в систему. Для пространства группы требуется разрешение USE_OWNER_PAYMENT_CAPABILITIES, в настоящее время работать могут только суперадминистраторы команды; пространство команды закрыто по умолчанию.
Body parameter
{
"team_id": "A1b2C3d4E5f6",
"status": 0
}
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| body | body | object | true | нет |
| » team_id | body | any | false | Идентификация пространства государственных ресурсов; опустите team_id или передайте пустую строку при запросе личного пространства и пустую строку при ответе на личное пространство; и число 0, и строка «0» незаконны, а в командном пространстве используется 6-12-значный публичный идентификатор команды. |
| »» anonymous | body | string | false | нет |
| »» anonymous | body | TeamPublicId | false | Публичный логотип команды, первый символ — буква ASCII, остальные символы содержат только буквы и цифры ASCII; числовой первичный ключ базы данных не выдан |
| » status | body | integer | true | 0=выкл., 1=вкл. |
Допустимые значения
| Parameter | Value |
|---|---|
| » status | 0 |
| » status | 1 |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | HTTP успешен; когда бизнес успешен, data.status — это обновленный статус коммутатора. | Inline |
Схема ответа
Получить запись о потреблении баллов (GET /web_v1/credit/consumption-logs)
Примеры кода
# Также можно использовать wget
curl -X GET https://api.proxylite.com/web_v1/credit/consumption-logs \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
GET /web_v1/credit/consumption-logs
Запросите запись потребления баллов текущего пространства ресурсов в состоянии входа или на странице ключа API. Для групповых пространств требуется разрешение VIEW_BILLING.
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| team_id | query | ResourceSpaceId | false | нет |
| page | query | integer | false | нет |
| page_size | query | integer | false | нет |
| start_date | query | string(date) | false | Дата начала, интерпретируемая часовым поясом сайта |
| end_date | query | string(date) | false | Дата окончания, интерпретируемая часовым поясом сайта |
| consumption_type | query | string | false | Тип потребления |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | HTTP успешен; когда бизнес успешен, данные включают список, страницу, размер_страницы, общее количество_страниц и общее_страницу. | Inline |
Схема ответа
Получить баллы, сбросить запись (GET /web_v1/credit/reset-logs)
Примеры кода
# Также можно использовать wget
curl -X GET https://api.proxylite.com/web_v1/credit/reset-logs \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
GET /web_v1/credit/reset-logs
Запросите запись сброса точек текущего пространства ресурсов в состоянии входа или на странице ключа API. Для групповых пространств требуется разрешение VIEW_BILLING.
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| team_id | query | ResourceSpaceId | false | нет |
| page | query | integer | false | нет |
| page_size | query | integer | false | нет |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | HTTP успешен; Когда бизнес успешен, данные содержат записи сброса точек и информацию о подкачке. | Inline |
Схема ответа
Получить статистику по баллам (GET /web_v1/credit/stats)
Примеры кода
# Также можно использовать wget
curl -X GET https://api.proxylite.com/web_v1/credit/stats \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
GET /web_v1/credit/stats
Войдите в систему или используйте ключ API, чтобы запросить статистику баллов, агрегированную по типу потребления текущего ресурсного пространства. Для групповых пространств требуется разрешение VIEW_BILLING.
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| team_id | query | ResourceSpaceId | false | нет |
| start_date | query | string(date) | false | Дата начала, интерпретируемая часовым поясом сайта |
| end_date | query | string(date) | false | Дата окончания, интерпретируемая часовым поясом сайта |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | HTTP успешен; когда бизнес успешен, данные содержат by_type и total | Inline |
Схема ответа
Получайте ежедневную статистику по баллам (GET /web_v1/credit/daily-stats)
Примеры кода
# Также можно использовать wget
curl -X GET https://api.proxylite.com/web_v1/credit/daily-stats \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
GET /web_v1/credit/daily-stats
Войдите в систему или используйте ключ API, чтобы запросить ежедневное потребление баллов текущего пространства ресурсов, которое по умолчанию равно последним 7 дням. Обычные члены команды возвращают только фактическое потребление; администраторы, суперадминистраторы и финансовые участники с разрешениями VIEW_BILLING возвращают полные данные команды. Журналы команд незарегистрированных участников-потребителей видны только в полном представлении. Запрос ключа API может содержать до 31 натуральных дней (включительно), а дата начала не может быть позже даты окончания.
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| team_id | query | ResourceSpaceId | false | нет |
| start_date | query | string(date) | false | Дата начала, по умолчанию 6 дней назад. |
| end_date | query | string(date) | false | Дата окончания, по умолчанию — сегодня. |
| consumption_type | query | string | false | Дополнительные типы потребления |
| fill_gaps | query | integer | false | Заполнять ли недостающие даты |
Допустимые значения
| Parameter | Value |
|---|---|
| fill_gaps | 0 |
| fill_gaps | 1 |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | HTTP успешен; когда бизнес успешен, данные содержат daily_stats и сводку | Inline |
Схема ответа
Получайте почасовую статистику по баллам (GET /web_v1/credit/hourly-stats)
Примеры кода
# Также можно использовать wget
curl -X GET https://api.proxylite.com/web_v1/credit/hourly-stats \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
GET /web_v1/credit/hourly-stats
Войдите в систему или используйте ключ API, чтобы запросить почасовое потребление баллов текущего пространства ресурсов, которое по умолчанию равно последним 7 дням. Для групповых пространств требуется разрешение VIEW_BILLING. Запрос ключа API может содержать до 31 натуральных дней (включительно), а дата начала не может быть позже даты окончания.
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| team_id | query | ResourceSpaceId | false | нет |
| start_date | query | string(date) | false | Дата начала, по умолчанию 6 дней назад. |
| end_date | query | string(date) | false | Дата окончания, по умолчанию — сегодня. |
| consumption_type | query | string | false | Дополнительные типы потребления |
| fill_gaps | query | integer | false | Заполнять ли недостающие часы |
Допустимые значения
| Parameter | Value |
|---|---|
| fill_gaps | 0 |
| fill_gaps | 1 |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | HTTP успешен; когда бизнес успешен, данные содержат почасовую_статистику и сводку | Inline |
Схема ответа
Получить информацию о пакете баллов (GET /end-point/credit/info)
Примеры кода
# Также можно использовать wget
curl -X GET https://api.proxylite.com/end-point/credit/info \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
GET /end-point/credit/info
Запросите сводную информацию о пакете точек текущего пространства ресурсов. Для группового пространства требуется разрешение USE_ASSETS; этот интерфейс поддерживает статус входа, личный ключ API и ключ API команды одновременно.
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| team_id | query | ResourceSpaceId | false | Идентификатор ресурсного пространства; личное пространство опущено или передана пустая строка; Ключ API команды можно опустить и он должен соответствовать ключу при передаче. |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | HTTP успешен; когда бизнес успешен, данные представляют собой уровень баллов, общую сумму, оставшуюся сумму, время сброса и статус автоматического пополнения. | Inline |
Схема ответа
Получить запись о потреблении баллов (GET /end-point/credit/consumption-logs)
Примеры кода
# Также можно использовать wget
curl -X GET https://api.proxylite.com/end-point/credit/consumption-logs \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
GET /end-point/credit/consumption-logs
Запросите запись потребления баллов текущего пространства ресурсов в состоянии входа или на странице ключа API. Для групповых пространств требуется разрешение VIEW_BILLING.
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| team_id | query | ResourceSpaceId | false | нет |
| page | query | integer | false | нет |
| page_size | query | integer | false | нет |
| start_date | query | string(date) | false | Дата начала, интерпретируемая часовым поясом сайта |
| end_date | query | string(date) | false | Дата окончания, интерпретируемая часовым поясом сайта |
| consumption_type | query | string | false | Тип потребления |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | HTTP успешен; когда бизнес успешен, данные включают список, страницу, размер_страницы, общее количество_страниц и общее_страницу. | Inline |
Схема ответа
Получить баллы, сбросить запись (GET /end-point/credit/reset-logs)
Примеры кода
# Также можно использовать wget
curl -X GET https://api.proxylite.com/end-point/credit/reset-logs \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
GET /end-point/credit/reset-logs
Запросите запись сброса точек текущего пространства ресурсов в состоянии входа или на странице ключа API. Для групповых пространств требуется разрешение VIEW_BILLING.
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| team_id | query | ResourceSpaceId | false | нет |
| page | query | integer | false | нет |
| page_size | query | integer | false | нет |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | HTTP успешен; Когда бизнес успешен, данные содержат записи сброса точек и информацию о подкачке. | Inline |
Схема ответа
Получить статистику по баллам (GET /end-point/credit/stats)
Примеры кода
# Также можно использовать wget
curl -X GET https://api.proxylite.com/end-point/credit/stats \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
GET /end-point/credit/stats
Войдите в систему или используйте ключ API, чтобы запросить статистику баллов, агрегированную по типу потребления текущего ресурсного пространства. Для групповых пространств требуется разрешение VIEW_BILLING.
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| team_id | query | ResourceSpaceId | false | нет |
| start_date | query | string(date) | false | Дата начала, интерпретируемая часовым поясом сайта |
| end_date | query | string(date) | false | Дата окончания, интерпретируемая часовым поясом сайта |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | HTTP успешен; когда бизнес успешен, данные содержат by_type и total | Inline |
Схема ответа
Получайте ежедневную статистику по баллам (GET /end-point/credit/daily-stats)
Примеры кода
# Также можно использовать wget
curl -X GET https://api.proxylite.com/end-point/credit/daily-stats \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
GET /end-point/credit/daily-stats
Войдите в систему или используйте ключ API, чтобы запросить ежедневное потребление баллов текущего пространства ресурсов, которое по умолчанию равно последним 7 дням. Обычные члены команды возвращают только фактическое потребление; администраторы, суперадминистраторы и финансовые участники с разрешениями VIEW_BILLING возвращают полные данные команды. Журналы команд незарегистрированных участников-потребителей видны только в полном представлении. Запрос ключа API может содержать до 31 натуральных дней (включительно), а дата начала не может быть позже даты окончания.
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| team_id | query | ResourceSpaceId | false | нет |
| start_date | query | string(date) | false | Дата начала, по умолчанию 6 дней назад. |
| end_date | query | string(date) | false | Дата окончания, по умолчанию — сегодня. |
| consumption_type | query | string | false | Дополнительные типы потребления |
| fill_gaps | query | integer | false | Заполнять ли недостающие даты |
Допустимые значения
| Parameter | Value |
|---|---|
| fill_gaps | 0 |
| fill_gaps | 1 |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | HTTP успешен; когда бизнес успешен, данные содержат daily_stats и сводку | Inline |
Схема ответа
Получайте почасовую статистику по баллам (GET /end-point/credit/hourly-stats)
Примеры кода
# Также можно использовать wget
curl -X GET https://api.proxylite.com/end-point/credit/hourly-stats \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
GET /end-point/credit/hourly-stats
Войдите в систему или используйте ключ API, чтобы запросить почасовое потребление баллов текущего пространства ресурсов, которое по умолчанию равно последним 7 дням. Для групповых пространств требуется разрешение VIEW_BILLING. Запрос ключа API может содержать до 31 натуральных дней (включительно), а дата начала не может быть позже даты окончания.
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| team_id | query | ResourceSpaceId | false | нет |
| start_date | query | string(date) | false | Дата начала, по умолчанию 6 дней назад. |
| end_date | query | string(date) | false | Дата окончания, по умолчанию — сегодня. |
| consumption_type | query | string | false | Дополнительные типы потребления |
| fill_gaps | query | integer | false | Заполнять ли недостающие часы |
Допустимые значения
| Parameter | Value |
|---|---|
| fill_gaps | 0 |
| fill_gaps | 1 |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | HTTP успешен; когда бизнес успешен, данные содержат почасовую_статистику и сводку | Inline |
Схема ответа
Xcrawl Activity Log
Xcrawl записи отдельных задач и пакетных задач, подробные сведения и сводный запрос
Получить список последних задач Xcrawl
Примеры кода
# Также можно использовать wget
curl -X GET https://api.proxylite.com/web_v1/xcrawl-activity-log/recent-runs \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
GET /web_v1/xcrawl-activity-log/recent-runs
Войдите в систему, чтобы запросить список отдельных задач и сводную информацию о текущем пространстве ресурсов. Для командного пространства требуется USE_ASSETS; обычные участники могут просматривать только задачи, созданные с использованием их собственных учетных данных, а администраторы и суперадминистраторы могут просматривать задачи всей команды.
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| team_id | query | ResourceSpaceId | false | нет |
| page | query | integer | false | нет |
| page_size | query | integer | false | нет |
| endpoint | query | string | false | тип конечной точки |
| status | query | string | false | нет |
| start_time | query | string | false | Часовой пояс пользователя, формат Y-m-d H:i:s |
| end_time | query | string | false | Часовой пояс пользователя, включая конечную границу |
| url | query | string | false | Целевой URL-адрес или идентификатор средства очистки данных |
| job_id | query | string | false | Префикс идентификатора задачи |
Допустимые значения
| Parameter | Value |
|---|---|
| status | pending |
| status | crawling |
| status | completed |
| status | failed |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | HTTP успешен; когда бизнес успешен, данные содержат список страниц и метаданные | Inline |
Схема ответа
Получить результат сканирования Xcrawl
Примеры кода
# Также можно использовать wget
curl -X GET https://api.proxylite.com/web_v1/xcrawl-activity-log/crawl-result?job_id=string \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
GET /web_v1/xcrawl-activity-log/crawl-result
В состоянии входа запросите результат сканирования указанной задачи в текущем пространстве ресурсов. Пространство группы требует USE_ASSETS и проверяет владение задачей на основе видимого диапазона учетных данных участника.
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| team_id | query | ResourceSpaceId | false | нет |
| job_id | query | string | true | Идентификатор задачи |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | HTTP успешен; когда бизнес успешен, данные содержат job_id и scan_result | Inline |
Схема ответа
Получите подробную информацию и журналы миссии Xcrawl.
Примеры кода
# Также можно использовать wget
curl -X GET https://api.proxylite.com/web_v1/xcrawl-activity-log/activity-logs?job_id=string \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
GET /web_v1/xcrawl-activity-log/activity-logs
В состоянии входа запросите текущее пространство ресурсов, чтобы указать одну задачу и сведения о ее результате. Пространство группы требует USE_ASSETS и проверяет владение задачей на основе видимого диапазона учетных данных участника.
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| team_id | query | ResourceSpaceId | false | нет |
| job_id | query | string | true | Идентификатор задачи |
| page | query | integer | false | Номер страницы подрезультата сканирования/данных |
| page_size | query | integer | false | сканирование/данные количества страниц подрезультатов |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | HTTP успешен; когда бизнес успешен, данные содержат задание и детали, измененные конечной точкой. | Inline |
Схема ответа
Получить совокупную статистику URL-адресов данных
Примеры кода
# Также можно использовать wget
curl -X GET https://api.proxylite.com/web_v1/xcrawl-activity-log/data-url-summary \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
GET /web_v1/xcrawl-activity-log/data-url-summary
Задачи очистки данных, которые агрегируют текущее пространство ресурсов в состоянии входа в систему. Для групповых пространств требуется USE_ASSETS, а результаты соответствуют видимой области учетных данных участника.
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| team_id | query | ResourceSpaceId | false | нет |
| limit | query | integer | false | Количество возврата; 0 возвращает пустой список |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | HTTP успешен; когда бизнес успешен, data.list является результатом агрегации парсера. | Inline |
Схема ответа
Получить список последних задач пакетного сканирования.
Примеры кода
# Также можно использовать wget
curl -X GET https://api.proxylite.com/web_v1/xcrawl-activity-log/batch-recent-runs \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
GET /web_v1/xcrawl-activity-log/batch-recent-runs
Войдите в систему, чтобы запросить список пакетных задач и сводную информацию о текущем пространстве ресурсов. Для командного пространства требуется USE_ASSETS; обычные участники могут просматривать только задачи, созданные с использованием их собственных учетных данных, а администраторы и суперадминистраторы могут просматривать задачи всей команды.
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| team_id | query | ResourceSpaceId | false | нет |
| page | query | integer | false | нет |
| page_size | query | integer | false | нет |
| endpoint | query | string | false | Тип конечной точки, обычно patch_scrape |
| status | query | string | false | нет |
| start_time | query | string | false | Часовой пояс пользователя, формат Y-m-d H:i:s |
| end_time | query | string | false | Часовой пояс пользователя, включая конечную границу |
| batch_id | query | string | false | Префикс идентификатора пакетной задачи |
Допустимые значения
| Parameter | Value |
|---|---|
| status | pending |
| status | crawling |
| status | completed |
| status | failed |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | HTTP успешен; когда бизнес успешен, данные содержат список страниц и метаданные | Inline |
Схема ответа
Получение сведений и журналов задачи пакетного сканирования
Примеры кода
# Также можно использовать wget
curl -X GET https://api.proxylite.com/web_v1/xcrawl-activity-log/batch-activity-logs?batch_id=string \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
GET /web_v1/xcrawl-activity-log/batch-activity-logs
В состоянии входа запросите указанные пакетные задачи и результаты их подэлементов в текущем пространстве ресурсов. Пространство группы требует USE_ASSETS и проверяет владение задачей на основе видимого диапазона учетных данных участника.
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| team_id | query | ResourceSpaceId | false | нет |
| batch_id | query | string | true | Идентификатор пакетной задачи |
| page | query | integer | false | Номер страницы подпункта |
| page_size | query | integer | false | Количество подстраниц |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | HTTP успешен; когда бизнес успешен, данные содержат детали заданий и пакетных задач. | Inline |
Схема ответа
Управление аккаунтом
Получите обзор вашего личного кабинета
Примеры кода
# Также можно использовать wget
curl -X GET https://api.proxylite.com/end-point/account/profile \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
GET /end-point/account/profile
Поддерживается только статус входа в личное пространство или личный ключ API; Ключ API команды не поддерживается.
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {
"id": 0,
"username": "string",
"nickname": "string",
"email": "string",
"balance": "string",
"gift_balance": "string",
"currency": "string",
"language": "string",
"timezone": "string"
},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | HTTP успешен; пожалуйста, проверьте бизнес-код, 200 означает успех. | Inline |
Схема ответа
Проверить выписку по личному балансу
Примеры кода
# Также можно использовать wget
curl -X GET https://api.proxylite.com/end-point/wallet/change-list \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
GET /end-point/wallet/change-list
Поддерживается только статус входа в личное пространство или личный ключ API; Ключ API команды не поддерживается.
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| re_type | query | integer | false | нет |
| transaction_type | query | integer | false | нет |
| balance_type | query | integer | false | нет |
| page | query | integer | false | нет |
| page_size | query | integer | false | нет |
Допустимые значения
| Parameter | Value |
|---|---|
| re_type | 0 |
| re_type | 1 |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {
"list": [
{
"id": 0,
"re_type": 0,
"transaction_type": 0,
"balance_type": 0,
"fee": "string"
}
],
"page": 0,
"page_size": 0,
"total_count": 0
},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | HTTP успешен; пожалуйста, проверьте бизнес-код, 200 означает успех. | Inline |
Схема ответа
Экспорт журнала
Создайте задачу экспорта журнала агента.
Примеры кода
# Также можно использовать wget
curl -X POST https://api.proxylite.com/end-point/user-usage-flow-log-export/create \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
POST /end-point/user-usage-flow-log-export/create
Поддерживается только статус входа в личное пространство или личный ключ API; Ключ API команды не поддерживается. Время начала должно быть раньше времени окончания, а временной интервал не должен превышать 31 день; одному и тому же пользователю разрешено только одно ожидающее или обрабатывающее задание экспорта, а верхний предел журналов составляет 5 миллионов.
Body parameter
{
"start_time": 0,
"end_time": 0,
"type": "dynamic"
}
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| body | body | object | true | нет |
| » start_time | body | integer | true | Начальная временная метка Unix, секунды |
| » end_time | body | integer | true | конечная временная метка Unix, секунды |
| » type | body | string | false | нет |
Допустимые значения
| Parameter | Value |
|---|---|
| » type | dynamic |
| » type | host_pool |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {
"task_id": 0,
"status": "string"
},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | HTTP успешен; пожалуйста, проверьте бизнес-код, 200 означает успех. | Inline |
Схема ответа
Подробности задачи экспорта журнала запросов
Примеры кода
# Также можно использовать wget
curl -X GET https://api.proxylite.com/end-point/user-usage-flow-log-export/detail?task_id=1 \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
GET /end-point/user-usage-flow-log-export/detail
Поддерживается только статус входа в личное пространство или личный ключ API; Ключ API команды не поддерживается.
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| task_id | query | integer | true | нет |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {
"id": 0,
"user_id": 0,
"start_time": "string",
"end_time": "string",
"status": "pending",
"file_size": 0,
"record_count": 0,
"created_at": "string",
"completed_at": "string",
"file_url": "string",
"download_url": "string",
"error_message": "string"
},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | HTTP успешен; пожалуйста, проверьте бизнес-код, 200 означает успех. | Inline |
Схема ответа
Допустимые значения
| Свойство | Значение |
|---|---|
| status | pending |
| status | processing |
| status | completed |
| status | failed |
| status | canceled |
| status | no_data |
Список задач экспорта журнала запросов
Примеры кода
# Также можно использовать wget
curl -X GET https://api.proxylite.com/end-point/user-usage-flow-log-export/list \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
GET /end-point/user-usage-flow-log-export/list
Поддерживается только статус входа в личное пространство или личный ключ API; Ключ API команды не поддерживается.
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| page | query | integer | false | нет |
| size | query | integer | false | нет |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {
"list": [
{
"id": 0,
"user_id": 0,
"start_time": "string",
"end_time": "string",
"status": "pending",
"file_size": 0,
"record_count": 0,
"created_at": "string",
"completed_at": "string",
"file_url": "string",
"download_url": "string",
"error_message": "string"
}
],
"total": 0,
"page": 0,
"size": 0
},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | HTTP успешен; пожалуйста, проверьте бизнес-код, 200 означает успех. | Inline |
Схема ответа
Допустимые значения
| Свойство | Значение |
|---|---|
| status | pending |
| status | processing |
| status | completed |
| status | failed |
| status | canceled |
| status | no_data |
Отмените задачу экспорта журнала, которая еще не была выполнена.
Примеры кода
# Также можно использовать wget
curl -X POST https://api.proxylite.com/end-point/user-usage-flow-log-export/cancel \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
POST /end-point/user-usage-flow-log-export/cancel
Поддерживается только статус входа в личное пространство или личный ключ API; Ключ API команды не поддерживается. Отменить можно только задачи, находящиеся в состоянии ожидания в очереди, а уже выполненные задачи отменить нельзя.
Body parameter
{
"task_id": 1
}
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| body | body | object | true | нет |
| » task_id | body | integer | true | нет |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": null,
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | HTTP успешен; пожалуйста, проверьте бизнес-код, 200 означает успех. | Inline |
Схема ответа
Купон
Запросить личный список купонов
Примеры кода
# Также можно использовать wget
curl -X POST https://api.proxylite.com/end-point/user-coupon/list \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
POST /end-point/user-coupon/list
Поддерживается только статус входа в личное пространство или личный ключ API; Ключ API команды не поддерживается.
Body parameter
{
"status": 0,
"page": 1,
"size": 20
}
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| body | body | object | false | нет |
| » status | body | integer | false | нет |
| » page | body | integer | false | нет |
| » size | body | integer | false | нет |
Допустимые значения
| Parameter | Value |
|---|---|
| » status | 0 |
| » status | 1 |
| » status | 2 |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {
"list": [
{
"id": 0,
"coupon_id": 0,
"type": 0,
"status": 0,
"source": 0,
"title": "string",
"title_en": "string",
"description": "string",
"description_en": "string",
"start_amount": "string",
"start_amount_usd": "string",
"start_amount_hkd": "string",
"deduction_amount": "string",
"deduction_amount_usd": "string",
"deduction_amount_hkd": "string",
"discount_rate": "string",
"discount_ceiling_amount": "string",
"discount_ceiling_amount_usd": "string",
"discount_ceiling_amount_hkd": "string",
"created_at": "string",
"effect_at": "string",
"expired_at": "string",
"used_at": "string",
"product_types": "string",
"created_timestamp": 0,
"effect_timestamp": 0,
"expired_timestamp": 0,
"used_timestamp": 0,
"is_expired": true
}
],
"page": 0,
"page_size": 0,
"page_count": 0
},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | HTTP успешен; пожалуйста, проверьте бизнес-код, 200 означает успех. | Inline |
Схема ответа
Проверьте детали личного купона
Примеры кода
# Также можно использовать wget
curl -X POST https://api.proxylite.com/end-point/user-coupon/info \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
POST /end-point/user-coupon/info
Поддерживается только статус входа в личное пространство или личный ключ API; Ключ API команды не поддерживается.
Body parameter
{
"id": 1
}
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| body | body | object | true | нет |
| » id | body | integer | true | нет |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {
"id": 0,
"coupon_id": 0,
"type": 0,
"status": 0,
"source": 0,
"title": "string",
"title_en": "string",
"description": "string",
"description_en": "string",
"start_amount": "string",
"start_amount_usd": "string",
"start_amount_hkd": "string",
"deduction_amount": "string",
"deduction_amount_usd": "string",
"deduction_amount_hkd": "string",
"discount_rate": "string",
"discount_ceiling_amount": "string",
"discount_ceiling_amount_usd": "string",
"discount_ceiling_amount_hkd": "string",
"created_at": "string",
"effect_at": "string",
"expired_at": "string",
"used_at": "string",
"product_types": "string",
"created_timestamp": 0,
"effect_timestamp": 0,
"expired_timestamp": 0,
"used_timestamp": 0,
"is_expired": true
},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | HTTP успешен; пожалуйста, проверьте бизнес-код, 200 означает успех. | Inline |
Схема ответа
Управление уведомлениями
Проверьте уведомления сайта
Примеры кода
# Также можно использовать wget
curl -X GET https://api.proxylite.com/end-point/notify/list \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
GET /end-point/notify/list
Поддерживается только статус входа в личное пространство или личный ключ API; Ключ API команды не поддерживается.
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| page | query | integer | false | нет |
| size | query | integer | false | нет |
| read | query | integer | false | нет |
| type | query | integer | false | нет |
Допустимые значения
| Parameter | Value |
|---|---|
| read | 0 |
| read | 1 |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {
"list": [
{
"id": 0,
"title": "string",
"content": "string",
"type": 0,
"read_status": 0,
"created_at": "string",
"created_timestamp": 0
}
],
"page": 0,
"size": 0,
"total": 0,
"total_unread_count": 0,
"unread_count_by_type": {}
},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | HTTP успешен; пожалуйста, проверьте бизнес-код, 200 означает успех. | Inline |
Схема ответа
Допустимые значения
| Свойство | Значение |
|---|---|
| read_status | 0 |
| read_status | 1 |
Проверьте детали уведомления сайта
Примеры кода
# Также можно использовать wget
curl -X GET https://api.proxylite.com/end-point/notify/detail?id=1 \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
GET /end-point/notify/detail
Поддерживается только статус входа в личное пространство или личный ключ API; Ключ API команды не поддерживается.
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| id | query | integer | true | нет |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {
"id": 0,
"title": "string",
"content": "string",
"type": 0,
"read_status": 0,
"created_at": "string",
"created_timestamp": 0
},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | HTTP успешен; пожалуйста, проверьте бизнес-код, 200 означает успех. | Inline |
Схема ответа
Допустимые значения
| Свойство | Значение |
|---|---|
| read_status | 0 |
| read_status | 1 |
Отметить уведомления сайта как прочитанные
Примеры кода
# Также можно использовать wget
curl -X POST https://api.proxylite.com/end-point/notify/read \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
POST /end-point/notify/read
Поддерживается только статус входа в личное пространство или личный ключ API; Ключ API команды не поддерживается.
Body parameter
{
"id": 1
}
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| body | body | object | true | нет |
| » id | body | integer | true | нет |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": null,
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | HTTP успешен; пожалуйста, проверьте бизнес-код, 200 означает успех. | Inline |
Схема ответа
Помечать уведомления сайта как прочитанные в пакетном режиме
Примеры кода
# Также можно использовать wget
curl -X POST https://api.proxylite.com/end-point/notify/batch-read \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
POST /end-point/notify/batch-read
Поддерживается только статус входа в личное пространство или личный ключ API; Ключ API команды не поддерживается.
Body parameter
{
"ids": [
1
]
}
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| body | body | object | true | нет |
| » ids | body | [integer] | true | нет |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": null,
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | HTTP успешен; пожалуйста, проверьте бизнес-код, 200 означает успех. | Inline |
Схема ответа
Конфигурация канала уведомления о запросе
Примеры кода
# Также можно использовать wget
curl -X GET https://api.proxylite.com/end-point/user-notify \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
GET /end-point/user-notify
Поддерживается только статус входа в личное пространство или личный ключ API; Ключ API команды не поддерживается.
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {
"list": [
{
"scene": 0,
"email_notify": true,
"phone_notify": true,
"browser_notify": true,
"site_inner_message_notify": true,
"webhook_notify": true,
"telegram_notify": true
}
]
},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | HTTP успешен; пожалуйста, проверьте бизнес-код, 200 означает успех. | Inline |
Схема ответа
Электронная почта с уведомлением о запросе
Примеры кода
# Также можно использовать wget
curl -X GET https://api.proxylite.com/end-point/user-notification-email/list \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
GET /end-point/user-notification-email/list
Поддерживается только статус входа в личное пространство или личный ключ API; Ключ API команды не поддерживается.
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {
"list": [
{
"id": 0,
"email": "string",
"created_at": 0
}
],
"max_count": 0,
"current_count": 0
},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | HTTP успешен; пожалуйста, проверьте бизнес-код, 200 означает успех. | Inline |
Схема ответа
Сценарий уведомления о запросе
Примеры кода
# Также можно использовать wget
curl -X GET https://api.proxylite.com/end-point/user-notification-email/scenes \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
GET /end-point/user-notification-email/scenes
Поддерживается только статус входа в личное пространство или личный ключ API; Ключ API команды не поддерживается.
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {
"list": [
{
"id": 0,
"name": "string",
"description": "string"
}
]
},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | HTTP успешен; пожалуйста, проверьте бизнес-код, 200 означает успех. | Inline |
Схема ответа
Запрос сценария подписки по электронной почте
Примеры кода
# Также можно использовать wget
curl -X GET https://api.proxylite.com/end-point/user-notification-email/email-scenes?id=1 \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
GET /end-point/user-notification-email/email-scenes
Поддерживается только статус входа в личное пространство или личный ключ API; Ключ API команды не поддерживается.
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| id | query | integer | true | нет |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {
"scenes": [
0
],
"subscribe_all": true
},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | HTTP успешен; пожалуйста, проверьте бизнес-код, 200 означает успех. | Inline |
Схема ответа
Конфигурация агента
Запрос переключения кэша личного агента
Примеры кода
# Также можно использовать wget
curl -X GET https://api.proxylite.com/end-point/proxy-cache/status \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
GET /end-point/proxy-cache/status
Поддерживается только статус входа в личное пространство или личный ключ API; Ключ API команды не поддерживается.
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {
"status": 0
},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | HTTP успешен; пожалуйста, проверьте бизнес-код, 200 означает успех. | Inline |
Схема ответа
Допустимые значения
| Свойство | Значение |
|---|---|
| status | 0 |
| status | 1 |
Установите переключатель кэширования личного прокси
Примеры кода
# Также можно использовать wget
curl -X POST https://api.proxylite.com/end-point/proxy-cache/change \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
POST /end-point/proxy-cache/change
Поддерживается только статус входа в личное пространство или личный ключ API; Ключ API команды не поддерживается.
Body parameter
{
"status": 0
}
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| body | body | object | true | нет |
| » status | body | integer | true | нет |
Допустимые значения
| Parameter | Value |
|---|---|
| » status | 0 |
| » status | 1 |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": null,
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | HTTP успешен; пожалуйста, проверьте бизнес-код, 200 означает успех. | Inline |
Схема ответа
Запросить UDP-переключатель личного агента
Примеры кода
# Также можно использовать wget
curl -X GET https://api.proxylite.com/end-point/user-proxy-config/udp \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
GET /end-point/user-proxy-config/udp
Поддерживается только статус входа в личное пространство или личный ключ API; Ключ API команды не поддерживается.
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {
"enabled": 0
},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | HTTP успешен; пожалуйста, проверьте бизнес-код, 200 означает успех. | Inline |
Схема ответа
Допустимые значения
| Свойство | Значение |
|---|---|
| enabled | 0 |
| enabled | 1 |
Установить UDP-переключатель личного агента
Примеры кода
# Также можно использовать wget
curl -X POST https://api.proxylite.com/end-point/user-proxy-config/udp \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
POST /end-point/user-proxy-config/udp
Поддерживается только статус входа в личное пространство или личный ключ API; Ключ API команды не поддерживается.
Body parameter
{
"udp": 0
}
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| body | body | object | true | нет |
| » udp | body | integer | true | нет |
Допустимые значения
| Parameter | Value |
|---|---|
| » udp | 0 |
| » udp | 1 |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {
"enabled": 0
},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | HTTP успешен; пожалуйста, проверьте бизнес-код, 200 означает успех. | Inline |
Схема ответа
Допустимые значения
| Свойство | Значение |
|---|---|
| enabled | 0 |
| enabled | 1 |
Командный кошелек
Запросить кошелек команды
Примеры кода
# Также можно использовать wget
curl -X GET https://api.proxylite.com/end-point/team/wallet/detail?team_id=A1b2C3d4E5f6 \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
GET /end-point/team/wallet/detail
Требуется разрешение VIEW_BILLING. Кошелек команды не зависит от суперадминистраторов и личных балансов участников.
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| team_id | query | TeamPublicId | true | нет |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {
"team_id": "A1b2C3d4E5f6",
"balance": 0.1,
"total_recharge_fee": 0.1,
"updated_at": "string"
},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | HTTP успешен; пожалуйста, продолжайте оценивать код тела ответа | Inline |
Схема ответа
Проверьте поток командного кошелька
Примеры кода
# Также можно использовать wget
curl -X GET https://api.proxylite.com/end-point/team/wallet/records?team_id=A1b2C3d4E5f6 \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
GET /end-point/team/wallet/records
Требуется разрешение VIEW_BILLING. Сумма оборота всегда является положительным числом, а увеличение или уменьшение средств обозначается полем направления.
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| team_id | query | TeamPublicId | true | нет |
| page | query | integer | false | нет |
| page_size | query | integer | false | нет |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {
"list": [
{
"id": 1,
"team_id": "A1b2C3d4E5f6",
"operator_user_id": 0,
"creator": {
"user_id": 0,
"display_name": "string",
"nickname": "string",
"username": "string",
"email": "string",
"phone": "string"
},
"direction": 0,
"transaction_type": 1,
"amount": 0.1,
"after_balance": 0.1,
"link_id": 0,
"request_id": "string",
"remark": "string",
"created_at": "string"
}
],
"total": 0,
"page": 1,
"page_size": 1
},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | HTTP успешен; пожалуйста, продолжайте оценивать код тела ответа | Inline |
Схема ответа
Допустимые значения
| Свойство | Значение |
|---|---|
| direction | 0 |
| direction | 1 |
| transaction_type | 1 |
| transaction_type | 2 |
| transaction_type | 3 |
| transaction_type | 4 |
| transaction_type | 5 |
Перевести личный баланс на командный кошелек
Примеры кода
# Также можно использовать wget
curl -X POST https://api.proxylite.com/end-point/team/wallet/transfer-in \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
POST /end-point/team/wallet/transfer-in
Разрешения TRANSFER_BALANCE есть только у суперадминистраторов команды. Командный кошелек добавляется после атомарного списания личного пополнения баланса; переведенная сумма не включается в total_recharge_fee, и перевод обратно на личный баланс не поддерживается.
Body parameter
{
"team_id": "A1b2C3d4E5f6",
"amount": 9999999999.9999
}
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| body | body | object | true | нет |
| » team_id | body | TeamPublicId | true | Публичный логотип команды, первый символ — буква ASCII, остальные символы содержат только буквы и цифры ASCII; числовой первичный ключ базы данных не выдан |
| » amount | body | number(double) | true | нет |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {
"team_id": "A1b2C3d4E5f6",
"balance": 0.1,
"total_recharge_fee": 0.1,
"updated_at": "string"
},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | HTTP успешен; пожалуйста, продолжайте оценивать код тела ответа | Inline |
Схема ответа
Перевести баланс команды обратно в личный кабинет
Примеры кода
# Также можно использовать wget
curl -X POST https://api.proxylite.com/end-point/team/wallet/transfer-out \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
POST /end-point/team/wallet/transfer-out
Его можно вызвать только при входе в систему суперадминистратора. Атомные отчисления с кошелька команды и увеличение личного пополнения баланса; не меняйте совокупную сумму пополнения команды или отдельного лица. Расформированную команду можно использовать для восстановления баланса, но расформированную команду нельзя вызвать.
Body parameter
{
"team_id": "A1b2C3d4E5f6",
"amount": 9999999999.9999
}
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| body | body | object | true | нет |
| » team_id | body | TeamPublicId | true | Публичный логотип команды, первый символ — буква ASCII, остальные символы содержат только буквы и цифры ASCII; числовой первичный ключ базы данных не выдан |
| » amount | body | number(double) | true | Не должен превышать текущий доступный баланс команды. |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {
"team_id": "A1b2C3d4E5f6",
"balance": 0.1,
"total_recharge_fee": 0.1,
"updated_at": "string"
},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | HTTP успешен; пожалуйста, продолжайте оценивать код тела ответа | Inline |
Схема ответа
извлечение IP
Извлечь IP (GET /end-point/ip/get-ip)
Примеры кода
# Также можно использовать wget
curl -X GET https://api.proxylite.com/end-point/ip/get-ip?app_key=pa%24%24word \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
GET /end-point/ip/get-ip
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| team_id | query | ResourceSpaceId | false | Команда Key может быть опущена; при передаче он должен соответствовать команде, к которой привязан Ключ. |
| app_key | query | string(password) | true | ключ доступа |
| cc | query | string | false | Страна или регион |
| state | query | string | false | провинция или штат |
| city | query | string | false | город |
| format | query | string | false | Получить формат |
| lb | query | string | false | Разделитель, допустим только в текстовом формате. |
| num | query | number | false | Количество экстракта |
| life | query | number | false | Период удержания - минуты |
| ep | query | string | false | прокси-сеть |
Допустимые значения
| Parameter | Value |
|---|---|
| ep | us |
| ep | hk |
| ep | de |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "string",
"data": {
"list": [
[
"150.109.114.72:1140",
"150.109.114.72:1141",
"150.109.114.72:1142",
"150.109.114.72:1143",
"150.109.114.72:1144",
"150.109.114.72:1145",
"150.109.114.72:1146",
"150.109.114.72:1147",
"150.109.114.72:1148",
"150.109.114.72:1149"
]
]
}
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | Запрос успешен | Inline |
Схема ответа
Status Code 200
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| » code | integer | true | нет | Код состояния, 200 успешно, 3 app_key недействителен, 156 учетная запись не аутентифицирована. |
| » msg | string | true | нет | сообщение о состоянии |
| » data | object | false | нет | none |
| »» list | [any] | false | нет | none |
Список городов (GET /end-point/ip/dynamic-area-city-list)
Примеры кода
# Также можно использовать wget
curl -X GET https://api.proxylite.com/end-point/ip/dynamic-area-city-list \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
GET /end-point/ip/dynamic-area-city-list
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "string",
"data": {
"list": [
{
"name_zh_cn": "美国",
"name_en": "United States",
"continent_code": "NA",
"country_code": "US",
"items": [
{
"city": "Arlington",
"state": "alabama",
"continent_code": "NA",
"country_code": "US"
}
]
}
]
}
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | Запрос успешен | Inline |
Схема ответа
Status Code 200
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| » code | integer | true | нет | Код состояния, 200 успешно, 3 app_key недействителен, 156 учетная запись не аутентифицирована. |
| » msg | string | true | нет | сообщение о состоянии |
| » data | object | false | нет | none |
| »» list | [object] | false | нет | список |
| »»» name_zh_cn | string | false | нет | Название страны или региона |
| »»» name_en | string | false | нет | Название страны или региона |
| »»» continent_code | string | false | нет | код континента |
| »»» country_code | string | false | нет | Код страны или региона |
| »»» items | [any] | false | нет | провинция или штат |
| »»»» city | string | false | нет | название города |
| »»»» state | string | false | нет | Код названия провинции или штата |
| »»»» continent_code | string | false | нет | код континента |
| »»»» country_code | string | false | нет | Код страны или региона |
Статистика количества добычи IP по дням
Примеры кода
# Также можно использовать wget
curl -X GET https://api.proxylite.com/end-point/user-extract-ip/days \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
GET /end-point/user-extract-ip/days
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| team_id | query | ResourceSpaceId | false | нет |
| start_date | query | string(date) | false | По умолчанию 6 дней назад |
| end_date | query | string(date) | false | По умолчанию сегодня |
| product_type | query | integer | false | нет |
Допустимые значения
| Parameter | Value |
|---|---|
| product_type | 9 |
| product_type | 17 |
| product_type | 22 |
Примеры ответов
Ответ 200
{
"code": 0,
"msg": "string",
"request_id": "string",
"data": {
"list": [
{
"count": 0,
"date": "2019-08-24"
}
]
}
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | Запрос успешен | Inline |
Схема ответа
Status Code 200
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| » code | integer | false | нет | none |
| » msg | string | false | нет | none |
| » request_id | string | false | нет | none |
| » data | object | false | нет | none |
| »» list | [object] | false | нет | none |
| »»» count | integer | true | нет | none |
| »»» date | string(date) | true | нет | none |
Извлечь IP (GET /end-point/ip/v3)
Примеры кода
# Также можно использовать wget
curl -X GET https://api.proxylite.com/end-point/ip/v3?app_key=pa%24%24word \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
GET /end-point/ip/v3
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| team_id | query | ResourceSpaceId | false | Команда Key может быть опущена; при передаче он должен соответствовать команде, к которой привязан Ключ. |
| app_key | query | string(password) | true | ключ доступа |
| cc | query | string | false | Страна или регион |
| state | query | string | false | провинция или штат |
| city | query | string | false | город |
| format | query | string | false | Получить формат |
| lb | query | string | false | Разделитель, допустим только в текстовом формате. |
| num | query | number | false | Количество экстракта |
| life | query | number | false | Период удержания - минуты |
| ep | query | string | false | прокси-сеть |
Допустимые значения
| Parameter | Value |
|---|---|
| ep | us |
| ep | hk |
| ep | de |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "string",
"data": {
"list": [
[
"150.109.114.72:1140",
"150.109.114.72:1141",
"150.109.114.72:1142",
"150.109.114.72:1143",
"150.109.114.72:1144",
"150.109.114.72:1145",
"150.109.114.72:1146",
"150.109.114.72:1147",
"150.109.114.72:1148",
"150.109.114.72:1149"
]
]
}
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | Запрос успешен | Inline |
Схема ответа
Status Code 200
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| » code | integer | true | нет | Код состояния, 200 успешно, 3 app_key недействителен, 156 учетная запись не аутентифицирована. |
| » msg | string | true | нет | сообщение о состоянии |
| » data | object | false | нет | none |
| »» list | [any] | false | нет | none |
Динамический региональный список городов V4
Примеры кода
# Также можно использовать wget
curl -X GET https://api.proxylite.com/end-point/ip/dcl4?username=string \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
GET /end-point/ip/dcl4
Получить список городов по имени пользователя, требуется аутентификация при входе, а учетная запись должна принадлежать текущему пользователю.
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| username | query | string | true | Имя пользователя учетной записи агента |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "string",
"data": {
"cache": true,
"list": [
{
"City": "Los Angeles",
"Area": "US",
"State": "California"
}
]
}
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | Запрос успешен | Inline |
Схема ответа
Status Code 200
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| » code | integer | false | нет | Код состояния, 200 успехов |
| » msg | string | false | нет | сообщение о состоянии |
| » data | object | false | нет | none |
| »» cache | boolean | false | нет | Независимо от того, исходит ли это из кеша |
| »» list | [object] | false | нет | none |
| »»» City | string | false | нет | город |
| »»» Area | string | false | нет | площадь |
| »»» State | string | false | нет | Штат/Провинция |
Динамический региональный список штатов/провинций V4
Примеры кода
# Также можно использовать wget
curl -X GET https://api.proxylite.com/end-point/ip/dsl4?username=string \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
GET /end-point/ip/dsl4
Получите список штатов/провинций по имени пользователя, требуется проверка подлинности для входа, а учетная запись должна принадлежать текущему пользователю.
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| username | query | string | true | Имя пользователя учетной записи агента |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "string",
"data": {
"cache": true,
"list": [
{
"City": "Los Angeles",
"Area": "US",
"State": "California"
}
]
}
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | Запрос успешен | Inline |
Схема ответа
Status Code 200
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| » code | integer | false | нет | Код состояния, 200 успехов |
| » msg | string | false | нет | сообщение о состоянии |
| » data | object | false | нет | none |
| »» cache | boolean | false | нет | Независимо от того, исходит ли это из кеша |
| »» list | [object] | false | нет | none |
| »»» City | string | false | нет | город |
| »»» Area | string | false | нет | площадь |
| »»» State | string | false | нет | Штат/Провинция |
Динамический объединенный список региональных городов штатов и провинций V4
Примеры кода
# Также можно использовать wget
curl -X GET https://api.proxylite.com/end-point/ip/dal4?username=string \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
GET /end-point/ip/dal4
Получите объединенный список штатов/провинций и городов по имени пользователя, сгруппированный по регионам. Требуется аутентификация при входе, и учетная запись должна принадлежать текущему пользователю.
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| username | query | string | true | Имя пользователя учетной записи агента |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "string",
"data": {
"cache": true,
"list": [
{
"Area": "US",
"states": [
{
"State": "California",
"cities": [
"Los Angeles"
]
}
]
}
]
}
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | Запрос успешен | Inline |
Схема ответа
Status Code 200
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| » code | integer | false | нет | Код состояния, 200 успехов |
| » msg | string | false | нет | сообщение о состоянии |
| » data | object | false | нет | none |
| »» cache | boolean | false | нет | Независимо от того, исходит ли это из кеша |
| »» list | [object] | false | нет | Список областей |
| »»» Area | string | false | нет | код города |
| »»» states | [object] | false | нет | Список штатов/провинций |
| »»»» State | string | false | нет | Название штата/провинции |
| »»»» cities | [string] | false | нет | Список городов |
Список городов (GET /end-point/ip/dynamic-citys)
Примеры кода
# Также можно использовать wget
curl -X GET https://api.proxylite.com/end-point/ip/dynamic-citys \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
GET /end-point/ip/dynamic-citys
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "string",
"data": {
"list": [
{
"name_zh_cn": "美国",
"name_en": "United States",
"continent_code": "NA",
"country_code": "US",
"items": [
{
"city": "Arlington",
"state": "alabama",
"continent_code": "NA",
"country_code": "US"
}
]
}
]
}
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | Запрос успешен | Inline |
Схема ответа
Status Code 200
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| » code | integer | true | нет | Код состояния, 200 успешно, 3 app_key недействителен, 156 учетная запись не аутентифицирована. |
| » msg | string | true | нет | сообщение о состоянии |
| » data | object | false | нет | none |
| »» list | [object] | false | нет | список |
| »»» name_zh_cn | string | false | нет | Название страны или региона |
| »»» name_en | string | false | нет | Название страны или региона |
| »»» continent_code | string | false | нет | код континента |
| »»» country_code | string | false | нет | Код страны или региона |
| »»» items | [any] | false | нет | провинция или штат |
| »»»» city | string | false | нет | название города |
| »»»» state | string | false | нет | Код названия провинции или штата |
| »»»» continent_code | string | false | нет | код континента |
| »»»» country_code | string | false | нет | Код страны или региона |
Поиск города
Примеры кода
# Также можно использовать wget
curl -X GET https://api.proxylite.com/end-point/ip/dynamic-citys/search?country_code=string&state=string \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
GET /end-point/ip/dynamic-citys/search
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| country_code | query | string | true | Код страны или региона |
| state | query | string | true | Код штата или провинции |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "string",
"data": {
"list": [
"string"
]
}
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | Запрос успешен | Inline |
Схема ответа
Status Code 200
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| » code | integer | true | нет | Код состояния, 200 успешно, 3 app_key недействителен, 156 учетная запись не аутентифицирована. |
| » msg | string | true | нет | сообщение о состоянии |
| » data | object | false | нет | none |
| »» list | [string] | false | нет | список |
Государственный список
Примеры кода
# Также можно использовать wget
curl -X GET https://api.proxylite.com/end-point/ip/dynamic-states \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
GET /end-point/ip/dynamic-states
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "string",
"data": {
"list": [
{
"name_zh_cn": "美国",
"name_en": "United States",
"continent_code": "NA",
"country_code": "US",
"items": [
{
"state": "alabama",
"continent_code": "NA",
"country_code": "US"
}
]
}
]
}
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | Запрос успешен | Inline |
Схема ответа
Status Code 200
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| » code | integer | true | нет | Код состояния, 200 успешно, 3 app_key недействителен, 156 учетная запись не аутентифицирована. |
| » msg | string | true | нет | сообщение о состоянии |
| » data | object | false | нет | none |
| »» list | [object] | false | нет | список |
| »»» name_zh_cn | string | false | нет | Название страны или региона |
| »»» name_en | string | false | нет | Название страны или региона |
| »»» continent_code | string | false | нет | код континента |
| »»» country_code | string | false | нет | Код страны или региона |
| »»» items | [any] | false | нет | провинция или штат |
| »»»» state | string | false | нет | Код названия провинции или штата |
| »»»» continent_code | string | false | нет | код континента |
| »»»» country_code | string | false | нет | Код страны или региона |
Поиск по штату/провинции
Примеры кода
# Также можно использовать wget
curl -X GET https://api.proxylite.com/end-point/ip/dynamic-states/search?country_code=string \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
GET /end-point/ip/dynamic-states/search
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| country_code | query | string | true | Код страны или региона |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "string",
"data": {
"list": [
"string"
]
}
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | Запрос успешен | Inline |
Схема ответа
Status Code 200
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| » code | integer | true | нет | Код состояния, 200 успешно, 3 app_key недействителен, 156 учетная запись не аутентифицирована. |
| » msg | string | true | нет | сообщение о состоянии |
| » data | object | false | нет | none |
| »» list | [string] | false | нет | список |
Получить список назначенных статических IP-адресов центра обработки данных.
Примеры кода
# Также можно использовать wget
curl -X POST https://api.proxylite.com/end-point/ip/get-datacenter-assign-ip-list \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
POST /end-point/ip/get-datacenter-assign-ip-list
Устарело, рекомендуется использовать /openapi/user-product/datacenter-isp-ip-list. Чтобы быть совместимым со старыми клиентами, этот интерфейс использует метод POST, но все параметры фильтрации считываются из запроса.
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| team_id | query | ResourceSpaceId | false | Идентификатор ресурсного пространства; опустите личное пространство или передайте пустую строку; Ключ команды можно опустить и он должен соответствовать ключу при передаче. |
| area | query | string | false | Код страны |
| status | query | integer | false | 0=все, 1=действительно, 2=истёк |
| trade_no | query | string | false | Номер заказа |
| created_at | query | array[string] | false | Чтобы создать временной диапазон, время начала и окончания должно быть передано одновременно. |
Допустимые значения
| Parameter | Value |
|---|---|
| status | 0 |
| status | 1 |
| status | 2 |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {
"total": 0,
"list": [
{
"id": 1,
"ip": "string",
"country_code": "string",
"up_id": 1,
"expired_at": "string",
"created_at": "string",
"country_name_zh_cn": "string",
"country_name_en": "string",
"country_continent_code": "string",
"port": 1
}
]
},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | Запрос успешен | Inline |
Схема ответа
Извлечь приобретенный статический список IP-адресов
Примеры кода
# Также можно использовать wget
curl -X GET https://api.proxylite.com/end-point/ip/get-static-ip \
-H 'Authorization: Bearer {access-token}'
GET /end-point/ip/get-static-ip
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| country_code | query | string | false | Код страны или региона |
| product_type | query | number | false | Тип продукта, 25: Статический жилой IP-адрес, 14: IP-адрес центра обработки данных |
| trade_no | query | string | false | Фильтровать IP по номеру заказа |
| page | query | number | false | Номер страницы |
| size | query | number | false | Количество на странице |
| status | query | number | false | Статус, 1: действителен, 2: недействителен, 3: срок действия истекает, 4: на обслуживании |
Допустимые значения
| Parameter | Value |
|---|---|
| product_type | 14 |
| product_type | 25 |
| status | 1 - 2 - 3 - 4 |
Ответы
| Статус | Значение | Описание | Схема |
|---|
Получите количество статических IP-адресов на продажу в регионе.
Примеры кода
# Также можно использовать wget
curl -X GET https://api.proxylite.com/end-point/ip/static-ip-region \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
GET /end-point/ip/static-ip-region
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| isp | query | integer | false | Фильтрация интернет-провайдера, без фильтрации, если не передается (по умолчанию 1, кроме сайта 1/4/5) |
| asn | query | integer | false | Возвращать ли пакетные данные ASN |
| exclusive | query | integer | false | Учитывать ли по эксклюзивному инвентарю |
Detailed descriptions
isp: Фильтрация интернет-провайдера, без фильтрации, если не передается (по умолчанию 1, кроме сайта 1/4/5)
| ценность | описание |
|---|---|
| 0 | Статический IP-адрес центра обработки данных (IDC) |
| 1 | Домашний статический IP (ISP) |
asn: Возвращать ли пакетные данные ASN
| ценность | описание |
|---|---|
| 0 | Не возвращать пакетные данные ASN (по умолчанию) |
| 1 | Возврат данных пакета ASN |
exclusive: Учитывать ли по эксклюзивному инвентарю
| ценность | описание |
|---|---|
| 0 | Статистика на основе текущего калибра пользователей/групп общего доступа (по умолчанию) |
| 1 | Исключить все назначенные IP-адреса и считать только доступный инвентарь |
Допустимые значения
| Parameter | Value |
|---|---|
| isp | 0 |
| isp | 1 |
| asn | 0 |
| asn | 1 |
| exclusive | 0 |
| exclusive | 1 |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "请求成功",
"data": {
"list": [
{
"code": "US",
"number": 55
}
]
}
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | Запрос успешен | Inline |
Схема ответа
Status Code 200
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| » code | integer | true | нет | Код состояния, 200 успехов |
| » msg | string | true | нет | сообщение о состоянии |
| » data | object | false | нет | none |
| »» list | [any] | false | нет | none |
| »»» code | string | true | нет | Код страны или региона |
| »»» number | integer | true | нет | Количество |
Получить поддерживаемые хостом страны/регионы
Примеры кода
# Также можно использовать wget
curl -X GET https://api.proxylite.com/end-point/host-pool/regions \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
GET /end-point/host-pool/regions
Запросите список стран/регионов, поддерживаемых текущим сайтом службы host_pool.
Этот интерфейс ориентирован на сценарий случайного извлечения IP-адресов центра обработки данных на основе точек трафика и подсчитывает страны/регионы только на основе инвентаризации IP-адресов центра обработки данных, доступной на текущем сайте.
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "请求成功",
"data": {
"list": [
{
"code": "US",
"number": 55,
"name_zh_cn": "美国",
"name_en": "United States",
"square_flag": "https://example.com/static/flags/us.png"
}
]
}
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | Запрос успешен | Inline |
Схема ответа
Status Code 200
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| » code | integer | true | нет | Код состояния, 200 успехов |
| » msg | string | true | нет | сообщение о состоянии |
| » data | object | false | нет | none |
| »» list | [object] | false | нет | none |
| »»» code | string | true | нет | Код страны или региона, ISO 3166-1 альфа-2. |
| »»» number | integer | true | нет | Количество IP-адресов центров обработки данных, доступных на текущем сайте |
| »»» name_zh_cn | string | false | нет | Название страны или региона на китайском языке |
| »»» name_en | string | false | нет | Английское название страны или региона |
| »»» square_flag | string | false | нет | URL-адрес изображения квадратного флага |
Белый список IP-адресов
Белый список IP-адресов (GET /end-point/proxy-ip/list)
Примеры кода
# Также можно использовать wget
curl -X GET https://api.proxylite.com/end-point/proxy-ip/list \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
GET /end-point/proxy-ip/list
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| team_id | query | ResourceSpaceId | false | Идентификатор ресурсного пространства; личное пространство опустить или передать пустую строку |
| product_type | query | integer | false | Номер типа упаковки |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "string",
"data": {
"list": [
{
"ip": "1.1.1.1",
"remark": "string",
"product_type": 0,
"created_at": "string"
}
]
}
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | Запрос успешен | Inline |
Схема ответа
Status Code 200
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| » code | integer | false | нет | Код состояния, 200 успехов |
| » msg | string | false | нет | сообщение о состоянии |
| » data | object | false | нет | none |
| »» list | [object] | false | нет | none |
| »»» ip | string | false | нет | Белый список IP-адресов |
| »»» remark | string | false | нет | Примечания |
| »»» product_type | integer | false | нет | Тип упаковки |
| »»» created_at | string | false | нет | время создания |
Добавить белый список IP-адресов (POST /end-point/proxy-ip/add)
Примеры кода
# Также можно использовать wget
curl -X POST https://api.proxylite.com/end-point/proxy-ip/add \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
POST /end-point/proxy-ip/add
Body parameter
{
"team_id": "A1b2C3d4E5f6",
"app_key": "string",
"ips": "1.1.1.1,2.2.2.2",
"remark": "string",
"product_type": 0,
"user_product_id": 0
}
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| body | body | object | false | нет |
| » team_id | body | any | false | Идентификация пространства государственных ресурсов; опустите team_id или передайте пустую строку при запросе личного пространства и пустую строку при ответе на личное пространство; и число 0, и строка «0» незаконны, а в командном пространстве используется 6-12-значный публичный идентификатор команды. |
| »» anonymous | body | string | false | нет |
| »» anonymous | body | TeamPublicId | false | Публичный логотип команды, первый символ — буква ASCII, остальные символы содержат только буквы и цифры ASCII; числовой первичный ключ базы данных не выдан |
| » app_key | body | string | false | Ключ авторизации |
| » ips | body | string | true | IP-адреса в белый список, которые необходимо добавить, разделяйте несколько запятыми или символами новой строки. |
| » remark | body | string | false | Примечания |
| » product_type | body | integer | false | Номер типа упаковки |
| » user_product_id | body | integer | false | Идентификатор пользовательского пакета, требуется, если тип пакета равен 11. |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "string",
"data": null
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | Запрос успешен | Inline |
Схема ответа
Status Code 200
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| » code | integer | false | нет | Код состояния, 200 успехов |
| » msg | string | false | нет | сообщение о состоянии |
| » data | null | false | нет | none |
Удалить белый список IP-адресов (POST /end-point/proxy-ip/delete)
Примеры кода
# Также можно использовать wget
curl -X POST https://api.proxylite.com/end-point/proxy-ip/delete \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
POST /end-point/proxy-ip/delete
Body parameter
{
"team_id": "A1b2C3d4E5f6",
"app_key": "string",
"ips": "1.1.1.1,2.2.2.2",
"verify_type": "string",
"verify_code": "string"
}
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| body | body | object | false | нет |
| » team_id | body | any | false | Идентификация пространства государственных ресурсов; опустите team_id или передайте пустую строку при запросе личного пространства и пустую строку при ответе на личное пространство; и число 0, и строка «0» незаконны, а в командном пространстве используется 6-12-значный публичный идентификатор команды. |
| »» anonymous | body | string | false | нет |
| »» anonymous | body | TeamPublicId | false | Публичный логотип команды, первый символ — буква ASCII, остальные символы содержат только буквы и цифры ASCII; числовой первичный ключ базы данных не выдан |
| » app_key | body | string | false | Ключ авторизации |
| » ips | body | string | true | Белый список IP-адресов, которые необходимо удалить, несколько через запятую. |
| » verify_type | body | string | false | Тип подтверждения: телефон, электронная почта, wechat, totp |
| » verify_code | body | string | false | Код подтверждения |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "string",
"data": null
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | Запрос успешен | Inline |
Схема ответа
Status Code 200
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| » code | integer | false | нет | Код состояния, 200 успехов |
| » msg | string | false | нет | сообщение о состоянии |
| » data | null | false | нет | none |
Белый список IP-адресов (GET /end-point/white-ip/list)
Примеры кода
# Также можно использовать wget
curl -X GET https://api.proxylite.com/end-point/white-ip/list \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
GET /end-point/white-ip/list
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| team_id | query | ResourceSpaceId | false | Идентификатор ресурсного пространства; личное пространство опустить или передать пустую строку |
| product_type | query | integer | false | Номер типа упаковки |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "string",
"data": {
"list": [
{
"ip": "1.1.1.1",
"remark": "string",
"product_type": 0,
"created_at": "string"
}
]
}
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | Запрос успешен | Inline |
Схема ответа
Status Code 200
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| » code | integer | false | нет | Код состояния, 200 успехов |
| » msg | string | false | нет | сообщение о состоянии |
| » data | object | false | нет | none |
| »» list | [object] | false | нет | none |
| »»» ip | string | false | нет | Белый список IP-адресов |
| »»» remark | string | false | нет | Примечания |
| »»» product_type | integer | false | нет | Тип упаковки |
| »»» created_at | string | false | нет | время создания |
Добавить белый список IP-адресов (POST /end-point/white-ip/add)
Примеры кода
# Также можно использовать wget
curl -X POST https://api.proxylite.com/end-point/white-ip/add \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
POST /end-point/white-ip/add
Body parameter
{
"team_id": "A1b2C3d4E5f6",
"app_key": "string",
"ips": "1.1.1.1,2.2.2.2",
"remark": "string",
"product_type": 0,
"user_product_id": 0
}
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| body | body | object | false | нет |
| » team_id | body | any | false | Идентификация пространства государственных ресурсов; опустите team_id или передайте пустую строку при запросе личного пространства и пустую строку при ответе на личное пространство; и число 0, и строка «0» незаконны, а в командном пространстве используется 6-12-значный публичный идентификатор команды. |
| »» anonymous | body | string | false | нет |
| »» anonymous | body | TeamPublicId | false | Публичный логотип команды, первый символ — буква ASCII, остальные символы содержат только буквы и цифры ASCII; числовой первичный ключ базы данных не выдан |
| » app_key | body | string | false | Ключ авторизации |
| » ips | body | string | true | IP-адреса в белый список, которые необходимо добавить, разделяйте несколько запятыми или символами новой строки. |
| » remark | body | string | false | Примечания |
| » product_type | body | integer | false | Номер типа упаковки |
| » user_product_id | body | integer | false | Идентификатор пользовательского пакета, требуется, если тип пакета равен 11. |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "string",
"data": null
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | Запрос успешен | Inline |
Схема ответа
Status Code 200
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| » code | integer | false | нет | Код состояния, 200 успехов |
| » msg | string | false | нет | сообщение о состоянии |
| » data | null | false | нет | none |
Удалить белый список IP-адресов (POST /end-point/white-ip/delete)
Примеры кода
# Также можно использовать wget
curl -X POST https://api.proxylite.com/end-point/white-ip/delete \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
POST /end-point/white-ip/delete
Body parameter
{
"team_id": "A1b2C3d4E5f6",
"app_key": "string",
"ips": "1.1.1.1,2.2.2.2",
"verify_type": "string",
"verify_code": "string"
}
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| body | body | object | false | нет |
| » team_id | body | any | false | Идентификация пространства государственных ресурсов; опустите team_id или передайте пустую строку при запросе личного пространства и пустую строку при ответе на личное пространство; и число 0, и строка «0» незаконны, а в командном пространстве используется 6-12-значный публичный идентификатор команды. |
| »» anonymous | body | string | false | нет |
| »» anonymous | body | TeamPublicId | false | Публичный логотип команды, первый символ — буква ASCII, остальные символы содержат только буквы и цифры ASCII; числовой первичный ключ базы данных не выдан |
| » app_key | body | string | false | Ключ авторизации |
| » ips | body | string | true | Белый список IP-адресов, которые необходимо удалить, несколько через запятую. |
| » verify_type | body | string | false | Тип подтверждения: телефон, электронная почта, wechat, totp |
| » verify_code | body | string | false | Код подтверждения |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "string",
"data": null
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | Запрос успешен | Inline |
Схема ответа
Status Code 200
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| » code | integer | false | нет | Код состояния, 200 успехов |
| » msg | string | false | нет | сообщение о состоянии |
| » data | null | false | нет | none |
Изменить примечания к белому списку IP-адресов
Примеры кода
# Также можно использовать wget
curl -X POST https://api.proxylite.com/end-point/white-ip/change-remark \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
POST /end-point/white-ip/change-remark
Body parameter
{
"team_id": "A1b2C3d4E5f6",
"ip": "192.168.0.1",
"remark": "string"
}
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| body | body | object | true | нет |
| » team_id | body | any | false | Идентификация пространства государственных ресурсов; опустите team_id или передайте пустую строку при запросе личного пространства и пустую строку при ответе на личное пространство; и число 0, и строка «0» незаконны, а в командном пространстве используется 6-12-значный публичный идентификатор команды. |
| »» anonymous | body | string | false | нет |
| »» anonymous | body | TeamPublicId | false | Публичный логотип команды, первый символ — буква ASCII, остальные символы содержат только буквы и цифры ASCII; числовой первичный ключ базы данных не выдан |
| » ip | body | string(ipv4) | true | нет |
| » remark | body | string | true | нет |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | Операция прошла успешно | WebV1SuccessResponse |
Обновить текущий кэш аутентификации белого списка IP-адресов ресурсного пространства.
Примеры кода
# Также можно использовать wget
curl -X POST https://api.proxylite.com/end-point/white-ip/refresh \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
POST /end-point/white-ip/refresh
Body parameter
{
"team_id": "A1b2C3d4E5f6"
}
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| body | body | object | false | нет |
| » team_id | body | any | false | Идентификация пространства государственных ресурсов; опустите team_id или передайте пустую строку при запросе личного пространства и пустую строку при ответе на личное пространство; и число 0, и строка «0» незаконны, а в командном пространстве используется 6-12-значный публичный идентификатор команды. |
| »» anonymous | body | string | false | нет |
| »» anonymous | body | TeamPublicId | false | Публичный логотип команды, первый символ — буква ASCII, остальные символы содержат только буквы и цифры ASCII; числовой первичный ключ базы данных не выдан |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | Операция прошла успешно | WebV1SuccessResponse |
Квота белого списка IP-адресов для определенных типов продуктов
Примеры кода
# Также можно использовать wget
curl -X GET https://api.proxylite.com/end-point/white-ip/quota?product_type=0 \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
GET /end-point/white-ip/quota
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| team_id | query | ResourceSpaceId | false | нет |
| product_type | query | integer | true | нет |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | Операция прошла успешно | WebV1SuccessResponse |
Квоты белого списка IP-адресов для всех типов продуктов
Примеры кода
# Также можно использовать wget
curl -X GET https://api.proxylite.com/end-point/white-ip/quotas \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
GET /end-point/white-ip/quotas
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| team_id | query | ResourceSpaceId | false | нет |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | Операция прошла успешно | WebV1SuccessResponse |
Запрос журнала трафика
Недавно использованный трафик суммируется по дням
Примеры кода
# Также можно использовать wget
curl -X POST https://api.proxylite.com/end-point/user-usage-flow/days \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
POST /end-point/user-usage-flow/days
Body parameter
{
"team_id": "A1b2C3d4E5f6",
"days": 7,
"product_type": 0,
"username": "string"
}
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| body | body | object | false | нет |
| » team_id | body | any | false | Идентификация пространства государственных ресурсов; опустите team_id или передайте пустую строку при запросе личного пространства и пустую строку при ответе на личное пространство; и число 0, и строка «0» незаконны, а в командном пространстве используется 6-12-значный публичный идентификатор команды. |
| »» anonymous | body | string | false | нет |
| »» anonymous | body | TeamPublicId | false | Публичный логотип команды, первый символ — буква ASCII, остальные символы содержат только буквы и цифры ASCII; числовой первичный ключ базы данных не выдан |
| » days | body | integer | false | нет |
| » product_type | body | integer | false | нет |
| » username | body | string | false | нет |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {
"list": [
{
"days": "2019-08-24",
"flow": 0
}
],
"days": 1
},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | Запрос успешен | Inline |
Схема ответа
Историческое использование трафика учетной записи агента
Примеры кода
# Также можно использовать wget
curl -X POST https://api.proxylite.com/end-point/user-usage-flow/username-total \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
POST /end-point/user-usage-flow/username-total
Body parameter
{
"team_id": "A1b2C3d4E5f6"
}
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| body | body | object | false | нет |
| » team_id | body | any | false | Идентификация пространства государственных ресурсов; опустите team_id или передайте пустую строку при запросе личного пространства и пустую строку при ответе на личное пространство; и число 0, и строка «0» незаконны, а в командном пространстве используется 6-12-значный публичный идентификатор команды. |
| »» anonymous | body | string | false | нет |
| »» anonymous | body | TeamPublicId | false | Публичный логотип команды, первый символ — буква ASCII, остальные символы содержат только буквы и цифры ASCII; числовой первичный ключ базы данных не выдан |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {
"list": [
{
"username": "string",
"flow": 0
}
]
},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | Запрос успешен | Inline |
Схема ответа
Экспортируйте ежемесячное использование трафика аккаунта агентства.
Примеры кода
# Также можно использовать wget
curl -X POST https://api.proxylite.com/end-point/user-usage-flow/export-csv \
-H 'Content-Type: application/json' \
-H 'Accept: text/csv' \
-H 'Authorization: Bearer {access-token}'
POST /end-point/user-usage-flow/export-csv
Body parameter
{
"team_id": "A1b2C3d4E5f6"
}
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| body | body | object | false | нет |
| » team_id | body | any | false | Идентификация пространства государственных ресурсов; опустите team_id или передайте пустую строку при запросе личного пространства и пустую строку при ответе на личное пространство; и число 0, и строка «0» незаконны, а в командном пространстве используется 6-12-значный публичный идентификатор команды. |
| »» anonymous | body | string | false | нет |
| »» anonymous | body | TeamPublicId | false | Публичный логотип команды, первый символ — буква ASCII, остальные символы содержат только буквы и цифры ASCII; числовой первичный ключ базы данных не выдан |
Примеры ответов
Ответ 200
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | CSV-файл в кодировке GBK | string |
Общий объем и остаток пакетного трафика
Примеры кода
# Также можно использовать wget
curl -X GET https://api.proxylite.com/end-point/user-usage-flow/flow-total \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
GET /end-point/user-usage-flow/flow-total
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| team_id | query | ResourceSpaceId | false | нет |
| unit | query | string | false | нет |
Допустимые значения
| Parameter | Value |
|---|---|
| unit | KB |
| unit | MB |
| unit | GB |
| unit | TB |
| unit | PB |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {
"limit": 0,
"total": 0,
"remain": 0,
"unit": "KB",
"timestamp": 0
},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | Запрос успешен | Inline |
Схема ответа
Допустимые значения
| Свойство | Значение |
|---|---|
| unit | KB |
| unit | MB |
| unit | GB |
| unit | TB |
| unit | PB |
График дневной ставки
Примеры кода
# Также можно использовать wget
curl -X GET https://api.proxylite.com/end-point/user-usage-flow/rate-graph \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
GET /end-point/user-usage-flow/rate-graph
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| team_id | query | ResourceSpaceId | false | нет |
| start | query | string(date) | false | нет |
| end | query | string(date) | false | нет |
| username | query | string | false | нет |
| user_product_id | query | integer | false | нет |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {
"list": [
{
"date": "2019-08-24",
"rate": 0,
"corrent": 0
}
]
},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | Запрос успешен | Inline |
Схема ответа
Ежедневная статистика трафика кэша
Примеры кода
# Также можно использовать wget
curl -X GET https://api.proxylite.com/end-point/user-usage-flow/cache-total \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
GET /end-point/user-usage-flow/cache-total
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| team_id | query | ResourceSpaceId | false | нет |
| start_time | query | string | false | нет |
| end_time | query | string | false | нет |
| product_type | query | integer | false | нет |
| username | query | string | false | нет |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {
"list": [
{
"day": "2019-08-24",
"cache_flow": 0,
"cache_reduce_flow": 0
}
]
},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | Запрос успешен | Inline |
Схема ответа
Использование трафика суммируется по дням
Примеры кода
# Также можно использовать wget
curl -X GET https://api.proxylite.com/end-point/user-usage-flow/total?app_key=pa%24%24word \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
GET /end-point/user-usage-flow/total
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| team_id | query | ResourceSpaceId | false | Идентификатор ресурсного пространства; личное пространство опустить или передать пустую строку |
| app_key | query | string(password) | true | Ключ аутентификации |
| start_time | query | string(Y-m-d H:i:s) | false | Время запуска с точностью до секунд. Обратите внимание, что регистрация задерживается в течение 5 минут. По умолчанию – в течение 7 дней. |
| end_time | query | string(Y-m-d H:i:s) | false | Срок с точностью до секунд. Обратите внимание, что регистрация задерживается в течение 5 минут. Текущее время по умолчанию. |
| username | query | string | false | Имя суб-аккаунта, запрос всех аккаунтов по умолчанию, можно указать суб-аккаунт. Обратите внимание: если вы добавите дополнительную учетную запись с тем же именем, этот запрос вернет все записи об использовании учетной записи агента с тем же именем. |
| product_type | query | number | false | Тип упаковки |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "string",
"data": {
"list": [
{
"day": "2022-08-01",
"flow": 0
}
]
}
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | Запрос успешен | Inline |
Схема ответа
Status Code 200
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| » code | integer | true | нет | Код состояния, 200 успешно, 3 app_key недействителен, 156 учетная запись не аутентифицирована. |
| » msg | string | true | нет | сообщение о состоянии |
| » data | object | false | нет | none |
| »» list | [object] | false | нет | none |
| »»» day | string | false | нет | Дата |
| »»» flow | integer | false | нет | Потребление трафика, ед. КБ |
Журнал агента
Статистика доступа к IP-прокси клиента
Примеры кода
# Также можно использовать wget
curl -X GET https://api.proxylite.com/end-point/http-t-dom/list-v2 \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
GET /end-point/http-t-dom/list-v2
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| team_id | query | ResourceSpaceId | false | нет |
| start_time | query | string(date) | false | нет |
| end_time | query | string(date) | false | нет |
| export | query | string | false | нет |
Допустимые значения
| Parameter | Value |
|---|---|
| export | csv |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {
"list": [
{
"visit_count": 0,
"client_ip": "string",
"time": "2019-08-24",
"country_code": "string",
"country": "string"
}
],
"cache": true,
"ttl": 0
},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | статистические результаты JSON; CSV-файл возвращается, когда export=csv | string |
Доля посещений клиентских IP-адресов
Примеры кода
# Также можно использовать wget
curl -X GET https://api.proxylite.com/end-point/http-t-dom/client-ip-proportion \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
GET /end-point/http-t-dom/client-ip-proportion
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| team_id | query | ResourceSpaceId | false | нет |
| start_time | query | string(date) | false | нет |
| end_time | query | string(date) | false | нет |
| export | query | string | false | нет |
Допустимые значения
| Parameter | Value |
|---|---|
| export | csv |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {
"list": [
{
"username": "string",
"client_ip": "string",
"visit_count": 0,
"visit_percentage": "string",
"country": "string",
"country_code": "string"
}
],
"cache": true,
"ttl": 0
},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | Результат пропорции JSON; CSV-файл возвращается, когда export=csv | string |
Запрос пакета
Список купленных пакетов
Примеры кода
# Также можно использовать wget
curl -X GET https://api.proxylite.com/end-point/user-product/list?app_key=pa%24%24word \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
GET /end-point/user-product/list
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| team_id | query | ResourceSpaceId | false | Идентификатор ресурсного пространства; личное пространство опустить или передать пустую строку |
| app_key | query | string(password) | true | Ключ аутентификации |
| trade_no | query | string | false | Номер заказа, пожалуйста, введите полный номер заказа. Нечеткий поиск не поддерживается. |
| page | query | number | false | Пагинация, по умолчанию: 1 |
| size | query | number | false | Количество отображаемых страниц, по умолчанию: 20. |
| product_type | query | number | false | Тип упаковки |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "string",
"data": {
"list": [
{
"id": 0,
"created_at": "2022-05-13 12:14:15",
"expired_at": "2022-05-13 12:14:15",
"product_type": 9,
"trade_no": "2022051312134339861461465434",
"order": {
"created_at": "2022-05-13 12:13:43",
"pay_at": "2022-05-13 12:13:43",
"title": "入门级"
}
}
],
"page": 1,
"page_size": 20,
"total_count": 0,
"total_page": 0
}
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | Запрос успешен | Inline |
Схема ответа
Status Code 200
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| » code | integer | true | нет | Код состояния, 200 успешно, 3 app_key недействителен, 156 учетная запись не аутентифицирована. |
| » msg | string | true | нет | сообщение о состоянии |
| » data | object | false | нет | none |
| »» list | [object] | false | нет | none |
| »»» id | integer | false | нет | Номер пакета |
| »»» created_at | string | false | нет | Срок действия пакета |
| »»» expired_at | string | false | нет | Срок годности пакета. По истечении срока использовать трафик невозможно. |
| »»» product_type | productTypes | false | нет | Тип пакета, 9 пакетов динамического трафика для жилых помещений, 11 динамических IP для жилых помещений, 14 статических IP-адресов для центров обработки данных, 25 статических IP-адресов для жилых помещений |
| »»» trade_no | string | false | нет | Номер транзакции заказа |
| »»» order | object | false | нет | none |
| »»»» created_at | string | false | нет | Время создания заказа |
| »»»» pay_at | string | false | нет | Срок оплаты заказа |
| »»»» title | string | false | нет | Описание заказа |
| »» page | integer | true | нет | Текущая страница |
| »» page_size | integer | false | нет | размер страницы |
| »» total_count | integer | false | нет | Общее количество записей |
| »» total_page | integer | false | нет | Общее количество страниц |
Допустимые значения
| Свойство | Значение |
|---|---|
| product_type | 9 |
| product_type | 11 |
| product_type | 14 |
| product_type | 25 |
Сводка данных пользовательского пакета
Примеры кода
# Также можно использовать wget
curl -X GET https://api.proxylite.com/end-point/user-product/summary?app_key=pa%24%24word \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
GET /end-point/user-product/summary
Получите сводную статистическую информацию о пользовательских пакетах, включая общую сумму, эффективную сумму, предстоящую сумму, сумму с истекшим сроком действия и т. д.
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| team_id | query | ResourceSpaceId | false | Идентификатор ресурсного пространства; личное пространство опустить или передать пустую строку |
| app_key | query | string(password) | true | Ключ аутентификации |
| product_type | query | integer | false | Тип продукта, поддерживает только 9 (пакет динамического трафика), 12 (пакет долгосрочного трафика IDC) |
Допустимые значения
| Parameter | Value |
|---|---|
| product_type | 9 |
| product_type | 12 |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "成功",
"data": {
"total": 1048576,
"total_count": 5,
"effective": 524288,
"effective_count": 3,
"effective_total": 786432,
"effective_used": 262144,
"temporary": 102400,
"temporary_count": 1,
"expired": 51200,
"expired_count": 1,
"used": 473088
}
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | Запрос успешен | Inline |
Схема ответа
Status Code 200
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| » code | integer | false | нет | Код состояния, 200 успешно, 3 app_key недействителен, 156 учетная запись не аутентифицирована. |
| » msg | string | false | нет | сообщение о состоянии |
| » data | object | false | нет | none |
| »» total | integer | false | нет | Трафик/общий объем IP (единица измерения: КБ) |
| »» total_count | integer | false | нет | Общее количество упаковок |
| »» effective | integer | false | нет | Эффективная оставшаяся сумма (единица измерения: КБ) |
| »» effective_count | integer | false | нет | Количество действительных пакетов |
| »» effective_total | integer | false | нет | Эффективная общая сумма (единица измерения: КБ) |
| »» effective_used | integer | false | нет | Используемая эффективная сумма (единица измерения: КБ) |
| »» temporary | integer | false | нет | Общая сумма к оплате (к оплате в течение 7 дней, единица измерения: КБ) |
| »» temporary_count | integer | false | нет | Количество пакетов с истекающим сроком действия (срок действия – 7 дней) |
| »» expired | integer | false | нет | Оставшаяся сумма с истекшим сроком действия (единица измерения: КБ) |
| »» expired_count | integer | false | нет | Количество просроченных упаковок |
| »» used | integer | false | нет | Общий использованный объем (единица измерения: КБ) |
Статический список IP-адресов
Примеры кода
# Также можно использовать wget
curl -X POST https://api.proxylite.com/end-point/user-product/datacenter-isp-ip-list \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
POST /end-point/user-product/datacenter-isp-ip-list
Body parameter
{
"team_id": "A1b2C3d4E5f6",
"status": 0,
"page": 1,
"size": 20,
"user_product_id": 1,
"country_code": "string",
"product_type": 0,
"ip": "192.168.0.1",
"auto_renewal": 0,
"support_renewal": 0,
"remaining_days": 0,
"limit_days": 0,
"sort": "exp_asc",
"remark": "string"
}
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| body | body | object | false | нет |
| » team_id | body | any | false | Идентификация пространства государственных ресурсов; опустите team_id или передайте пустую строку при запросе личного пространства и пустую строку при ответе на личное пространство; и число 0, и строка «0» незаконны, а в командном пространстве используется 6-12-значный публичный идентификатор команды. |
| »» anonymous | body | string | false | нет |
| »» anonymous | body | TeamPublicId | false | Публичный логотип команды, первый символ — буква ASCII, остальные символы содержат только буквы и цифры ASCII; числовой первичный ключ базы данных не выдан |
| » status | body | integer | false | нет |
| » page | body | integer | false | нет |
| » size | body | integer | false | нет |
| » user_product_id | body | integer | false | нет |
| » country_code | body | string | false | нет |
| » product_type | body | integer | false | нет |
| » ip | body | string(ipv4) | false | нет |
| » auto_renewal | body | integer | false | нет |
| » support_renewal | body | integer | false | нет |
| » remaining_days | body | integer | false | нет |
| » limit_days | body | integer | false | нет |
| » sort | body | string | false | нет |
| » remark | body | string | false | нет |
Допустимые значения
| Parameter | Value |
|---|---|
| » auto_renewal | 0 |
| » auto_renewal | 1 |
| » support_renewal | 0 |
| » support_renewal | 1 |
| » sort | exp_asc |
| » sort | exp_desc |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | Операция прошла успешно | WebV1SuccessResponse |
Удалить просроченные пакеты
Примеры кода
# Также можно использовать wget
curl -X POST https://api.proxylite.com/end-point/user-product/delete \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
POST /end-point/user-product/delete
Body parameter
{
"team_id": "A1b2C3d4E5f6",
"id": 1
}
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| body | body | object | true | нет |
| » team_id | body | any | false | Идентификация пространства государственных ресурсов; опустите team_id или передайте пустую строку при запросе личного пространства и пустую строку при ответе на личное пространство; и число 0, и строка «0» незаконны, а в командном пространстве используется 6-12-значный публичный идентификатор команды. |
| »» anonymous | body | string | false | нет |
| »» anonymous | body | TeamPublicId | false | Публичный логотип команды, первый символ — буква ASCII, остальные символы содержат только буквы и цифры ASCII; числовой первичный ключ базы данных не выдан |
| » id | body | integer | true | нет |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | Операция прошла успешно | WebV1SuccessResponse |
Удаление пакетов с истекшим сроком действия в пакетном режиме
Примеры кода
# Также можно использовать wget
curl -X POST https://api.proxylite.com/end-point/user-product/batch-delete \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
POST /end-point/user-product/batch-delete
Body parameter
{
"team_id": "A1b2C3d4E5f6",
"ids": [
1
]
}
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| body | body | object | true | нет |
| » team_id | body | any | false | Идентификация пространства государственных ресурсов; опустите team_id или передайте пустую строку при запросе личного пространства и пустую строку при ответе на личное пространство; и число 0, и строка «0» незаконны, а в командном пространстве используется 6-12-значный публичный идентификатор команды. |
| »» anonymous | body | string | false | нет |
| »» anonymous | body | TeamPublicId | false | Публичный логотип команды, первый символ — буква ASCII, остальные символы содержат только буквы и цифры ASCII; числовой первичный ключ базы данных не выдан |
| » ids | body | [integer] | true | нет |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | Операция прошла успешно | WebV1SuccessResponse |
Изменить примечания к пакету
Примеры кода
# Также можно использовать wget
curl -X POST https://api.proxylite.com/end-point/user-product/change-remark \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
POST /end-point/user-product/change-remark
Body parameter
{
"team_id": "A1b2C3d4E5f6",
"id": 1,
"remark": "string"
}
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| body | body | object | true | нет |
| » team_id | body | any | false | Идентификация пространства государственных ресурсов; опустите team_id или передайте пустую строку при запросе личного пространства и пустую строку при ответе на личное пространство; и число 0, и строка «0» незаконны, а в командном пространстве используется 6-12-значный публичный идентификатор команды. |
| »» anonymous | body | string | false | нет |
| »» anonymous | body | TeamPublicId | false | Публичный логотип команды, первый символ — буква ASCII, остальные символы содержат только буквы и цифры ASCII; числовой первичный ключ базы данных не выдан |
| » id | body | integer | true | нет |
| » remark | body | string | true | нет |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | Операция прошла успешно | WebV1SuccessResponse |
Пакетная установка статических IP-переключателей UDP.
Примеры кода
# Также можно использовать wget
curl -X POST https://api.proxylite.com/end-point/user-product/set-ip-udp \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
POST /end-point/user-product/set-ip-udp
Body parameter
{
"team_id": "A1b2C3d4E5f6",
"ids": [
1
],
"udp": 0
}
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| body | body | object | true | нет |
| » team_id | body | any | false | Идентификация пространства государственных ресурсов; опустите team_id или передайте пустую строку при запросе личного пространства и пустую строку при ответе на личное пространство; и число 0, и строка «0» незаконны, а в командном пространстве используется 6-12-значный публичный идентификатор команды. |
| »» anonymous | body | string | false | нет |
| »» anonymous | body | TeamPublicId | false | Публичный логотип команды, первый символ — буква ASCII, остальные символы содержат только буквы и цифры ASCII; числовой первичный ключ базы данных не выдан |
| » ids | body | [integer] | true | нет |
| » udp | body | integer | true | нет |
Допустимые значения
| Parameter | Value |
|---|---|
| » udp | 0 |
| » udp | 1 |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | Операция прошла успешно | WebV1SuccessResponse |
Управление пакетами
Изменить статический IP-адрес интернет-провайдера центра обработки данных
Примеры кода
# Также можно использовать wget
curl -X POST https://api.proxylite.com/end-point/user-product/change-datacenter-isp-ip \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
POST /end-point/user-product/change-datacenter-isp-ip
Body parameter
{
"team_id": "A1b2C3d4E5f6",
"id": 1,
"country_code": "string",
"ip": "string"
}
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| body | body | object | true | нет |
| » team_id | body | any | false | Идентификация пространства государственных ресурсов; опустите team_id или передайте пустую строку при запросе личного пространства и пустую строку при ответе на личное пространство; и число 0, и строка «0» незаконны, а в командном пространстве используется 6-12-значный публичный идентификатор команды. |
| »» anonymous | body | string | false | нет |
| »» anonymous | body | TeamPublicId | false | Публичный логотип команды, первый символ — буква ASCII, остальные символы содержат только буквы и цифры ASCII; числовой первичный ключ базы данных не выдан |
| » id | body | integer | true | Идентификатор пользовательского плана |
| » country_code | body | string | false | Код целевой страны/региона; если не указано, то в первую очередь будет использоваться текущая страна/регион IP. |
| » ip | body | string | false | Фильтрация префикса IP-адреса назначения |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {
"ip_id": 1,
"ip": "string",
"country_code": "string"
},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | Запрос успешен | Inline |
Схема ответа
Получить статические записи замены IP-адресов
Примеры кода
# Также можно использовать wget
curl -X GET https://api.proxylite.com/end-point/user-product/ip-change-log \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
GET /end-point/user-product/ip-change-log
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| team_id | query | ResourceSpaceId | false | Идентификатор ресурсного пространства; личное пространство опустить или передать пустую строку |
| page | query | integer | false | нет |
| page_size | query | integer | false | нет |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {
"list": [
{
"old": "string",
"new": "string",
"created_at": "string",
"created_timestamp": 0
}
],
"page": 1,
"page_size": 1,
"total_count": 0,
"page_count": 0
},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | Запрос успешен | Inline |
Схема ответа
Установите переключатель автоматического продления для одного пакета.
Примеры кода
# Также можно использовать wget
curl -X POST https://api.proxylite.com/end-point/user-product/set-auto-renewal \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
POST /end-point/user-product/set-auto-renewal
Body parameter
{
"team_id": "A1b2C3d4E5f6",
"user_product_id": 1,
"status": 0
}
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| body | body | object | true | нет |
| » team_id | body | any | false | Идентификация пространства государственных ресурсов; опустите team_id или передайте пустую строку при запросе личного пространства и пустую строку при ответе на личное пространство; и число 0, и строка «0» незаконны, а в командном пространстве используется 6-12-значный публичный идентификатор команды. |
| »» anonymous | body | string | false | нет |
| »» anonymous | body | TeamPublicId | false | Публичный логотип команды, первый символ — буква ASCII, остальные символы содержат только буквы и цифры ASCII; числовой первичный ключ базы данных не выдан |
| » user_product_id | body | integer | true | нет |
| » status | body | integer | false | 0=отключить, 1=включить |
Допустимые значения
| Parameter | Value |
|---|---|
| » status | 0 |
| » status | 1 |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {
"id": 1
},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | Запрос успешен | Inline |
Схема ответа
Установите переключатель автоматического продления для пакетов в пакетном режиме.
Примеры кода
# Также можно использовать wget
curl -X POST https://api.proxylite.com/end-point/user-product/batch-set-auto-renewal \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
POST /end-point/user-product/batch-set-auto-renewal
Body parameter
{
"team_id": "A1b2C3d4E5f6",
"user_product_ids": [
1
],
"status": 0
}
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| body | body | object | true | нет |
| » team_id | body | any | false | Идентификация пространства государственных ресурсов; опустите team_id или передайте пустую строку при запросе личного пространства и пустую строку при ответе на личное пространство; и число 0, и строка «0» незаконны, а в командном пространстве используется 6-12-значный публичный идентификатор команды. |
| »» anonymous | body | string | false | нет |
| »» anonymous | body | TeamPublicId | false | Публичный логотип команды, первый символ — буква ASCII, остальные символы содержат только буквы и цифры ASCII; числовой первичный ключ базы данных не выдан |
| » user_product_ids | body | [integer] | true | нет |
| » status | body | integer | false | 0=отключить, 1=включить |
Допустимые значения
| Parameter | Value |
|---|---|
| » status | 0 |
| » status | 1 |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {
"results": [
{
"user_product_id": 1,
"success": true,
"id": 1
}
]
},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | Запрос успешен; каждый пакет независимо возвращает результаты обработки. | Inline |
Схема ответа
Установите параметры автоматического продления по умолчанию для типов продуктов
Примеры кода
# Также можно использовать wget
curl -X POST https://api.proxylite.com/end-point/user-product/set-auto-renewal-default-config \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
POST /end-point/user-product/set-auto-renewal-default-config
Пропустите хотя бы один из дней_до_истечения, трафика_порога, продления_цикла_дней; значение 0 означает сброс соответствующей конфигурации.
Body parameter
{
"team_id": "A1b2C3d4E5f6",
"product_type": 9,
"days_before_expire": 30,
"traffic_threshold": 100,
"renewal_cycle_days": 0
}
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| body | body | object | true | нет |
| » team_id | body | any | false | Идентификация пространства государственных ресурсов; опустите team_id или передайте пустую строку при запросе личного пространства и пустую строку при ответе на личное пространство; и число 0, и строка «0» незаконны, а в командном пространстве используется 6-12-значный публичный идентификатор команды. |
| »» anonymous | body | string | false | нет |
| »» anonymous | body | TeamPublicId | false | Публичный логотип команды, первый символ — буква ASCII, остальные символы содержат только буквы и цифры ASCII; числовой первичный ключ базы данных не выдан |
| » product_type | body | integer | true | нет |
| » days_before_expire | body | integer | false | нет |
| » traffic_threshold | body | integer | false | Единицы ГБ, поддерживается только 12.09.24. |
| » renewal_cycle_days | body | integer | false | Поддерживается только 14.11.16.25 и должен соответствовать текущему циклу продаж продукта. |
| » anonymous | body | object | false | нет |
| » anonymous | body | object | false | нет |
| » anonymous | body | object | false | нет |
Допустимые значения
| Parameter | Value |
|---|---|
| » product_type | 9 |
| » product_type | 11 |
| » product_type | 12 |
| » product_type | 14 |
| » product_type | 16 |
| » product_type | 24 |
| » product_type | 25 |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": null,
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | Запрос успешен, данные пустые | Inline |
Схема ответа
Получите параметры автоматического продления по умолчанию для типа продукта.
Примеры кода
# Также можно использовать wget
curl -X POST https://api.proxylite.com/end-point/user-product/get-auto-renewal-default-config \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
POST /end-point/user-product/get-auto-renewal-default-config
Body parameter
{
"team_id": "A1b2C3d4E5f6",
"product_type": 9
}
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| body | body | object | false | нет |
| » team_id | body | any | false | Идентификация пространства государственных ресурсов; опустите team_id или передайте пустую строку при запросе личного пространства и пустую строку при ответе на личное пространство; и число 0, и строка «0» незаконны, а в командном пространстве используется 6-12-значный публичный идентификатор команды. |
| »» anonymous | body | string | false | нет |
| »» anonymous | body | TeamPublicId | false | Публичный логотип команды, первый символ — буква ASCII, остальные символы содержат только буквы и цифры ASCII; числовой первичный ключ базы данных не выдан |
| » product_type | body | integer | false | Если не передать, будут возвращены все поддерживаемые типы. |
Допустимые значения
| Parameter | Value |
|---|---|
| » product_type | 9 |
| » product_type | 11 |
| » product_type | 12 |
| » product_type | 14 |
| » product_type | 16 |
| » product_type | 24 |
| » product_type | 25 |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {
"configs": [
{
"product_type": 9,
"days_before_expire": 0,
"source": "user",
"renewal_cycle": {
"days": 1,
"unit": "day",
"source": "user"
},
"traffic_threshold": 0,
"traffic_source": "user"
}
]
},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | Запрос успешен | Inline |
Схема ответа
Допустимые значения
| Свойство | Значение |
|---|---|
| product_type | 9 |
| product_type | 11 |
| product_type | 12 |
| product_type | 14 |
| product_type | 16 |
| product_type | 24 |
| product_type | 25 |
| source | user |
| source | system |
| source | user |
| source | system |
| traffic_source | user |
| traffic_source | system |
Получите конфигурацию автоматического продления и предварительный просмотр продления для одного пакета.
Примеры кода
# Также можно использовать wget
curl -X POST https://api.proxylite.com/end-point/user-product/get-auto-renewal \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
POST /end-point/user-product/get-auto-renewal
Body parameter
{
"team_id": "A1b2C3d4E5f6",
"user_product_id": 1
}
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| body | body | object | true | нет |
| » team_id | body | any | false | Идентификация пространства государственных ресурсов; опустите team_id или передайте пустую строку при запросе личного пространства и пустую строку при ответе на личное пространство; и число 0, и строка «0» незаконны, а в командном пространстве используется 6-12-значный публичный идентификатор команды. |
| »» anonymous | body | string | false | нет |
| »» anonymous | body | TeamPublicId | false | Публичный логотип команды, первый символ — буква ASCII, остальные символы содержат только буквы и цифры ASCII; числовой первичный ключ базы данных не выдан |
| » user_product_id | body | integer | true | нет |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {
"expired_at": "string",
"time_days": 0,
"time_unit": "day",
"next_expired_at": "string",
"agreed_price": 0,
"currency": "string",
"config": {
"id": 1,
"user_id": 1,
"team_id": "A1b2C3d4E5f6",
"team_user_id": 0,
"product_type": 0,
"left_traffic": 0,
"left_days": 0,
"user_product_id": 1,
"product_id": 0,
"status": 0,
"currency": "string",
"agreed_price": 0,
"agreed_bandwidth_price": 0,
"agreed_concurrency_price": 0,
"bandwidth_id": 0,
"concurrency_id": 0,
"duration": 0,
"renew_product_id": 0,
"days_before_expire": 0,
"traffic_threshold": 0,
"parent_product_type": 0,
"created_at": "string",
"updated_at": "string"
},
"traffic_threshold": 0
},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | Запрос успешен | Inline |
Схема ответа
Допустимые значения
| Свойство | Значение |
|---|---|
| time_unit | day |
| time_unit | hour |
| status | 0 |
| status | 1 |
Получайте записи выполнения автоматического продления
Примеры кода
# Также можно использовать wget
curl -X POST https://api.proxylite.com/end-point/user-product/auto-renewal-logs \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
POST /end-point/user-product/auto-renewal-logs
Body parameter
{
"team_id": "A1b2C3d4E5f6",
"user_product_id": 1,
"page": 1,
"size": 20
}
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| body | body | object | false | нет |
| » team_id | body | any | false | Идентификация пространства государственных ресурсов; опустите team_id или передайте пустую строку при запросе личного пространства и пустую строку при ответе на личное пространство; и число 0, и строка «0» незаконны, а в командном пространстве используется 6-12-значный публичный идентификатор команды. |
| »» anonymous | body | string | false | нет |
| »» anonymous | body | TeamPublicId | false | Публичный логотип команды, первый символ — буква ASCII, остальные символы содержат только буквы и цифры ASCII; числовой первичный ключ базы данных не выдан |
| » user_product_id | body | integer | false | Если не передать, будут запрошены все записи в текущем пространстве. |
| » page | body | integer | false | нет |
| » size | body | integer | false | нет |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {
"list": [
{
"id": 1,
"user_id": 1,
"team_id": "A1b2C3d4E5f6",
"team_user_id": 0,
"config_id": 0,
"user_product_id": 1,
"product_type": 0,
"renew_product_id": 0,
"order_id": 0,
"fee": 0,
"currency": "string",
"before_expired_at": "string",
"after_expired_at": "string",
"before_remain": 0,
"after_remain": 0,
"trigger_type": 0,
"status": 1,
"revoke_at": "string",
"revoke_remark": "string",
"created_at": "string",
"updated_at": "string"
}
],
"page": 1,
"page_size": 1,
"total_page": 0,
"total_count": 0
},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | Запрос успешен | Inline |
Схема ответа
Допустимые значения
| Свойство | Значение |
|---|---|
| trigger_type | 0 |
| trigger_type | 1 |
| status | 1 |
| status | 2 |
| status | 3 |
Управление платежами
Поднять оплату заказа
Примеры кода
# Также можно использовать wget
curl -X POST https://api.proxylite.com/end-point/pay?trade_no=string \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
POST /end-point/pay
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| team_id | query | ResourceSpaceId | false | нет |
| trade_no | query | string | true | нет |
| pm_id | query | integer | false | нет |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | Операция прошла успешно | WebV1SuccessResponse |
Инициировать оплату неоплаченных заказов, оформленных в фоновом режиме
Примеры кода
# Также можно использовать wget
curl -X POST https://api.proxylite.com/end-point/pay/index-choose \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
POST /end-point/pay/index-choose
Body parameter
{
"team_id": "A1b2C3d4E5f6",
"trade_no": "string",
"pay_method": 0,
"pm_id": 0,
"trade_type": "string"
}
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| body | body | object | true | нет |
| » team_id | body | any | false | Идентификация пространства государственных ресурсов; опустите team_id или передайте пустую строку при запросе личного пространства и пустую строку при ответе на личное пространство; и число 0, и строка «0» незаконны, а в командном пространстве используется 6-12-значный публичный идентификатор команды. |
| »» anonymous | body | string | false | нет |
| »» anonymous | body | TeamPublicId | false | Публичный логотип команды, первый символ — буква ASCII, остальные символы содержат только буквы и цифры ASCII; числовой первичный ключ базы данных не выдан |
| » trade_no | body | string | true | нет |
| » pay_method | body | integer | false | нет |
| » pm_id | body | integer | false | нет |
| » trade_type | body | string | false | нет |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | Операция прошла успешно | WebV1SuccessResponse |
Предварительный просмотр комиссии за контрольную сумму оплаты
Примеры кода
# Также можно использовать wget
curl -X POST https://api.proxylite.com/end-point/pay/pay-check?trade_no=string \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
POST /end-point/pay/pay-check
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| team_id | query | ResourceSpaceId | false | нет |
| trade_no | query | string | true | нет |
| pm_id | query | integer | false | нет |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {
"trade_no": "string",
"pm_id": 0,
"pay_method": 0,
"trade_type": "string",
"country_code": "string",
"currency": "string",
"goods_fee": 0,
"discount_fee": 0,
"handling_fee": 0,
"pay_fee": 0,
"total_fee": 0,
"pay_method_info": {
"id": 0,
"type": 0,
"title": "string",
"group": "string",
"handling_rate": 0,
"handling_fee": 0,
"handling_fee_currency": "usd",
"handling_fee_converted": 0
},
"origin": {
"pm_id": 0,
"pay_method": 0,
"goods_fee": 0,
"discount_fee": 0,
"handling_fee": 0,
"pay_fee": 0,
"total_fee": 0
}
},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | Запрос успешен | Inline |
Схема ответа
Непосредственно отображать страницу веб-платежей
Примеры кода
# Также можно использовать wget
curl -X GET https://api.proxylite.com/end-point/pay/web-direct-pay?trade_no=string \
-H 'Accept: text/html' \
-H 'Authorization: Bearer {access-token}'
GET /end-point/pay/web-direct-pay
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| team_id | query | ResourceSpaceId | false | нет |
| trade_no | query | string | true | нет |
| pm_id | query | integer | false | нет |
Примеры ответов
Ответ 200
"string"
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | HTML-страница оплаты | string |
Получить список способов оплаты (GET /end-point/payment/list)
Примеры кода
# Также можно использовать wget
curl -X GET https://api.proxylite.com/end-point/payment/list \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
GET /end-point/payment/list
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| trade_no | query | string | false | Номер заказа — можно передать, если для некоторых заказов требуется определенный способ оплаты. |
| currency | query | string | false | денежная единица |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {
"list": [
{
"id": 0,
"title": "string",
"logo": "string",
"group": "string",
"handling_rate": 0,
"handling_fee": 0,
"disabled": false,
"min": 0,
"max": 0
}
]
},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | добиться успеха | Inline |
Схема ответа
Получить список способов оплаты (GET /end-point/payment/groups)
Примеры кода
# Также можно использовать wget
curl -X GET https://api.proxylite.com/end-point/payment/groups \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
GET /end-point/payment/groups
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| trade_no | query | string | false | Номер заказа — можно передать, если для некоторых заказов требуется определенный способ оплаты. |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {
"list": [
{
"name": "string",
"logos": [
"string"
],
"items": [
{
"id": 0,
"title": "string",
"logo": "string",
"group": "string",
"disabled": false,
"min": 0,
"max": 0
}
]
}
]
},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | добиться успеха | Inline |
Схема ответа
Маркетинг
Коэффициент бонуса пополнения счета
Примеры кода
# Также можно использовать wget
curl -X GET https://api.proxylite.com/end-point/activity/balance-recharge-gift-ratio \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
GET /end-point/activity/balance-recharge-gift-ratio
Коэффициент бонуса пополнения счета
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": {
"list": [
null
]
},
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | OK | Inline |
Схема ответа
Продукты
Список продуктов
Примеры кода
# Также можно использовать wget
curl -X GET https://api.proxylite.com/end-point/product \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
GET /end-point/product
Получите список пакетов, доступных для покупки на текущем сайте, и поддержите фильтрацию по типу, сроку действия и другим условиям.
Параметры
| Имя | Расположение | Тип | Обязательно | Описание |
|---|---|---|---|---|
| type | query | integer | false | Тип упаковки см. в описании перечисления Product.type. Если не передать, будут возвращены все типы. |
| parent_product_type | query | integer | false | Тип родительского пакета, действителен только при типе = 19 (продление IP-адреса), используется для фильтрации линеек продуктов: 14 = центр обработки данных 25 = жилой дом. |
| time_days | query | any | false | Фильтрация периода действия, поддерживает одно значение или массив, например 30 / [30,90,365] |
| show_type | query | any | false | Фильтрация типов отображения, поддерживает одно значение или массив. |
Допустимые значения
| Parameter | Value |
|---|---|
| parent_product_type | 14 |
| parent_product_type | 25 |
Примеры ответов
Ответ 200
{
"code": 200,
"msg": "SUCCESS",
"data": [
{
"id": 0,
"title": "string",
"type": 0,
"show_type": 0,
"status": 0,
"price": 0.1,
"usd_price": 0.1,
"price_hkd": 0.1,
"original_price": 0.1,
"original_usd_price": 0.1,
"original_price_hkd": 0.1,
"local_price": 0.1,
"local_original_price": 0.1,
"preferred_currency": "string",
"support_currencies": "string",
"flow_value": 0.1,
"flow_give": 0.1,
"balance_give": 0.1,
"balance_value": 0.1,
"time_validity": 0.1,
"time_price": 0.1,
"time_days": 0,
"tip1": "string",
"tip2": "string",
"introduce": [
"string"
],
"region_list_id": 0,
"renew_product_list": "string",
"parent_product_type": 0,
"total_count": 0,
"remain_count": 0,
"extension_of_time_days": [
0
],
"time_days_price_rate": 0.1,
"desc": {
"subtitle": "string",
"flow_value": 0.1,
"flow_give": 0.1,
"balance_give": 0.1,
"time_validity": 0.1,
"time_price": 0.1,
"tip1": "string",
"tip2": "string",
"introduce": [
"string"
]
},
"sku": {
"bandwidth_list": [
{
"id": 0,
"value": 0,
"price": 0.1,
"price_usd": 0.1,
"price_hkd": 0.1
}
],
"duration_list": [
{
"id": 0,
"value": 0,
"price": 0.1,
"price_usd": 0.1,
"price_hkd": 0.1
}
],
"concurrency_list": [
{
"id": 0,
"value": 0,
"price": 0.1,
"price_usd": 0.1,
"price_hkd": 0.1
}
]
}
}
],
"request_id": "string"
}
Ответы
| Статус | Значение | Описание | Схема |
|---|---|---|---|
| 200 | OK | OK | Inline |
Схема ответа
Схемы
OpenApiAccountProfile
{
"id": 0,
"username": "string",
"nickname": "string",
"email": "string",
"balance": "string",
"gift_balance": "string",
"currency": "string",
"language": "string",
"timezone": "string"
}
Свойства
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| id | integer | true | нет | Идентификатор пользователя |
| username | string | true | нет | Имя пользователя |
| nickname | string | true | нет | Псевдоним |
| string | true | нет | Привязать электронную почту | |
| balance | string | true | нет | Баланс пополнения, десятичная строка |
| gift_balance | string | true | нет | Текущий бонусный баланс, десятичная строка |
| currency | string | true | нет | Валюта сайта |
| language | string | true | нет | Язык пользователя, язык сайта используется, если не настроен |
| timezone | string | true | нет | Часовой пояс пользователя, используйте часовой пояс сайта, если не настроено |
OpenApiBalanceRecord
{
"id": 0,
"re_type": 0,
"transaction_type": 0,
"balance_type": 0,
"fee": "string"
}
Свойства
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| id | integer,string | false | нет | Значения базы данных могут быть сериализованы как строки. |
| re_type | integer,string | false | нет | 0 расходов, 1 доходов |
| transaction_type | integer,string | false | нет | тип транзакции |
| balance_type | integer,string | false | нет | Тип баланса |
| fee | string,number | false | нет | Изменить сумму, валюту сайта |
OpenApiLogExportTask
{
"id": 0,
"user_id": 0,
"start_time": "string",
"end_time": "string",
"status": "pending",
"file_size": 0,
"record_count": 0,
"created_at": "string",
"completed_at": "string",
"file_url": "string",
"download_url": "string",
"error_message": "string"
}
Свойства
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| id | integer,string | false | нет | Значения базы данных могут быть сериализованы как строки. |
| user_id | integer,string | false | нет | Детальный интерфейс возвращает |
| start_time | string | false | нет | Г-м-д Ч:и:с; дата, отличная от RFC 3339 |
| end_time | string | false | нет | Г-м-д Ч:и:с; дата, отличная от RFC 3339 |
| status | string | false | нет | none |
| file_size | integer,string,null | false | нет | none |
| record_count | integer,string,null | false | нет | none |
| created_at | string | false | нет | Г-м-д Ч:и:с; дата, отличная от RFC 3339 |
| completed_at | string | false | нет | Г-м-д Ч:и:с; дата, отличная от RFC 3339 |
| file_url | string | false | нет | После завершения возвращается подробный интерфейс. |
| download_url | string | false | нет | Возврат после завершения, адрес загрузки подписи действителен в течение 24 часов. |
| error_message | string | false | нет | В случае сбоя интерфейс сведений может вернуться |
Допустимые значения
| Свойство | Значение |
|---|---|
| status | pending |
| status | processing |
| status | completed |
| status | failed |
| status | canceled |
| status | no_data |
OpenApiCoupon
{
"id": 0,
"coupon_id": 0,
"type": 0,
"status": 0,
"source": 0,
"title": "string",
"title_en": "string",
"description": "string",
"description_en": "string",
"start_amount": "string",
"start_amount_usd": "string",
"start_amount_hkd": "string",
"deduction_amount": "string",
"deduction_amount_usd": "string",
"deduction_amount_hkd": "string",
"discount_rate": "string",
"discount_ceiling_amount": "string",
"discount_ceiling_amount_usd": "string",
"discount_ceiling_amount_hkd": "string",
"created_at": "string",
"effect_at": "string",
"expired_at": "string",
"used_at": "string",
"product_types": "string",
"created_timestamp": 0,
"effect_timestamp": 0,
"expired_timestamp": 0,
"used_timestamp": 0,
"is_expired": true
}
Свойства
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| id | integer,string | false | нет | Значения базы данных могут быть сериализованы как строки. |
| coupon_id | integer,string | false | нет | Значения базы данных могут быть сериализованы как строки. |
| type | integer,string | false | нет | Значения базы данных могут быть сериализованы как строки. |
| status | integer,string | false | нет | Значения базы данных могут быть сериализованы как строки. |
| source | integer,string | false | нет | Значения базы данных могут быть сериализованы как строки. |
| title | string | false | нет | none |
| title_en | string | false | нет | none |
| description | string | false | нет | none |
| description_en | string | false | нет | none |
| start_amount | string,number,null | false | нет | none |
| start_amount_usd | string,number,null | false | нет | none |
| start_amount_hkd | string,number,null | false | нет | none |
| deduction_amount | string,number,null | false | нет | none |
| deduction_amount_usd | string,number,null | false | нет | none |
| deduction_amount_hkd | string,number,null | false | нет | none |
| discount_rate | string,number,null | false | нет | none |
| discount_ceiling_amount | string,number,null | false | нет | none |
| discount_ceiling_amount_usd | string,number,null | false | нет | none |
| discount_ceiling_amount_hkd | string,number,null | false | нет | none |
| created_at | string,null | false | нет | Y-m-d H:i:s |
| effect_at | string,null | false | нет | Y-m-d H:i:s |
| expired_at | string,null | false | нет | Y-m-d H:i:s |
| used_at | string,null | false | нет | Y-m-d H:i:s |
| product_types | string,null | false | нет | Применимые типы пакетов |
| created_timestamp | integer,null | false | нет | none |
| effect_timestamp | integer,null | false | нет | none |
| expired_timestamp | integer,null | false | нет | none |
| used_timestamp | integer,null | false | нет | none |
| is_expired | boolean | false | нет | Возвращает интерфейс списка |
OpenApiNotification
{
"id": 0,
"title": "string",
"content": "string",
"type": 0,
"read_status": 0,
"created_at": "string",
"created_timestamp": 0
}
Свойства
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| id | integer,string | false | нет | Значения базы данных могут быть сериализованы как строки. |
| title | string | false | нет | none |
| content | string | false | нет | Контент отображается на запрошенном языке |
| type | integer,string | false | нет | Значения базы данных могут быть сериализованы как строки. |
| read_status | integer | false | нет | none |
| created_at | string | false | нет | Г-м-д Ч:и:с; дата, отличная от RFC 3339 |
| created_timestamp | integer | false | нет | none |
Допустимые значения
| Свойство | Значение |
|---|---|
| read_status | 0 |
| read_status | 1 |
productTypes
9
Тип пакета, 9 пакетов динамического трафика для жилых помещений, 11 динамических IP для жилых помещений, 14 статических IP-адресов для центров обработки данных, 25 статических IP-адресов для жилых помещений
Свойства
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| anonymous | integer | false | нет | Тип пакета, 9 пакетов динамического трафика для жилых помещений, 11 динамических IP для жилых помещений, 14 статических IP-адресов для центров обработки данных, 25 статических IP-адресов для жилых помещений |
Допустимые значения
| Свойство | Значение |
|---|---|
| anonymous | 9 |
| anonymous | 11 |
| anonymous | 14 |
| anonymous | 25 |
apiKey
"pa$$word"
API-ключ; передается с использованием apiKeyAuth или параметра запроса, объявленного операцией
Свойства
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| anonymous | string(password) | false | нет | API-ключ; передается с использованием apiKeyAuth или параметра запроса, объявленного операцией |
responseCode
200
Код состояния, 200 успешно, 3 app_key недействительны
Свойства
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| anonymous | integer | false | нет | Код состояния, 200 успешно, 3 app_key недействительны |
responseMsg
"success"
response message
Свойства
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| anonymous | string | false | нет | response message |
SuccessResponse
{
"code": 200,
"msg": "SUCCESS",
"data": {},
"request_id": "string"
}
Свойства
None
ErrorResponse
{
"code": 2,
"msg": "parameter error",
"data": {},
"request_id": "string"
}
Свойства
None
WebV1SuccessResponse
{
"code": 200,
"msg": "SUCCESS",
"data": {},
"request_id": "string"
}
Свойства
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| code | integer | true | нет | none |
| msg | string | true | нет | none |
| data | object,array,string,number,boolean,null | true | нет | Бизнес-данные, конкретный тип определяется интерфейсом |
| request_id | string | true | нет | Запросить идентификатор отслеживания ссылки |
WebV1ErrorResponse
{
"code": 2,
"msg": "parameter error",
"data": {},
"request_id": "string"
}
Свойства
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| code | integer | true | нет | Код бизнес-ошибки |
not
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| » anonymous | any | false | нет | none |
continued
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| msg | string | true | нет | Описание ошибки |
| data | object,array,null | true | нет | Ошибка дополнительных данных, ноль, если дополнительных данных нет. |
| request_id | string | true | нет | Запросить идентификатор отслеживания ссылки |
TeamPublicId
"A1b2C3d4E5f6"
Публичный логотип команды, первый символ — буква ASCII, остальные символы содержат только буквы и цифры ASCII; числовой первичный ключ базы данных не выдан
Свойства
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| anonymous | string | false | нет | Публичный логотип команды, первый символ — буква ASCII, остальные символы содержат только буквы и цифры ASCII; числовой первичный ключ базы данных не выдан |
ResourceSpaceId
"A1b2C3d4E5f6"
Идентификация пространства государственных ресурсов; опустите team_id или передайте пустую строку при запросе личного пространства и пустую строку при ответе на личное пространство; и число 0, и строка «0» незаконны, а в командном пространстве используется 6-12-значный публичный идентификатор команды.
Свойства
oneOf
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| anonymous | string | false | нет | none |
xor
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| anonymous | TeamPublicId | false | нет | Публичный логотип команды, первый символ — буква ASCII, остальные символы содержат только буквы и цифры ASCII; числовой первичный ключ базы данных не выдан |
Team
{
"id": "A1b2C3d4E5f6",
"name": "string",
"super_admin_user_id": 1,
"status": 0,
"current_role": 1,
"dissolving_at": "string",
"dissolved_at": "string",
"created_at": "string",
"updated_at": "string"
}
Свойства
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| id | TeamPublicId | true | нет | Публичный логотип команды, первый символ — буква ASCII, остальные символы содержат только буквы и цифры ASCII; числовой первичный ключ базы данных не выдан |
| name | string | true | нет | Название команды |
| super_admin_user_id | integer | true | нет | Идентификатор пользователя суперадминистратора |
| status | integer | true | нет | Статус команды: 0=отключена, 1=действительна, 2=расформирована, 3=расформирована. |
| current_role | integer,null | true | нет | Роль текущего пользователя в команде; ноль, если невозможно определить |
| dissolving_at | string,null | true | нет | Начало времени растворения |
| dissolved_at | string,null | true | нет | Время завершения растворения |
| created_at | string | true | нет | время создания |
| updated_at | string | true | нет | Время обновления |
Допустимые значения
| Свойство | Значение |
|---|---|
| status | 0 |
| status | 1 |
| status | 2 |
| status | 3 |
| current_role | 1 |
| current_role | 2 |
| current_role | 3 |
| current_role | 4 |
| current_role | null |
TeamAsset
{
"id": 1,
"user_id": 1,
"team_id": "A1b2C3d4E5f6",
"team_user_id": 0,
"product_id": 1,
"product_type": 0,
"parent_product_type": 0,
"status": 0,
"total_amount": 0,
"remain": 0,
"bandwidth": 0,
"concurrency": 0,
"expired_at": "string",
"created_at": "string",
"ip": "string",
"country_code": "string",
"country_name": "string",
"asn": "string",
"port": 0
}
Свойства
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| id | integer | true | нет | Идентификатор пользовательского плана |
| user_id | integer | true | нет | Идентификатор пользователя владельца ресурса |
| team_id | ResourceSpaceId | true | нет | Идентификация пространства государственных ресурсов; опустите team_id или передайте пустую строку при запросе личного пространства и пустую строку при ответе на личное пространство; и число 0, и строка «0» незаконны, а в командном пространстве используется 6-12-значный публичный идентификатор команды. |
| team_user_id | integer | true | нет | Фактическое создание идентификаторов пользователей-участников |
| product_id | integer | true | нет | Идентификатор продукта |
| product_type | integer | true | нет | тип продукта |
| parent_product_type | integer | true | нет | Родительский тип продукта |
| status | integer | true | нет | Статус пакета |
| total_amount | integer(int64) | true | нет | общая сумма |
| remain | integer(int64) | true | нет | Оставшаяся сумма |
| bandwidth | integer | false | нет | Пропускная способность (Мбит/с); возвращается только по Product_type=19 или 11 |
| concurrency | integer | false | нет | Количество параллелизма; возвращается только product_type=11 |
| expired_at | string,null | true | нет | Срок годности |
| created_at | string | true | нет | время создания |
| ip | string | false | нет | Статический IP-адрес; возвращается только product_type=19 |
| country_code | string | false | нет | Статический IP-код страны; возвращается только product_type=19 |
| country_name | string | false | нет | Статический IP-адрес страны; возвращается только по product_type=19 |
| asn | string | false | нет | Статический IP-адрес ASN; возвращается только product_type=19 |
| port | integer | false | нет | Статический IP-порт прокси-сервера; возвращается только по product_type=19 |
TeamProductInfo
{
"team_id": "A1b2C3d4E5f6",
"product_types": [
0
],
"product_residence_remain_count": 0,
"product_residence_total_count": 0,
"pdrue2_timestamp": 0,
"remain": 0,
"total_amount": 0,
"scraping_remain": 0,
"scraping_total_amount": 0,
"scraping_timestamp": "string",
"scraping_timestamp2": 0,
"common_scraping_remain": 0,
"common_scraping_total_amount": 0,
"common_scraping_timestamp": "string",
"common_scraping_timestamp2": 0,
"pdidcr_count": 0,
"pdidcr_total": 0,
"pdidcr_traffic_remain": 0,
"pdidcr_traffic_total": 0,
"p_sitai_ip_count": 0,
"p_sitai_ip": 0,
"p_sitai_ip_total": 0,
"p_sitai_remain": 0,
"p_sitai_total": 0,
"pdidc_count": 0,
"pdidc_total": 0,
"pdidc_ip_count": 0,
"pdidc_ip_all_count": 0,
"pdispr_count": 0,
"pdispr_total": 0,
"pdispr_traffic_remain": 0,
"pdispr_traffic_total": 0,
"product_datacenter_isp_traffic_ip_count": 0,
"product_datacenter_isp_traffc_ip": 0,
"product_datacenter_isp_traffc_ip_total": 0,
"product_datacenter_isp_traffic_ip": 0,
"product_datacenter_isp_traffic_ip_total": 0,
"product_datacenter_isp_traffc_remain": 0,
"product_datacenter_isp_traffc_total": 0,
"product_datacenter_isp_traffic_remain": 0,
"product_datacenter_isp_traffic_total": 0,
"product_datacenter_isp_ip": 0,
"product_datacenter_isp_ip_total": 0,
"product_datacenter_isp_ip_count": 0,
"product_datacenter_isp_ip_all_count": 0,
"product_datacenter_isp_ip_traffic_remain": 0,
"product_datacenter_isp_ip_traffic_total": 0,
"product_agent_residence_remain_count": 0,
"product_agent_residence_total_count": 0,
"product_serp_remain": 0,
"product_serp_total": 0,
"product_serp_timestamp": "string",
"product_serp_timestamp2": 0,
"product_video_remain": 0,
"product_video_total": 0,
"product_video_timestamp": "string",
"product_video_timestamp2": 0
}
Статистические поля пакета соответствуют /web_v1/user/info; записи об отмене, возврате или мягком удалении не включаются в сводку; кроме team_id и Product_types, возвращаются только поля, соответствующие типам продуктов, поддерживаемым текущим сайтом.
Свойства
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| team_id | TeamPublicId | true | нет | Публичный логотип команды, первый символ — буква ASCII, остальные символы содержат только буквы и цифры ASCII; числовой первичный ключ базы данных не выдан |
| product_types | [integer] | true | нет | Пространство ресурсов группы не было отменено или обратимо удалено, а тип пакета поддерживается текущим сайтом. |
| product_residence_remain_count | integer(int64) | false | нет | Остаточный расход типа 9 |
| product_residence_total_count | integer(int64) | false | нет | Общий трафик типа 9 |
| pdrue2_timestamp | integer(int64) | false | нет | Введите 11 последнюю метку времени истечения срока действия; 0, когда нет командного пакета |
| remain | integer,string | false | нет | Тип 17 Оставшееся количество |
| total_amount | integer,string | false | нет | Тип 17 Общее количество |
| scraping_remain | integer(int64) | false | нет | Введите 18 оставшихся раз |
| scraping_total_amount | integer(int64) | false | нет | Введите 18 раз |
| scraping_timestamp | string | false | нет | Введите 18 последний срок годности; «-» когда пакета нет |
| scraping_timestamp2 | integer(int64) | false | нет | Введите 18 последнюю дату истечения срока действия. |
| common_scraping_remain | integer(int64) | false | нет | Введите 29 оставшихся раз |
| common_scraping_total_amount | integer(int64) | false | нет | Введите 29 Общее количество раз |
| common_scraping_timestamp | string | false | нет | Введите 29 последний срок годности; «-» когда пакета нет |
| common_scraping_timestamp2 | integer(int64) | false | нет | Введите 29 последнюю дату истечения срока действия. |
| pdidcr_count | integer | false | нет | Тип 12 Действительное количество упаковки |
| pdidcr_total | integer | false | нет | Общее количество упаковок типа 12 |
| pdidcr_traffic_remain | integer(int64) | false | нет | Тип 12 Остаточный поток |
| pdidcr_traffic_total | integer(int64) | false | нет | Общий трафик типа 12 |
| p_sitai_ip_count | integer | false | нет | Введите 13 действительный IP-номер |
| p_sitai_ip | integer | false | нет | Тип 13 Допустимое количество упаковки |
| p_sitai_ip_total | integer | false | нет | Общее количество упаковок типа 13 |
| p_sitai_remain | integer(int64) | false | нет | Остаточный поток Тип 13/24 |
| p_sitai_total | integer(int64) | false | нет | Тип 13/24 Общий расход |
| pdidc_count | integer | false | нет | Тип 14 Допустимое количество упаковки |
| pdidc_total | integer | false | нет | Общее количество упаковок типа 14 |
| pdidc_ip_count | integer | false | нет | Введите 14 действительный IP-номер |
| pdidc_ip_all_count | integer | false | нет | Тип 14 IP Всего |
| pdispr_count | integer | false | нет | Тип 15 Допустимое количество упаковки |
| pdispr_total | integer | false | нет | Общее количество упаковок типа 15 |
| pdispr_traffic_remain | integer(int64) | false | нет | Остаточный поток Тип 15 |
| pdispr_traffic_total | integer(int64) | false | нет | Тип 15 Общий трафик |
| product_datacenter_isp_traffic_ip_count | integer | false | нет | Введите 16 действительный IP-номер |
| product_datacenter_isp_traffc_ip | integer | false | нет | Тип 16. Допустимое количество упаковки; Исторически совместимое написание |
| product_datacenter_isp_traffc_ip_total | integer | false | нет | Всего упаковок типа 16; Исторически совместимые написания |
| product_datacenter_isp_traffic_ip | integer | false | нет | Тип 16 Допустимое количество упаковки |
| product_datacenter_isp_traffic_ip_total | integer | false | нет | Общее количество упаковок типа 16 |
| product_datacenter_isp_traffc_remain | integer(int64) | false | нет | Остаточный трафик типа 16/24; исторически совместимое написание |
| product_datacenter_isp_traffc_total | integer(int64) | false | нет | Общий расход Тип 16/24; исторически совместимое написание |
| product_datacenter_isp_traffic_remain | integer(int64) | false | нет | Остаточный поток Тип 16/24 |
| product_datacenter_isp_traffic_total | integer(int64) | false | нет | Тип 16/24 Общий расход |
| product_datacenter_isp_ip | integer | false | нет | Введите 21 или 25 допустимое количество упаковки. |
| product_datacenter_isp_ip_total | integer | false | нет | Всего введите 21 или 25 упаковок. |
| product_datacenter_isp_ip_count | integer | false | нет | Введите 21 или 25 действительный IP-номер |
| product_datacenter_isp_ip_all_count | integer | false | нет | Всего тип 21 или 25 IP |
| product_datacenter_isp_ip_traffic_remain | integer(int64) | false | нет | Тип 21 соответствует остаточному расходу типа 24. |
| product_datacenter_isp_ip_traffic_total | integer(int64) | false | нет | Тип 21 соответствует общему расходу типа 24. |
| product_agent_residence_remain_count | integer(int64) | false | нет | Тип 22 Остаточный поток |
| product_agent_residence_total_count | integer(int64) | false | нет | Тип 22 Общий трафик |
| product_serp_remain | integer(int64) | false | нет | Введите 27 оставшихся раз |
| product_serp_total | integer(int64) | false | нет | Введите 27 «Общее время» |
| product_serp_timestamp | string | false | нет | Введите 27 последний срок годности; «-» когда пакета нет |
| product_serp_timestamp2 | integer(int64) | false | нет | Введите 27 последнюю дату истечения срока действия. |
| product_video_remain | integer(int64) | false | нет | Тип 28 Остаточный поток |
| product_video_total | integer(int64) | false | нет | Тип 28 Общий расход |
| product_video_timestamp | string | false | нет | Введите 28 последний срок годности; «-» когда пакета нет |
| product_video_timestamp2 | integer(int64) | false | нет | Введите 28 последнюю дату истечения срока действия. |
TeamWallet
{
"team_id": "A1b2C3d4E5f6",
"balance": 0.1,
"total_recharge_fee": 0.1,
"updated_at": "string"
}
Командный кошелек, изолированный от личного баланса суперадминистратора; для суммы используется валюта текущего сайта по умолчанию с точностью до 4 знаков после запятой.
Свойства
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| team_id | TeamPublicId | true | нет | Публичный логотип команды, первый символ — буква ASCII, остальные символы содержат только буквы и цифры ASCII; числовой первичный ключ базы данных не выдан |
| balance | number(double) | true | нет | Текущий доступный баланс команды |
| total_recharge_fee | number(double) | true | нет | Текущая неизрасходованная сумма пополнения баланса команды, за исключением суммы перевода с личного баланса. |
| updated_at | string | true | нет | Время последнего изменения кошелька |
TeamWalletRecord
{
"id": 1,
"team_id": "A1b2C3d4E5f6",
"operator_user_id": 0,
"creator": {
"user_id": 0,
"display_name": "string",
"nickname": "string",
"username": "string",
"email": "string",
"phone": "string"
},
"direction": 0,
"transaction_type": 1,
"amount": 0.1,
"after_balance": 0.1,
"link_id": 0,
"request_id": "string",
"remark": "string",
"created_at": "string"
}
Свойства
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| id | integer | true | нет | none |
| team_id | TeamPublicId | true | нет | Публичный логотип команды, первый символ — буква ASCII, остальные символы содержат только буквы и цифры ASCII; числовой первичный ключ базы данных не выдан |
| operator_user_id | integer | true | нет | Оператор, системный возврат 0 |
| creator | TeamCreator | false | нет | none |
| direction | integer | true | нет | 0=расход, 1=доход |
| transaction_type | integer | true | нет | 1=Пополнение на счет, 2=Перевод с личного баланса, 3=Использование баланса, 4=Возврат или возврат пополнения, 5=Перевод обратно на личный баланс |
| amount | number(double) | true | нет | Величина этого изменения, направление представлено направлением |
| after_balance | number(double) | true | нет | Баланс командного кошелька после изменения |
| link_id | integer | true | нет | Идентификатор связанного заказа; при передаче личного баланса это идентификатор действующего пользователя |
| request_id | string | true | нет | none |
| remark | string | true | нет | none |
| created_at | string | true | нет | none |
Допустимые значения
| Свойство | Значение |
|---|---|
| direction | 0 |
| direction | 1 |
| transaction_type | 1 |
| transaction_type | 2 |
| transaction_type | 3 |
| transaction_type | 4 |
| transaction_type | 5 |
TeamCreator
{
"user_id": 0,
"display_name": "string",
"nickname": "string",
"username": "string",
"email": "string",
"phone": "string"
}
Свойства
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| user_id | integer | true | нет | Идентификатор пользователя оператора; работа системы равна 0 |
| display_name | string | true | нет | Отображаемое имя, псевдоним, имя пользователя, адрес электронной почты и номер мобильного телефона по порядку. |
| nickname | string | true | нет | none |
| username | string | true | нет | none |
| string | true | нет | Неадминистраторская точка зрения – это ценность снижения чувствительности | |
| phone | string | true | нет | Неадминистраторская точка зрения – это ценность снижения чувствительности |
TeamResponse
{
"code": 200,
"msg": "SUCCESS",
"data": {
"id": "A1b2C3d4E5f6",
"name": "string",
"super_admin_user_id": 1,
"status": 0,
"current_role": 1,
"dissolving_at": "string",
"dissolved_at": "string",
"created_at": "string",
"updated_at": "string"
},
"request_id": "string"
}
Свойства
allOf
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| anonymous | WebV1SuccessResponse | false | нет | none |
and
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| anonymous | object | false | нет | none |
| » data | Team | false | нет | none |
TeamListResponse
{
"code": 200,
"msg": "SUCCESS",
"data": {
"list": [
{
"id": "A1b2C3d4E5f6",
"name": "string",
"super_admin_user_id": 1,
"status": 0,
"current_role": 1,
"dissolving_at": "string",
"dissolved_at": "string",
"created_at": "string",
"updated_at": "string"
}
],
"total": 0,
"page": 1,
"page_size": 1
},
"request_id": "string"
}
Свойства
allOf
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| anonymous | WebV1SuccessResponse | false | нет | none |
and
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| anonymous | object | false | нет | none |
| » data | object | false | нет | none |
| »» list | [Team] | true | нет | none |
| »» total | integer | true | нет | none |
| »» page | integer | true | нет | none |
| »» page_size | integer | true | нет | none |
TeamMemberListResponse
{
"code": 200,
"msg": "SUCCESS",
"data": {
"list": [
{
"team_member_id": 1,
"team_id": "A1b2C3d4E5f6",
"user_id": 1,
"role": 1,
"status": 0,
"joined_at": "string",
"nickname": "string",
"username": "string"
}
],
"total": 0,
"page": 1,
"page_size": 1
},
"request_id": "string"
}
Свойства
allOf
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| anonymous | WebV1SuccessResponse | false | нет | none |
and
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| anonymous | object | false | нет | none |
| » data | object | false | нет | none |
| »» list | [TeamMember] | true | нет | none |
| »» total | integer | true | нет | none |
| »» page | integer | true | нет | none |
| »» page_size | integer | true | нет | none |
TeamPersonListResponse
{
"code": 200,
"msg": "SUCCESS",
"data": {
"list": [
{
"record_type": "member",
"record_id": 1,
"team_id": "A1b2C3d4E5f6",
"user_id": 0,
"inviter_user_id": 0,
"invite_type": 0,
"invite_country_code": 999,
"invite_target": "string",
"delivery_type": 0,
"role": 1,
"status": 0,
"display_name": "string",
"nickname": "string",
"username": "string",
"email": "string",
"phone": "string",
"joined_at": "string",
"expired_at": "string",
"created_at": "string"
}
],
"total": 0,
"page": 1,
"page_size": 1
},
"request_id": "string"
}
Свойства
allOf
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| anonymous | WebV1SuccessResponse | false | нет | none |
and
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| anonymous | object | false | нет | none |
| » data | object | false | нет | none |
| »» list | [TeamPerson] | true | нет | none |
| »» total | integer | true | нет | none |
| »» page | integer | true | нет | none |
| »» page_size | integer | true | нет | none |
TeamAssetResponse
{
"code": 200,
"msg": "SUCCESS",
"data": {
"id": 1,
"user_id": 1,
"team_id": "A1b2C3d4E5f6",
"team_user_id": 0,
"product_id": 1,
"product_type": 0,
"parent_product_type": 0,
"status": 0,
"total_amount": 0,
"remain": 0,
"bandwidth": 0,
"concurrency": 0,
"expired_at": "string",
"created_at": "string",
"ip": "string",
"country_code": "string",
"country_name": "string",
"asn": "string",
"port": 0
},
"request_id": "string"
}
Свойства
allOf
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| anonymous | WebV1SuccessResponse | false | нет | none |
and
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| anonymous | object | false | нет | none |
| » data | TeamAsset | false | нет | none |
TeamProductInfoResponse
{
"code": 200,
"msg": "SUCCESS",
"data": {
"team_id": "A1b2C3d4E5f6",
"product_types": [
0
],
"product_residence_remain_count": 0,
"product_residence_total_count": 0,
"pdrue2_timestamp": 0,
"remain": 0,
"total_amount": 0,
"scraping_remain": 0,
"scraping_total_amount": 0,
"scraping_timestamp": "string",
"scraping_timestamp2": 0,
"common_scraping_remain": 0,
"common_scraping_total_amount": 0,
"common_scraping_timestamp": "string",
"common_scraping_timestamp2": 0,
"pdidcr_count": 0,
"pdidcr_total": 0,
"pdidcr_traffic_remain": 0,
"pdidcr_traffic_total": 0,
"p_sitai_ip_count": 0,
"p_sitai_ip": 0,
"p_sitai_ip_total": 0,
"p_sitai_remain": 0,
"p_sitai_total": 0,
"pdidc_count": 0,
"pdidc_total": 0,
"pdidc_ip_count": 0,
"pdidc_ip_all_count": 0,
"pdispr_count": 0,
"pdispr_total": 0,
"pdispr_traffic_remain": 0,
"pdispr_traffic_total": 0,
"product_datacenter_isp_traffic_ip_count": 0,
"product_datacenter_isp_traffc_ip": 0,
"product_datacenter_isp_traffc_ip_total": 0,
"product_datacenter_isp_traffic_ip": 0,
"product_datacenter_isp_traffic_ip_total": 0,
"product_datacenter_isp_traffc_remain": 0,
"product_datacenter_isp_traffc_total": 0,
"product_datacenter_isp_traffic_remain": 0,
"product_datacenter_isp_traffic_total": 0,
"product_datacenter_isp_ip": 0,
"product_datacenter_isp_ip_total": 0,
"product_datacenter_isp_ip_count": 0,
"product_datacenter_isp_ip_all_count": 0,
"product_datacenter_isp_ip_traffic_remain": 0,
"product_datacenter_isp_ip_traffic_total": 0,
"product_agent_residence_remain_count": 0,
"product_agent_residence_total_count": 0,
"product_serp_remain": 0,
"product_serp_total": 0,
"product_serp_timestamp": "string",
"product_serp_timestamp2": 0,
"product_video_remain": 0,
"product_video_total": 0,
"product_video_timestamp": "string",
"product_video_timestamp2": 0
},
"request_id": "string"
}
Свойства
allOf
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| anonymous | WebV1SuccessResponse | false | нет | none |
and
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| anonymous | object | false | нет | none |
| » data | TeamProductInfo | false | нет | Статистические поля пакета соответствуют /web_v1/user/info; записи об отмене, возврате или мягком удалении не включаются в сводку; кроме team_id и Product_types, возвращаются только поля, соответствующие типам продуктов, поддерживаемым текущим сайтом. |
TeamWalletResponse
{
"code": 200,
"msg": "SUCCESS",
"data": {
"team_id": "A1b2C3d4E5f6",
"balance": 0.1,
"total_recharge_fee": 0.1,
"updated_at": "string"
},
"request_id": "string"
}
Свойства
allOf
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| anonymous | WebV1SuccessResponse | false | нет | none |
and
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| anonymous | object | false | нет | none |
| » data | TeamWallet | false | нет | Командный кошелек, изолированный от личного баланса суперадминистратора; для суммы используется валюта текущего сайта по умолчанию с точностью до 4 знаков после запятой. |
TeamWalletRecordListResponse
{
"code": 200,
"msg": "SUCCESS",
"data": {
"list": [
{
"id": 1,
"team_id": "A1b2C3d4E5f6",
"operator_user_id": 0,
"creator": {
"user_id": 0,
"display_name": "string",
"nickname": "string",
"username": "string",
"email": "string",
"phone": "string"
},
"direction": 0,
"transaction_type": 1,
"amount": 0.1,
"after_balance": 0.1,
"link_id": 0,
"request_id": "string",
"remark": "string",
"created_at": "string"
}
],
"total": 0,
"page": 1,
"page_size": 1
},
"request_id": "string"
}
Свойства
allOf
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| anonymous | WebV1SuccessResponse | false | нет | none |
and
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| anonymous | object | false | нет | none |
| » data | object | false | нет | none |
| »» list | [TeamWalletRecord] | true | нет | none |
| »» total | integer | true | нет | none |
| »» page | integer | true | нет | none |
| »» page_size | integer | true | нет | none |
TeamAssetListResponse
{
"code": 200,
"msg": "SUCCESS",
"data": {
"list": [
{
"id": 1,
"user_id": 1,
"team_id": "A1b2C3d4E5f6",
"team_user_id": 0,
"product_id": 1,
"product_type": 0,
"parent_product_type": 0,
"status": 0,
"total_amount": 0,
"remain": 0,
"bandwidth": 0,
"concurrency": 0,
"expired_at": "string",
"created_at": "string",
"ip": "string",
"country_code": "string",
"country_name": "string",
"asn": "string",
"port": 0
}
],
"total": 0,
"page": 1,
"page_size": 1
},
"request_id": "string"
}
Свойства
allOf
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| anonymous | WebV1SuccessResponse | false | нет | none |
and
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| anonymous | object | false | нет | none |
| » data | object | false | нет | none |
| »» list | [TeamAsset] | true | нет | none |
| »» total | integer | true | нет | none |
| »» page | integer | true | нет | none |
| »» page_size | integer | true | нет | none |
UserApiKeyMetadata
{
"id": 1,
"api_key": "string",
"team_user_id": 0,
"remark": "string",
"status": 0,
"created_at": "string",
"updated_at": "string"
}
Свойства
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| id | integer | true | нет | API Key ID |
| api_key | string | true | нет | Ответ создания – это полный Ключ; список команд — это замаскированное значение |
| team_user_id | integer | true | нет | Ключ группы фактически содержит идентификатор участника, а личный ключ равен 0. |
| remark | string | true | нет | Примечания |
| status | integer | true | нет | 0=отключить, 1=включить |
| created_at | string | true | нет | время создания |
| updated_at | string,null | false | нет | Время обновления |
Допустимые значения
| Свойство | Значение |
|---|---|
| status | 0 |
| status | 1 |
InvoiceInfo
{
"invoice_code": "string",
"name": "string",
"org_name": "string",
"first_name": "string",
"last_name": "string",
"phone": "string",
"email": "[email protected]",
"role_type": 1,
"invoice_type": 0,
"vat_id": "string",
"tax_no": "string",
"address_country": "string",
"address_city": "string",
"address_line1": "string",
"address_line2": "string",
"address_postal_code": "string",
"bank_name": "string",
"bank_account": "string",
"is_def": true
}
Свойства
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| invoice_code | string | false | нет | none |
| name | string | false | нет | none |
| org_name | string | false | нет | none |
| first_name | string | false | нет | none |
| last_name | string | false | нет | none |
| phone | string | false | нет | none |
| string(email) | false | нет | none | |
| role_type | integer | false | нет | none |
| invoice_type | integer | false | нет | none |
| vat_id | string | false | нет | none |
| tax_no | string | false | нет | none |
| address_country | string | false | нет | none |
| address_city | string | false | нет | none |
| address_line1 | string | false | нет | none |
| address_line2 | string | false | нет | none |
| address_postal_code | string | false | нет | none |
| bank_name | string | false | нет | none |
| bank_account | string | false | нет | none |
| is_def | boolean | false | нет | none |
Допустимые значения
| Свойство | Значение |
|---|---|
| role_type | 1 |
| role_type | 2 |
| invoice_type | 0 |
| invoice_type | 1 |
| invoice_type | 2 |
MonthlyRenewalRequest
{
"team_id": "A1b2C3d4E5f6",
"user_product_ids": [
1
],
"user_coupon_id": 1,
"coupon_sn": "string"
}
Свойства
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| team_id | ResourceSpaceId | false | нет | Идентификация пространства государственных ресурсов; опустите team_id или передайте пустую строку при запросе личного пространства и пустую строку при ответе на личное пространство; и число 0, и строка «0» незаконны, а в командном пространстве используется 6-12-значный публичный идентификатор команды. |
| user_product_ids | any | true | нет | Массив идентификаторов пользовательского плана, также совместимый с английскими строками, разделенными запятыми. |
oneOf
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| » anonymous | [integer] | false | нет | none |
xor
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| » anonymous | string | false | нет | none |
continued
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| user_coupon_id | integer | false | нет | none |
| coupon_sn | string | false | нет | none |
TeamInvitation
{
"id": 1,
"team_id": "A1b2C3d4E5f6",
"inviter_user_id": 1,
"invitee_user_id": 0,
"invite_type": 1,
"invite_country_code": 999,
"invite_target": "string",
"delivery_type": 1,
"role": 2,
"status": 0,
"accepted_by_user_id": 0,
"expired_at": "2026-07-17 10:00:00",
"accepted_at": null,
"rejected_at": null,
"cancelled_at": null,
"created_at": "2026-07-10 10:00:00"
}
Свойства
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| id | integer | true | нет | Идентификатор приглашения |
| team_id | TeamPublicId | true | нет | Публичный логотип команды, первый символ — буква ASCII, остальные символы содержат только буквы и цифры ASCII; числовой первичный ключ базы данных не выдан |
| inviter_user_id | integer | true | нет | Идентификатор приглашающего пользователя |
| invitee_user_id | integer | true | нет | Идентификатор приглашенного пользователя, 0, если ни один зарегистрированный пользователь еще не сопоставлен. |
| invite_type | integer | true | нет | Тип приглашения: 1=зарегистрированный пользователь, 2=электронная почта, 3=номер мобильного телефона. |
| invite_country_code | integer | true | нет | Код страны или региона номера мобильного телефона, 0 для приглашений без номера мобильного телефона. |
| invite_target | string | true | нет | Стандартизированная цель приглашения; зарегистрированный пользователь — user:{user_id} |
| delivery_type | integer | true | нет | Исходный канал доставки: 1=зарегистрированный пользователь, 2=электронная почта, 3=номер мобильного телефона; исходный канал будет сохранен, если адрес электронной почты или номер мобильного телефона соответствует зарегистрированному пользователю. |
| role | integer | true | нет | Целевая роль: 2=администратор, 3=обычный участник. |
| status | integer | true | нет | Статус приглашения: 0 = в ожидании, 1 = принято, 2 = отклонено, 3 = отменено, 4 = срок действия истек. |
| accepted_by_user_id | integer | true | нет | Идентификатор пользователя-принимателя, 0, если не принято |
| expired_at | string | true | нет | Срок годности в формате ГГГГ-ММ-ДД ЧЧ:мм:сс |
| accepted_at | string,null | true | нет | Время приема |
| rejected_at | string,null | true | нет | время отклонения |
| cancelled_at | string,null | true | нет | Время отмены |
| created_at | string | true | нет | Время создания, формат ГГГГ-ММ-ДД ЧЧ:мм:сс |
Допустимые значения
| Свойство | Значение |
|---|---|
| invite_type | 1 |
| invite_type | 2 |
| invite_type | 3 |
| delivery_type | 1 |
| delivery_type | 2 |
| delivery_type | 3 |
| role | 2 |
| role | 3 |
| status | 0 |
| status | 1 |
| status | 2 |
| status | 3 |
| status | 4 |
TeamMember
{
"team_member_id": 1,
"team_id": "A1b2C3d4E5f6",
"user_id": 1,
"role": 1,
"status": 0,
"joined_at": "string",
"nickname": "string",
"username": "string"
}
Свойства
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| team_member_id | integer | true | нет | Идентификатор членства |
| team_id | TeamPublicId | true | нет | Публичный логотип команды, первый символ — буква ASCII, остальные символы содержат только буквы и цифры ASCII; числовой первичный ключ базы данных не выдан |
| user_id | integer | true | нет | Идентификатор пользователя участника |
| role | integer | true | нет | Роль: 1=суперадминистратор, 2=администратор, 3=обычный член, 4=финансовый член. |
| status | integer | true | нет | Статус участника: 0=отключен, 1=действителен, 2=вышел, 3=удален. |
| joined_at | string,null | true | нет | Время присоединения, формат ГГГГ-ММ-ДД ЧЧ:мм:сс |
| nickname | string | true | нет | Никнейм участника |
| username | string | true | нет | Имя пользователя участника |
Допустимые значения
| Свойство | Значение |
|---|---|
| role | 1 |
| role | 2 |
| role | 3 |
| role | 4 |
| status | 0 |
| status | 1 |
| status | 2 |
| status | 3 |
TeamPerson
{
"record_type": "member",
"record_id": 1,
"team_id": "A1b2C3d4E5f6",
"user_id": 0,
"inviter_user_id": 0,
"invite_type": 0,
"invite_country_code": 999,
"invite_target": "string",
"delivery_type": 0,
"role": 1,
"status": 0,
"display_name": "string",
"nickname": "string",
"username": "string",
"email": "string",
"phone": "string",
"joined_at": "string",
"expired_at": "string",
"created_at": "string"
}
Свойства
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| record_type | string | true | нет | Тип записи; участник является действительным участником, приглашение находится на рассмотрении |
| record_id | integer | true | нет | Идентификатор участника или идентификатор приглашения |
| team_id | TeamPublicId | true | нет | Публичный логотип команды, первый символ — буква ASCII, остальные символы содержат только буквы и цифры ASCII; числовой первичный ключ базы данных не выдан |
| user_id | integer | true | нет | Идентификатор пользователя, незарегистрированные приглашенные пользователи — 0. |
| inviter_user_id | integer | true | нет | Идентификатор приглашающего пользователя, запись участника – 0. |
| invite_type | integer | true | нет | Тип приглашения, запись участника – 0. |
| invite_country_code | integer | true | нет | Код страны или города номера мобильного телефона, запись участника – 0. |
| invite_target | string | true | нет | Цель приглашения, запись участника — пустая строка. |
| delivery_type | integer | true | нет | Исходный канал доставки, запись участника – 0. |
| role | integer | true | нет | Роль: 1=суперадминистратор, 2=администратор, 3=обычный член, 4=финансовый член. |
| status | integer | true | нет | члену присвоено значение 1, приглашению присвоено значение 0 |
| display_name | string | true | нет | Отображайте имя единообразно, упорядочивая псевдоним, имя пользователя, адрес электронной почты и номер мобильного телефона; используйте десенсибилизированные значения для контактной информации с точки зрения обычных участников |
| nickname | string | true | нет | Никнейм участника или зарегистрированного приглашенного пользователя |
| username | string | true | нет | Участник или зарегистрированное приглашенное имя пользователя |
| string | true | нет | электронная почта; суперадминистраторы и администраторы возвращают полные значения, обычные участники возвращают значения снижения чувствительности со звездочками | |
| phone | string | true | нет | Номер мобильного телефона; суперадминистраторы и администраторы возвращают полное значение, а обычные участники возвращают десенсибилизированное значение со звездочкой. |
| joined_at | string,null | true | нет | Время присоединения участника, запись о приглашении пуста |
| expired_at | string,null | true | нет | Срок действия приглашения истек, запись участника пуста |
| created_at | string | true | нет | Время создания записи в формате ГГГГ-ММ-ДД ЧЧ:мм:сс |
Допустимые значения
| Свойство | Значение |
|---|---|
| record_type | member |
| record_type | invitation |
| invite_type | 0 |
| invite_type | 1 |
| invite_type | 2 |
| invite_type | 3 |
| delivery_type | 0 |
| delivery_type | 1 |
| delivery_type | 2 |
| delivery_type | 3 |
| role | 1 |
| role | 2 |
| role | 3 |
| role | 4 |
| status | 0 |
| status | 1 |
TeamInvitationResponse
{
"code": 200,
"msg": "SUCCESS",
"data": {
"id": 1,
"team_id": "A1b2C3d4E5f6",
"inviter_user_id": 1,
"invitee_user_id": 0,
"invite_type": 1,
"invite_country_code": 999,
"invite_target": "string",
"delivery_type": 1,
"role": 2,
"status": 0,
"accepted_by_user_id": 0,
"expired_at": "2026-07-17 10:00:00",
"accepted_at": null,
"rejected_at": null,
"cancelled_at": null,
"created_at": "2026-07-10 10:00:00"
},
"request_id": "string"
}
Свойства
allOf
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| anonymous | WebV1SuccessResponse | false | нет | none |
and
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| anonymous | object | false | нет | none |
| » data | TeamInvitation | false | нет | none |
TeamMemberResponse
{
"code": 200,
"msg": "SUCCESS",
"data": {
"team_member_id": 1,
"team_id": "A1b2C3d4E5f6",
"user_id": 1,
"role": 1,
"status": 0,
"joined_at": "string",
"nickname": "string",
"username": "string"
},
"request_id": "string"
}
Свойства
allOf
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| anonymous | WebV1SuccessResponse | false | нет | none |
and
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| anonymous | object | false | нет | none |
| » data | TeamMember | false | нет | none |
TeamInvitationCreateResponse
{
"code": 200,
"msg": "SUCCESS",
"data": {
"invitation": {
"id": 1,
"team_id": "A1b2C3d4E5f6",
"inviter_user_id": 1,
"invitee_user_id": 0,
"invite_type": 1,
"invite_country_code": 999,
"invite_target": "string",
"delivery_type": 1,
"role": 2,
"status": 0,
"accepted_by_user_id": 0,
"expired_at": "2026-07-17 10:00:00",
"accepted_at": null,
"rejected_at": null,
"cancelled_at": null,
"created_at": "2026-07-10 10:00:00"
},
"invitation_token": "string",
"invitation_url": "http://example.com",
"notification_channels": {
"email": "queued",
"sms": "queued",
"site_inner_message": "created"
}
},
"request_id": "string"
}
Свойства
allOf
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| anonymous | WebV1SuccessResponse | false | нет | none |
and
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| anonymous | object | false | нет | none |
| » data | object | false | нет | none |
| »» invitation | TeamInvitation | true | нет | none |
| »» invitation_token | string | true | нет | Токен приглашения в виде открытого текста, зарезервированный только для совместимых существующих клиентов; новые клиенты используют ignore_url напрямую |
| »» invitation_url | string(uri) | true | нет | Ссылка на внешнюю обработку, содержащая токен приглашения |
| »» notification_channels | TeamInvitationNotificationChannels | true | нет | none |
TeamInvitationNotificationChannels
{
"email": "queued",
"sms": "queued",
"site_inner_message": "created"
}
Свойства
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| string | false | нет | Результаты канала электронной почты | |
| sms | string | false | нет | Результаты смс-канала |
| site_inner_message | string | false | нет | Результаты канала сообщений сайта |
Допустимые значения
| Свойство | Значение |
|---|---|
| queued | |
| failed | |
| skipped | |
| sms | queued |
| sms | failed |
| sms | skipped |
| site_inner_message | created |
| site_inner_message | exists |
| site_inner_message | failed |
TeamInvitationPreviewResponse
{
"code": 200,
"msg": "SUCCESS",
"data": {
"team_name": "string",
"role": 2,
"status": 0,
"expired_at": "string"
},
"request_id": "string"
}
Свойства
allOf
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| anonymous | WebV1SuccessResponse | false | нет | none |
and
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| anonymous | object | false | нет | none |
| » data | object | false | нет | none |
| »» team_name | string | true | нет | Название команды |
| »» role | integer | true | нет | целевая роль |
| »» status | integer | true | нет | статус приглашения |
| »» expired_at | string | true | нет | Срок годности в формате ГГГГ-ММ-ДД ЧЧ:мм:сс |
Допустимые значения
| Свойство | Значение |
|---|---|
| role | 2 |
| role | 3 |
| status | 0 |
| status | 1 |
| status | 2 |
| status | 3 |
| status | 4 |
TeamInvitationResendResponse
{
"code": 200,
"msg": "SUCCESS",
"data": {
"invitation": {
"id": 1,
"team_id": "A1b2C3d4E5f6",
"inviter_user_id": 1,
"invitee_user_id": 0,
"invite_type": 1,
"invite_country_code": 999,
"invite_target": "string",
"delivery_type": 1,
"role": 2,
"status": 0,
"accepted_by_user_id": 0,
"expired_at": "2026-07-17 10:00:00",
"accepted_at": null,
"rejected_at": null,
"cancelled_at": null,
"created_at": "2026-07-10 10:00:00"
},
"invitation_url": "http://example.com",
"notification_channels": {
"email": "queued",
"sms": "queued",
"site_inner_message": "created"
}
},
"request_id": "string"
}
Свойства
allOf
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| anonymous | WebV1SuccessResponse | false | нет | none |
and
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| anonymous | object | false | нет | none |
| » data | object | false | нет | none |
| »» invitation | TeamInvitation | true | нет | none |
| »» invitation_url | string(uri) | true | нет | Новая ссылка для обработки приглашений; старая ссылка больше не работает |
| »» notification_channels | TeamInvitationNotificationChannels | true | нет | none |
TeamInvitationListResponse
{
"code": 200,
"msg": "SUCCESS",
"data": {
"list": [
{
"id": 1,
"team_id": "A1b2C3d4E5f6",
"inviter_user_id": 1,
"invitee_user_id": 0,
"invite_type": 1,
"invite_country_code": 999,
"invite_target": "string",
"delivery_type": 1,
"role": 2,
"status": 0,
"accepted_by_user_id": 0,
"expired_at": "2026-07-17 10:00:00",
"accepted_at": null,
"rejected_at": null,
"cancelled_at": null,
"created_at": "2026-07-10 10:00:00"
}
],
"total": 0,
"page": 1,
"page_size": 1
},
"request_id": "string"
}
Свойства
allOf
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| anonymous | WebV1SuccessResponse | false | нет | none |
and
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| anonymous | object | false | нет | none |
| » data | object | false | нет | none |
| »» list | [TeamInvitation] | true | нет | none |
| »» total | integer | true | нет | общее количество приглашений |
| »» page | integer | true | нет | Текущий номер страницы |
| »» page_size | integer | true | нет | фактическое количество на странице |
User
{
"id": 0,
"email": "[email protected]",
"phone": "string",
"balance": 0.1,
"status": 0,
"is_real_name": true,
"created_at": "2019-08-24T14:15:22Z"
}
Свойства
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| id | integer | false | нет | none |
| string(email) | false | нет | none | |
| phone | string | false | нет | none |
| balance | number(float) | false | нет | none |
| status | integer | false | нет | none |
| is_real_name | boolean | false | нет | none |
| created_at | string(date-time) | false | нет | none |
Order
{
"id": 0,
"trade_no": "string",
"out_trade_no": "string",
"product_id": 0,
"product_type": 0,
"amount": 0,
"unit_price": 0.1,
"total_fee": 0.1,
"goods_fee": 0.1,
"pay_fee": 0.1,
"discount_fee": 0.1,
"handling_fee": 0.1,
"refund_fee": 0.1,
"pm_id": 0,
"pm_title": "string",
"pm_logo": "string",
"status": 0,
"title": "string",
"detail": "string",
"region_desc": "string",
"pay_at": "2019-08-24T14:15:22Z",
"pay_timestamp": 0,
"created_at": "2019-08-24T14:15:22Z",
"pay_fee_status": 0,
"invoice": {
"name": "string",
"org_name": "string",
"first_name": "string",
"last_name": "string",
"phone": "string",
"email": "[email protected]",
"role_type": 0,
"vat_id": "string",
"address_country": "string",
"address_city": "string",
"address_line1": "string",
"address_line2": "string",
"address_postal_code": "string"
}
}
Свойства
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| id | integer | false | нет | Идентификатор заказа |
| trade_no | string | false | нет | Внутренний номер заказа |
| out_trade_no | string | false | нет | Внешний номер заказа |
| product_id | integer | false | нет | Идентификатор пакета |
| product_type | integer | false | нет | Тип упаковки, см. перечисление типов продуктов. |
| amount | integer | false | нет | Количество покупки |
| unit_price | number(float) | false | нет | цена за единицу |
| total_fee | number(float) | false | нет | Общая стоимость заказа (без учета скидок и комиссий за обработку) |
| goods_fee | number(float) | false | нет | Цена продукта (включая скидки, без учета комиссий за обработку) |
| pay_fee | number(float) | false | нет | Фактическая уплаченная сумма (включая скидки и комиссию за обработку) |
| discount_fee | number(float) | false | нет | Сумма скидки |
| handling_fee | number(float) | false | нет | плата за обработку |
| refund_fee | number(float) | false | нет | Сумма возврата |
| pm_id | integer | false | нет | Идентификатор способа оплаты (из /openapi/payation/list) |
| pm_title | string | false | нет | Название способа оплаты |
| pm_logo | string | false | нет | Способ оплаты URL-адрес логотипа |
| status | integer | false | нет | Статус заказа |
| title | string | false | нет | Название пакета |
| detail | string | false | нет | Описание пакета |
| region_desc | string | false | нет | Описание спецификации региона |
| pay_at | string(date-time) | false | нет | время оплаты |
| pay_timestamp | integer | false | нет | Временная метка платежа |
| created_at | string(date-time) | false | нет | время создания |
| pay_fee_status | integer | false | нет | Статус длинного и короткого платежа: 0 обычный 1 длинный платеж (переплата) 2 короткий платеж |
| invoice | object | false | нет | Информация о счете (ценна только для онлайн-платежных заказов) |
| » name | string | false | нет | полное имя |
| » org_name | string | false | нет | Название компании |
| » first_name | string | false | нет | none |
| » last_name | string | false | нет | none |
| » phone | string | false | нет | none |
| string(email) | false | нет | none | |
| » role_type | integer | false | нет | 1 человек 2 компании |
| » vat_id | string | false | нет | Идентификационный номер налогоплательщика |
| » address_country | string | false | нет | none |
| » address_city | string | false | нет | none |
| » address_line1 | string | false | нет | none |
| » address_line2 | string | false | нет | none |
| » address_postal_code | string | false | нет | none |
OrderCheckResult
{
"product_id": 0,
"amount": 0,
"discount_fee": 0.1,
"total_fee": 0.1,
"pay_fee": 0.1,
"product_type": 0,
"title": "string",
"detail": "string",
"ip_result": [
{
"ip": "string",
"price": 0.1,
"country_code": "string",
"current_time": "2019-08-24T14:15:22Z",
"renewal_time": "2019-08-24T14:15:22Z",
"country": {
"name_zh_cn": "string",
"flag": "string",
"square_flag": "string"
}
}
]
}
Заказать результаты предварительной проверки
Свойства
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| product_id | integer | false | нет | Идентификатор пакета |
| amount | integer | false | нет | Количество |
| discount_fee | number(float) | false | нет | Сумма скидки |
| total_fee | number(float) | false | нет | Общая сумма заказа |
| pay_fee | number(float) | false | нет | Фактическая выплаченная сумма |
| product_type | integer | false | нет | Тип упаковки |
| title | string | false | нет | Название пакета |
| detail | string | false | нет | Описание пакета |
| ip_result | [object] | false | нет | Результаты пакетного продления IP (возвращаются только во время продления IP) |
| » ip | string | false | нет | none |
| » price | number(float) | false | нет | none |
| » country_code | string | false | нет | none |
| » current_time | string(date-time) | false | нет | none |
| » renewal_time | string(date-time) | false | нет | none |
| » country | object | false | нет | none |
| »» name_zh_cn | string | false | нет | none |
| »» flag | string | false | нет | URL-адрес кругового флага |
| »» square_flag | string | false | нет | URL-адрес квадратного флага |
Product
{
"id": 0,
"title": "string",
"type": 0,
"show_type": 0,
"status": 0,
"price": 0.1,
"usd_price": 0.1,
"price_hkd": 0.1,
"original_price": 0.1,
"original_usd_price": 0.1,
"original_price_hkd": 0.1,
"local_price": 0.1,
"local_original_price": 0.1,
"preferred_currency": "string",
"support_currencies": "string",
"flow_value": 0.1,
"flow_give": 0.1,
"balance_give": 0.1,
"balance_value": 0.1,
"time_validity": 0.1,
"time_price": 0.1,
"time_days": 0,
"tip1": "string",
"tip2": "string",
"introduce": [
"string"
],
"region_list_id": 0,
"renew_product_list": "string",
"parent_product_type": 0,
"total_count": 0,
"remain_count": 0,
"extension_of_time_days": [
0
],
"time_days_price_rate": 0.1,
"desc": {
"subtitle": "string",
"flow_value": 0.1,
"flow_give": 0.1,
"balance_give": 0.1,
"time_validity": 0.1,
"time_price": 0.1,
"tip1": "string",
"tip2": "string",
"introduce": [
"string"
]
},
"sku": {
"bandwidth_list": [
{
"id": 0,
"value": 0,
"price": 0.1,
"price_usd": 0.1,
"price_hkd": 0.1
}
],
"duration_list": [
{
"id": 0,
"value": 0,
"price": 0.1,
"price_usd": 0.1,
"price_hkd": 0.1
}
],
"concurrency_list": [
{
"id": 0,
"value": 0,
"price": 0.1,
"price_usd": 0.1,
"price_hkd": 0.1
}
]
}
}
Свойства
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| id | integer | false | нет | Идентификатор пакета |
| title | string | false | нет | Основное название пакета |
| type | integer | false | нет | Тип упаковки |
| show_type | integer | false | нет | Тип дисплея: 1 Обычный 2 Большая рекомендация 3 Не доступен для покупки (требуется настройка) 4 Пробная версия |
| status | integer | false | нет | Статус: 1 на полках 0 нет на полках |
| price | number(float) | false | нет | Цена в юанях |
| usd_price | number(float) | false | нет | цена в долларах |
| price_hkd | number(float) | false | нет | Цена гонконгского доллара |
| original_price | number(float) | false | нет | Первоначальная цена (юаней) |
| original_usd_price | number(float) | false | нет | Первоначальная цена (долл. США) |
| original_price_hkd | number(float) | false | нет | Первоначальная цена (HKD) |
| local_price | number(float) | false | нет | Локализованная цена (зависит от предпочтительной валюты) |
| local_original_price | number(float) | false | нет | Локализованная исходная цена (зависит от предпочтительной валюты) |
| preferred_currency | string | false | нет | Рекомендуется отображать валюту, например usd/cny/hkd. |
| support_currencies | string | false | нет | Список поддерживаемых валют, разделенных запятыми, например usd,cny. |
| flow_value | number(float) | false | нет | Трафик тарифного плана по умолчанию (ГБ) |
| flow_give | number(float) | false | нет | Бесплатный трафик (ГБ) |
| balance_give | number(float) | false | нет | Бонус на пополнение баланса |
| balance_value | number(float) | false | нет | Сумма пополнения |
| time_validity | number(float) | false | нет | Срок действия стандартных планов по умолчанию |
| time_price | number(float) | false | нет | Стоимость стандартного пакета за IP |
| time_days | integer | false | нет | Количество дней действия, например 30/90/180/365. |
| tip1 | string | false | нет | Описание этикетки 1 |
| tip2 | string | false | нет | Описание этикетки 2 |
| introduce | [string] | false | нет | Текстовый вводный список |
| region_list_id | integer | false | нет | Идентификатор региона |
| renew_product_list | string | false | нет | Список идентификаторов возобновляемых пакетов (через запятую) |
| parent_product_type | integer | false | нет | Тип родительского пакета (действителен, если тип = 19): 14 или 25. |
| total_count | integer | false | нет | Общий запас, 0 означает отсутствие ограничений. |
| remain_count | integer | false | нет | оставшийся запас |
| extension_of_time_days | [integer] | false | нет | Список кратных продолжительности. Если он пуст или содержит только 1, это означает, что он не поддерживается. |
| time_days_price_rate | number(float) | false | нет | Ценовой коэффициент продолжительности, цена × (1 + (кратный-1) × ставка) |
| desc | object | false | нет | Информация об описании пакета |
| » subtitle | string | false | нет | субтитры |
| » flow_value | number(float) | false | нет | none |
| » flow_give | number(float) | false | нет | none |
| » balance_give | number(float) | false | нет | none |
| » time_validity | number(float) | false | нет | none |
| » time_price | number(float) | false | нет | none |
| » tip1 | string | false | нет | none |
| » tip2 | string | false | нет | none |
| » introduce | [string] | false | нет | none |
| sku | object | false | нет | Параметры спецификации (возвращаются, если тип = 11) |
| » bandwidth_list | [object] | false | нет | Список характеристик пропускной способности |
| »» id | integer | false | нет | none |
| »» value | integer | false | нет | Значение пропускной способности (Мбит/с) |
| »» price | number(float) | false | нет | none |
| »» price_usd | number(float) | false | нет | none |
| »» price_hkd | number(float) | false | нет | none |
| » duration_list | [object] | false | нет | Список спецификаций длительности |
| »» id | integer | false | нет | none |
| »» value | integer | false | нет | Продолжительность (дни) |
| »» price | number(float) | false | нет | none |
| »» price_usd | number(float) | false | нет | none |
| »» price_hkd | number(float) | false | нет | none |
| » concurrency_list | [object] | false | нет | Список спецификаций параллелизма |
| »» id | integer | false | нет | none |
| »» value | integer | false | нет | Количество параллелизма |
| »» price | number(float) | false | нет | none |
| »» price_usd | number(float) | false | нет | none |
| »» price_hkd | number(float) | false | нет | none |
WhiteIp
{
"id": 0,
"ip": "string",
"remark": "string",
"created_at": "2019-08-24T14:15:22Z"
}
Свойства
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| id | integer | false | нет | none |
| ip | string | false | нет | none |
| remark | string | false | нет | none |
| created_at | string(date-time) | false | нет | none |
WhitelistAccount
{
"id": 0,
"username": "string",
"limit": 0,
"used": 0,
"status": 0
}
Свойства
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| id | integer | false | нет | none |
| username | string | false | нет | none |
| limit | integer | false | нет | none |
| used | integer | false | нет | none |
| status | integer | false | нет | none |
Coupon
{
"id": 0,
"name": "string",
"code": "string",
"discount": 0.1,
"expire_time": "2019-08-24T14:15:22Z"
}
Свойства
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| id | integer | false | нет | none |
| name | string | false | нет | none |
| code | string | false | нет | none |
| discount | number(float) | false | нет | none |
| expire_time | string(date-time) | false | нет | none |
Article
{
"id": 0,
"title": "string",
"content": "string",
"created_at": "2019-08-24T14:15:22Z"
}
Свойства
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| id | integer | false | нет | none |
| title | string | false | нет | none |
| content | string | false | нет | none |
| created_at | string(date-time) | false | нет | none |
Pagination
{
"total": 0,
"page_no": 0,
"page_size": 0,
"total_pages": 0
}
Свойства
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| total | integer | false | нет | none |
| page_no | integer | false | нет | none |
| page_size | integer | false | нет | none |
| total_pages | integer | false | нет | none |
AutoRenewalConfig
{
"id": 1,
"user_id": 1,
"team_id": "A1b2C3d4E5f6",
"team_user_id": 0,
"product_type": 0,
"left_traffic": 0,
"left_days": 0,
"user_product_id": 1,
"product_id": 0,
"status": 0,
"currency": "string",
"agreed_price": 0,
"agreed_bandwidth_price": 0,
"agreed_concurrency_price": 0,
"bandwidth_id": 0,
"concurrency_id": 0,
"duration": 0,
"renew_product_id": 0,
"days_before_expire": 0,
"traffic_threshold": 0,
"parent_product_type": 0,
"created_at": "string",
"updated_at": "string"
}
Снимок конфигурации автоматического продления одного пакета
Свойства
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| id | integer | false | нет | none |
| user_id | integer | false | нет | none |
| team_id | ResourceSpaceId | false | нет | Идентификация пространства государственных ресурсов; опустите team_id или передайте пустую строку при запросе личного пространства и пустую строку при ответе на личное пространство; и число 0, и строка «0» незаконны, а в командном пространстве используется 6-12-значный публичный идентификатор команды. |
| team_user_id | integer | false | нет | none |
| product_type | integer | false | нет | none |
| left_traffic | integer | false | нет | Устаревшее поле |
| left_days | integer | false | нет | Устаревшее поле |
| user_product_id | integer | false | нет | none |
| product_id | integer | false | нет | Устаревшее поле |
| status | integer | false | нет | 0=отключить, 1=включить |
| currency | string | false | нет | none |
| agreed_price | number | false | нет | Согласованная общая стоимость |
| agreed_bandwidth_price | number | false | нет | Согласованная цена за единицу полосы пропускания для Пакета 11 |
| agreed_concurrency_price | number | false | нет | Согласованная цена за единицу пакета 11 |
| bandwidth_id | integer | false | нет | none |
| concurrency_id | integer | false | нет | none |
| duration | integer | false | нет | Срок продления, ед. день |
| renew_product_id | integer | false | нет | none |
| days_before_expire | integer | false | нет | none |
| traffic_threshold | integer | false | нет | Порог трафика, единица измерения базы данных, КБ |
| parent_product_type | integer | false | нет | none |
| created_at | string | false | нет | none |
| updated_at | string | false | нет | none |
Допустимые значения
| Свойство | Значение |
|---|---|
| status | 0 |
| status | 1 |
AutoRenewalLog
{
"id": 1,
"user_id": 1,
"team_id": "A1b2C3d4E5f6",
"team_user_id": 0,
"config_id": 0,
"user_product_id": 1,
"product_type": 0,
"renew_product_id": 0,
"order_id": 0,
"fee": 0,
"currency": "string",
"before_expired_at": "string",
"after_expired_at": "string",
"before_remain": 0,
"after_remain": 0,
"trigger_type": 0,
"status": 1,
"revoke_at": "string",
"revoke_remark": "string",
"created_at": "string",
"updated_at": "string"
}
Свойства
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| id | integer | true | нет | none |
| user_id | integer | true | нет | none |
| team_id | ResourceSpaceId | true | нет | Идентификация пространства государственных ресурсов; опустите team_id или передайте пустую строку при запросе личного пространства и пустую строку при ответе на личное пространство; и число 0, и строка «0» незаконны, а в командном пространстве используется 6-12-значный публичный идентификатор команды. |
| team_user_id | integer | true | нет | none |
| config_id | integer | true | нет | none |
| user_product_id | integer | true | нет | none |
| product_type | integer | true | нет | none |
| renew_product_id | integer | true | нет | none |
| order_id | integer | true | нет | none |
| fee | number | true | нет | none |
| currency | string | true | нет | none |
| before_expired_at | string,null | false | нет | none |
| after_expired_at | string,null | false | нет | none |
| before_remain | integer(int64) | true | нет | none |
| after_remain | integer(int64) | true | нет | none |
| trigger_type | integer | true | нет | 0=до истечения срока действия, 1=недостаточно трафика |
| status | integer | true | нет | 1 = успех, 2 = отозван, 3 = неудача |
| revoke_at | string,null | false | нет | none |
| revoke_remark | string | true | нет | none |
| created_at | string | true | нет | none |
| updated_at | string | true | нет | none |
Допустимые значения
| Свойство | Значение |
|---|---|
| trigger_type | 0 |
| trigger_type | 1 |
| status | 1 |
| status | 2 |
| status | 3 |
MonthlyRenewalBatch
{
"type": "current",
"start_at": "string",
"end_at": "string",
"target_expired_at": "string",
"timezone": "string"
}
Свойства
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| type | string | true | нет | none |
| start_at | string | true | нет | none |
| end_at | string | true | нет | none |
| target_expired_at | string | true | нет | none |
| timezone | string | true | нет | none |
Допустимые значения
| Свойство | Значение |
|---|---|
| type | current |
| type | next |
MonthlyRenewalItem
{
"id": 0,
"user_product_id": 1,
"product_id": 1,
"product_type": 0,
"parent_product_type": 0,
"title": "string",
"expired_at": "string",
"target_expired_at": "string",
"renew_days": 1,
"unit_month_price": 0,
"pay_fee": 0,
"currency": "string",
"bandwidth": 0,
"bandwidth_mbsp": 0,
"concurrency": 0,
"ip": "string",
"country_code": "string",
"paid_at": "string",
"refunded_at": "string",
"created_at": "string",
"updated_at": "string"
}
Свойства
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| id | integer | false | нет | Идентификатор исторической платежной информации |
| user_product_id | integer | true | нет | none |
| product_id | integer | true | нет | none |
| product_type | integer | true | нет | none |
| parent_product_type | integer | true | нет | none |
| title | string | true | нет | none |
| expired_at | string | true | нет | none |
| target_expired_at | string | true | нет | none |
| renew_days | integer | true | нет | none |
| unit_month_price | number | false | нет | none |
| pay_fee | number | true | нет | none |
| currency | string | true | нет | none |
| bandwidth | integer | false | нет | none |
| bandwidth_mbsp | number | false | нет | Значение преобразования пропускной способности |
| concurrency | integer | false | нет | none |
| ip | string | false | нет | Статический IP-пакет возвращается |
| country_code | string | false | нет | Статический IP-пакет возвращается |
| paid_at | string,null | false | нет | none |
| refunded_at | string,null | false | нет | none |
| created_at | string | false | нет | none |
| updated_at | string | false | нет | none |
InvoiceRecord
{
"id": 1,
"invoice_no": "string",
"invoice_amount": 0,
"invoice_download_url": "string",
"status": 0,
"remark": "string",
"order_ids": [
0
],
"created_at": 0,
"invoice_info": {
"invoice_code": "string",
"name": "string",
"org_name": "string",
"role_type": 1,
"invoice_type": 0
}
}
Свойства
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| id | integer | true | нет | none |
| invoice_no | string | true | нет | none |
| invoice_amount | number | true | нет | none |
| invoice_download_url | string | true | нет | none |
| status | integer | true | нет | none |
| remark | string | true | нет | none |
| order_ids | [integer] | true | нет | none |
| created_at | integer | true | нет | Временная метка Unix |
| invoice_info | any | true | нет | none |
oneOf
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| » anonymous | object | false | нет | none |
| »» invoice_code | string | true | нет | none |
| »» name | string | true | нет | none |
| »» org_name | string | true | нет | none |
| »» role_type | integer | true | нет | none |
| »» invoice_type | integer | true | нет | none |
xor
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| » anonymous | null | false | нет | none |
Допустимые значения
| Свойство | Значение |
|---|---|
| role_type | 1 |
| role_type | 2 |
| invoice_type | 0 |
| invoice_type | 1 |
| invoice_type | 2 |
PayCheckData
{
"trade_no": "string",
"pm_id": 0,
"pay_method": 0,
"trade_type": "string",
"country_code": "string",
"currency": "string",
"goods_fee": 0,
"discount_fee": 0,
"handling_fee": 0,
"pay_fee": 0,
"total_fee": 0,
"pay_method_info": {
"id": 0,
"type": 0,
"title": "string",
"group": "string",
"handling_rate": 0,
"handling_fee": 0,
"handling_fee_currency": "usd",
"handling_fee_converted": 0
},
"origin": {
"pm_id": 0,
"pay_method": 0,
"goods_fee": 0,
"discount_fee": 0,
"handling_fee": 0,
"pay_fee": 0,
"total_fee": 0
}
}
Свойства
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| trade_no | string | true | нет | none |
| pm_id | integer | true | нет | none |
| pay_method | integer | true | нет | none |
| trade_type | string | true | нет | none |
| country_code | string | true | нет | none |
| currency | string | true | нет | none |
| goods_fee | number | true | нет | none |
| discount_fee | number | true | нет | none |
| handling_fee | number | true | нет | none |
| pay_fee | number | true | нет | none |
| total_fee | number | true | нет | none |
| pay_method_info | any | true | нет | none |
oneOf
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| » anonymous | object | false | нет | none |
| »» id | integer | true | нет | none |
| »» type | integer | true | нет | none |
| »» title | string | true | нет | none |
| »» group | string | true | нет | none |
| »» handling_rate | number | true | нет | none |
| »» handling_fee | number | true | нет | none |
| »» handling_fee_currency | string | true | нет | none |
| »» handling_fee_converted | number | true | нет | none |
xor
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| » anonymous | null | false | нет | none |
continued
| Имя | Тип | Обязательно | Ограничения | Описание |
|---|---|---|---|---|
| origin | object | true | нет | none |
| » pm_id | integer | true | нет | none |
| » pay_method | integer | true | нет | none |
| » goods_fee | number | true | нет | none |
| » discount_fee | number | true | нет | none |
| » handling_fee | number | true | нет | none |
| » pay_fee | number | true | нет | none |
| » total_fee | number | true | нет | none |