title: NSocks language_tabs:
- shell: Shell
- http: HTTP
- javascript: JavaScript
- ruby: Ruby
- python: Python
- php: PHP
- java: Java
- go: Go toc_footers: [] includes: [] search: true code_clipboard: true highlight_theme: darkula headingLevel: 2 generator: "@tarslib/widdershins v4.0.30"
NSocks
Чтобы просмотреть ключ аутентификации app_key войдите в систему на главной странице вашего личного кабинета.
Пожалуйста, храните свой ключ в безопасном месте. У вас есть права администратора для работы с этим ключом.
Метод аутентификации
Ключ приложения
Параметры POST:
app_key: {your_app_key}
Или в качестве параметра запроса:
?app_key={your_app_key}
Формат ответа
Все API возвращают данные в едином формате JSON:
{
"код": 200,
"message": "操作成功",
"данные": {}
}
code: Код состояния, 200 означает успех, другие значения — неудачу.message: Ответное сообщение (на китайском языке)data: данные ответа
Базовые URL-адреса:
Аутентификация
HTTP-аутентификация, схема: bearer
Ключ API (apiKeyAuth)
- Имя параметра: app_key , в: query. 支持GET/POST,имя 支持
Управление агентскими аккаунтами
Получить список прокси-аккаунтов
GET /ep/whitelist-account/list
Вернуться к примеру
Ответ 200
{
"код": 200,
"msg": "string",
"данные": {
"список": [
{
"id": 0,
"имя пользователя": "строка",
"password": "string",
"created_at": "string",
"примечание": "строка",
"product_type": 9,
"usage_flow": 0,
"limit_flow": 102400,
"статус": 0
}
]
}
}
Возвращает результаты
| коды состояния | Значение кода состояния | иллюстрировать | Модель данных |
|---|---|---|---|
| 200 | OK | Запрос выполнен успешно. | В соответствии |
Возвращаемая структура данных
Код состояния 200
| имя | тип | Необходимый | ограничение | Китайское имя | иллюстрировать |
|---|---|---|---|---|---|
| » код | responseCode | ЛОЖЬ | никто | Коды состояния: 200 — Успех, 3 — Недействительный app_key | |
| » сообщение | нить | ЛОЖЬ | никто | Сообщения о состоянии | |
| данные | объект | ЛОЖЬ | никто | никто | |
| "" список | [объект] | ЛОЖЬ | никто | никто | |
| """ идентификатор | целое число | ЛОЖЬ | никто | Номер счета | |
| """ имя пользователя | нить | ЛОЖЬ | никто | Имя учетной записи агента | |
| """ пароль | нить | ЛОЖЬ | никто | Пароль прокси-аккаунта | |
| создано_в | нить | ЛОЖЬ | никто | Добавить время | |
| »»» замечание | нить | ЛОЖЬ | никто | Примечание | |
| тип продукта | Типы продуктов | ЛОЖЬ | никто | Типы пакетов: 9 динамических пакетов для домашнего трафика, 11 динамических пакетов IP-адресов для домашнего трафика, 14 статических пакетов IP-адресов для центров обработки данных, 25 статических пакетов IP-адресов для домашнего трафика. | |
| »»» usage_flow | целое число | ЛОЖЬ | никто | Объем использованных данных, в КБ | |
| »»» limit_flow | целое число | ЛОЖЬ | никто | Пользовательский лимит трафика: максимум 102400 ГБ, 0 — без ограничений. | |
| статус »»» | целое число | ЛОЖЬ | никто | Статус включения: 1 включено, 0 выключено |
Значение перечисления
| свойство | ценить |
|---|---|
| тип продукта | 9 |
| тип продукта | 11 |
| тип продукта | 14 |
| тип продукта | 25 |
POST Добавить прокси-аккаунт.
POST /ep/whitelist-account/add
Параметры запроса тела
{
"app_key": "stringstringstringstringstringst",
"учетные записи": "user01:pass,user02:pass,user03:pass",
"замечание": "",
"product_type": 9
}
Параметры запроса
| имя | Расположение | тип | Необходимый | иллюстрировать |
|---|---|---|---|---|
| тело | тело | объект | нет | никто |
| » app_key | тело | нить | нет | Ключ авторизации |
| » аккаунты | тело | нить | нет | Пожалуйста, введите ваше имя пользователя и пароль в формате имя пользователя:пароль. Допускаются только цифры и буквы; специальные символы и пробелы запрещены. Разделяйте имя пользователя и пароль двоеточием. Поддерживается пакетное добавление; разделяйте учетные записи прокси запятыми (,). |
| замечание | тело | нить | нет | Описание учетной записи агента |
| » тип_продукта | тело | Типы продуктов | нет | Типы пакетов: 9 динамических пакетов для домашнего трафика, 11 динамических пакетов IP-адресов для домашнего трафика, 14 статических пакетов IP-адресов для центров обработки данных, 25 статических пакетов IP-адресов для домашнего трафика. |
Значение перечисления
| свойство | ценить |
|---|---|
| » тип_продукта | 9 |
| » тип_продукта | 11 |
| » тип_продукта | 14 |
| » тип_продукта | 25 |
Вернуться к примеру
Ответ 200
{
"код": 200,
"msg": "string",
"данные": null
}
Возвращает результаты
| коды состояния | Значение кода состояния | иллюстрировать | Модель данных |
|---|---|---|---|
| 200 | OK | Запрос выполнен успешно. | В соответствии |
Возвращаемая структура данных
Код состояния 200
| имя | тип | Необходимый | ограничение | Китайское имя | иллюстрировать |
|---|---|---|---|---|---|
| » код | целое число | ЛОЖЬ | никто | Коды состояния: 200 Успех, 3 Недействительный ключ приложения, 156 Учетная запись не подтверждена. | |
| » сообщение | нить | ЛОЖЬ | никто | Сообщения о состоянии | |
| данные | нулевой | ЛОЖЬ | никто | никто |
Удалить учетную запись агента (POST)
POST /ep/whitelist-account/delete
Обратите внимание, что удаление необратимо, и использованные данные восстановить невозможно. Удаление занимает приблизительно 5 минут, в течение которых может взиматься плата.
Параметры запроса тела
{
"app_key": "stringstringstringstringstringst",
"учетные записи": "пользователь01,пользователь02"
}
Параметры запроса
| имя | Расположение | тип | Необходимый | иллюстрировать |
|---|---|---|---|---|
| тело | тело | объект | нет | никто |
| » app_key | тело | нить | нет | Ключ авторизации |
| » аккаунты | тело | нить | нет | В учетных записях агентов поддерживаются только цифры и буквы. Поддерживаются пакетные операции; учетные записи агентов разделяются запятыми (,). |
Вернуться к примеру
Ответ 200
{
"код": 200,
"msg": "string",
"данные": null
}
Возвращает результаты
| коды состояния | Значение кода состояния | иллюстрировать | Модель данных |
|---|---|---|---|
| 200 | OK | Запрос выполнен успешно. | В соответствии |
Возвращаемая структура данных
Код состояния 200
| имя | тип | Необходимый | ограничение | Китайское имя | иллюстрировать |
|---|---|---|---|---|---|
| » код | целое число | ЛОЖЬ | никто | Коды состояния: 200 Успех, 3 Недействительный ключ приложения, 156 Учетная запись не подтверждена. | |
| » сообщение | нить | ЛОЖЬ | никто | Сообщения о состоянии | |
| данные | нулевой | ЛОЖЬ | никто | никто |
POST Отключить прокси-аккаунт
POST /ep/whitelist-account/disable
После отключения системы предусмотрено примерно 5-минутное ожидание, в течение которого могут взиматься дополнительные сборы.
Параметры запроса тела
{
"app_key": "stringstringstringstringstringst",
"учетные записи": "пользователь01,пользователь02"
}
Параметры запроса
| имя | Расположение | тип | Необходимый | иллюстрировать |
|---|---|---|---|---|
| тело | тело | объект | нет | никто |
| » app_key | тело | нить | нет | Ключ авторизации |
| » аккаунты | тело | нить | нет | В учетных записях агентов поддерживаются только цифры и буквы. Поддерживаются пакетные операции; учетные записи агентов разделяются запятыми (,). |
Вернуться к примеру
Ответ 200
{
"код": 200,
"msg": "string",
"данные": null
}
Возвращает результаты
| коды состояния | Значение кода состояния | иллюстрировать | Модель данных |
|---|---|---|---|
| 200 | OK | Запрос выполнен успешно. | В соответствии |
Возвращаемая структура данных
Код состояния 200
| имя | тип | Необходимый | ограничение | Китайское имя | иллюстрировать |
|---|---|---|---|---|---|
| » код | целое число | ЛОЖЬ | никто | Коды состояния: 200 Успех, 3 Недействительный ключ приложения, 156 Учетная запись не подтверждена. | |
| » сообщение | нить | ЛОЖЬ | никто | Сообщения о состоянии | |
| данные | нулевой | ЛОЖЬ | никто | никто |
POST Включить прокси-аккаунт
POST /ep/whitelist-account/enable
Параметры запроса тела
{
"app_key": "stringstringstringstringstringst",
"учетные записи": "пользователь01,пользователь02"
}
Параметры запроса
| имя | Расположение | тип | Необходимый | иллюстрировать |
|---|---|---|---|---|
| тело | тело | объект | нет | никто |
| » app_key | тело | нить | нет | Ключ авторизации |
| » аккаунты | тело | нить | нет | В учетных записях агентов поддерживаются только цифры и буквы. Поддерживаются пакетные операции; учетные записи агентов разделяются запятыми (,). |
Вернуться к примеру
Ответ 200
{
"код": 200,
"msg": "string",
"данные": null
}
Возвращает результаты
| коды состояния | Значение кода состояния | иллюстрировать | Модель данных |
|---|---|---|---|
| 200 | OK | Запрос выполнен успешно. | В соответствии |
Возвращаемая структура данных
Код состояния 200
| имя | тип | Необходимый | ограничение | Китайское имя | иллюстрировать |
|---|---|---|---|---|---|
| » код | целое число | ЛОЖЬ | никто | Коды состояния: 200 Успех, 3 Недействительный ключ приложения, 156 Учетная запись не подтверждена. | |
| » сообщение | нить | ЛОЖЬ | никто | Сообщения о состоянии | |
| данные | нулевой | ЛОЖЬ | никто | никто |
POST-запрос для изменения пароля прокси-аккаунта
POST /ep/whitelist-account/change-password
Обратите внимание, что после внесения изменений необходимо подождать 5 минут. В течение этого времени старый пароль может по-прежнему работать в обычном режиме.
Параметры запроса тела
{
"app_key": "stringstringstringstringstringst",
"аккаунт": "пользователь",
"password": "pass"
}
Параметры запроса
| имя | Расположение | тип | Необходимый | иллюстрировать |
|---|---|---|---|---|
| тело | тело | объект | нет | никто |
| » app_key | тело | нить | нет | Ключ авторизации |
| " счет | тело | нить | нет | В учетных записях агентов поддерживаются только цифры и буквы. |
| " пароль | тело | нить | нет | Новый пароль для учетной записи агента поддерживает только цифры и буквы. |
Вернуться к примеру
Ответ 200
{
"код": 200,
"msg": "string",
"данные": null
}
Возвращает результаты
| коды состояния | Значение кода состояния | иллюстрировать | Модель данных |
|---|---|---|---|
| 200 | OK | Запрос выполнен успешно. | В соответствии |
Возвращаемая структура данных
Код состояния 200
| имя | тип | Необходимый | ограничение | Китайское имя | иллюстрировать |
|---|---|---|---|---|---|
| » код | целое число | ЛОЖЬ | никто | Коды состояния: 200 Успех, 3 Недействительный ключ приложения, 156 Учетная запись не подтверждена. | |
| » сообщение | нить | ЛОЖЬ | никто | Сообщения о состоянии | |
| данные | нулевой | ЛОЖЬ | никто | никто |
POST-запрос для изменения примечаний к учетной записи агента.
POST /ep/whitelist-account/change-remark
Параметры запроса тела
{
"app_key": "stringstringstringstringstringst",
"аккаунт": "пользователь",
"примечание": ""
}
Параметры запроса
| имя | Расположение | тип | Необходимый | иллюстрировать |
|---|---|---|---|---|
| тело | тело | объект | нет | никто |
| » app_key | тело | нить | нет | Ключ авторизации |
| " счет | тело | нить | нет | В учетных записях агентов поддерживаются только цифры и буквы. |
| замечание | тело | нить | нет | Новое примечание для агентского аккаунта: не более 32 китайских или 64 английских символов. |
Вернуться к примеру
Ответ 200
{
"код": 200,
"msg": "string",
"данные": null
}
Возвращает результаты
| коды состояния | Значение кода состояния | иллюстрировать | Модель данных |
|---|---|---|---|
| 200 | OK | Запрос выполнен успешно. | В соответствии |
Возвращаемая структура данных
Код состояния 200
| имя | тип | Необходимый | ограничение | Китайское имя | иллюстрировать |
|---|---|---|---|---|---|
| » код | целое число | ЛОЖЬ | никто | Коды состояния: 200 Успех, 3 Недействительный ключ приложения, 156 Учетная запись не подтверждена. | |
| » сообщение | нить | ЛОЖЬ | никто | Сообщения о состоянии | |
| данные | нулевой | ЛОЖЬ | никто | никто |
Отправьте POST-запрос для изменения лимита трафика прокси-аккаунта.
POST /ep/whitelist-account/change-limit
Обратите внимание, что статистика трафика может отображаться с задержкой до 5 минут, а это значит, что фактический объем трафика может превысить этот лимит.
Параметры запроса тела
{
"app_key": "stringstringstringstringstringst",
"аккаунт": "пользователь",
"лимит": 0
}
Параметры запроса
| имя | Расположение | тип | Необходимый | иллюстрировать |
|---|---|---|---|---|
| тело | тело | объект | нет | никто |
| » app_key | тело | нить | нет | Ключ авторизации |
| " счет | тело | нить | нет | В учетных записях агентов поддерживаются только цифры и буквы. |
| лимит | тело | целое число | нет | Ограничение движения, единица измерения: ГБ, 0 означает отсутствие ограничения. |
Вернуться к примеру
Ответ 200
{
"код": 200,
"msg": "string",
"данные": null
}
Возвращает результаты
| коды состояния | Значение кода состояния | иллюстрировать | Модель данных |
|---|---|---|---|
| 200 | OK | Запрос выполнен успешно. | В соответствии |
Возвращаемая структура данных
Код состояния 200
| имя | тип | Необходимый | ограничение | Китайское имя | иллюстрировать |
|---|---|---|---|---|---|
| » код | целое число | ЛОЖЬ | никто | Коды состояния: 200 Успех, 3 Недействительный ключ приложения, 156 Учетная запись не подтверждена. | |
| » сообщение | нить | ЛОЖЬ | никто | Сообщения о состоянии | |
| данные | нулевой | ЛОЖЬ | никто | никто |
Отправьте POST-запрос для изменения информации об учетной записи агента.
POST /ep/proxy-account/change
Измените пароль учетной записи прокси, заметки, лимит трафика, суточный лимит трафика, статус включения или переключатель UDP.
Параметры запроса тела
{
"app_key": "string",
"account": "string",
"password": "string",
"примечание": "строка",
"лимит": 0,
"daily_limit": 0,
"статус": 0,
"udp": 0
}
Параметры запроса
| имя | Расположение | тип | Необходимый | иллюстрировать |
|---|---|---|---|---|
| тело | тело | объект | нет | никто |
| » app_key | тело | нить | нет | Ключ авторизации |
| " счет | тело | нить | нет | Имя учетной записи агента |
| " пароль | тело | нить | нет | Новый пароль длиной от 6 до 16 символов (цифры или буквы); если он не будет передан другим лицам, он не будет изменен. |
| замечание | тело | нить | нет | Новая заметка |
| лимит | тело | целое число | нет | Ограничение на использование данных в ГБ; 0 означает отсутствие ограничения. |
| ежедневный_лимит | тело | целое число | нет | Суточный лимит использования данных (в ГБ); 0 означает отсутствие лимита. |
| » статус | тело | целое число | нет | Включено |
| » udp | тело | целое число | нет | Поддержка UDP включается/выключается и применима только к пакетам типов 14, 16, 21 и 25. |
Значение перечисления
| свойство | ценить |
|---|---|
| » статус | 0 |
| » статус | 1 |
| » udp | 0 |
| » udp | 1 |
Вернуться к примеру
Ответ 200
{
"код": 200,
"msg": "string",
"данные": null
}
Возвращает результаты
| коды состояния | Значение кода состояния | иллюстрировать | Модель данных |
|---|---|---|---|
| 200 | OK | Запрос выполнен успешно. | В соответствии |
Возвращаемая структура данных
Код состояния 200
| имя | тип | Необходимый | ограничение | Китайское имя | иллюстрировать |
|---|---|---|---|---|---|
| » код | целое число | ЛОЖЬ | никто | Код состояния 200 Успех | |
| » сообщение | нить | ЛОЖЬ | никто | Сообщения о состоянии | |
| данные | нулевой | ЛОЖЬ | никто | никто |
белый список IP-адресов
Получить список разрешенных IP-адресов
GET /ep/proxy-ip/list
Параметры запроса
| имя | Расположение | тип | Необходимый | иллюстрировать |
|---|---|---|---|---|
| тип продукта | запрос | целое число | нет | номер типа упаковки |
Вернуться к примеру
Ответ 200
{
"код": 200,
"msg": "string",
"данные": {
"список": [
{
"ip": "1.1.1.1",
"примечание": "строка",
"product_type": 0,
"created_at": "string"
}
]
}
}
Возвращает результаты
| коды состояния | Значение кода состояния | иллюстрировать | Модель данных |
|---|---|---|---|
| 200 | OK | Запрос выполнен успешно. | В соответствии |
Возвращаемая структура данных
Код состояния 200
| имя | тип | Необходимый | ограничение | Китайское имя | иллюстрировать |
|---|---|---|---|---|---|
| » код | целое число | ЛОЖЬ | никто | Код состояния 200 Успех | |
| » сообщение | нить | ЛОЖЬ | никто | Сообщения о состоянии | |
| данные | объект | ЛОЖЬ | никто | никто | |
| "" список | [объект] | ЛОЖЬ | никто | никто | |
| »»» ip | нить | ЛОЖЬ | никто | IP-адреса в белом списке | |
| »»» замечание | нить | ЛОЖЬ | никто | Примечание | |
| тип продукта | целое число | ЛОЖЬ | никто | Типы упаковки | |
| создано_в | нить | ЛОЖЬ | никто | Время создания |
POST Добавить IP-адрес в белый список
POST /ep/proxy-ip/add
Параметры запроса тела
{
"app_key": "string",
"ips": "1.1.1.1,2.2.2.2",
"примечание": "строка",
"product_type": 0,
"user_product_id": 0
}
Параметры запроса
| имя | Расположение | тип | Необходимый | иллюстрировать |
|---|---|---|---|---|
| тело | тело | объект | нет | никто |
| » app_key | тело | нить | нет | Ключ авторизации |
| » ипс | тело | нить | нет | Необходимо добавить IP-адреса из белого списка; разделяйте несколько IP-адресов запятыми или символами новой строки. |
| замечание | тело | нить | нет | Примечание |
| » тип_продукта | тело | целое число | нет | номер типа упаковки |
| » user_product_id | тело | целое число | нет | Идентификатор пользовательского пакета (обязательно, если тип пакета равен 11). |
Вернуться к примеру
Ответ 200
{
"код": 200,
"msg": "string",
"данные": null
}
Возвращает результаты
| коды состояния | Значение кода состояния | иллюстрировать | Модель данных |
|---|---|---|---|
| 200 | OK | Запрос выполнен успешно. | В соответствии |
Возвращаемая структура данных
Код состояния 200
| имя | тип | Необходимый | ограничение | Китайское имя | иллюстрировать |
|---|---|---|---|---|---|
| » код | целое число | ЛОЖЬ | никто | Код состояния 200 Успех | |
| » сообщение | нить | ЛОЖЬ | никто | Сообщения о состоянии | |
| данные | нулевой | ЛОЖЬ | никто | никто |
Отправьте POST-запрос для удаления IP-адреса из белого списка.
POST /ep/proxy-ip/delete
Параметры запроса тела
{
"app_key": "string",
"ips": "1.1.1.1,2.2.2.2",
"verify_type": "string",
"verify_code": "string"
}
Параметры запроса
| имя | Расположение | тип | Необходимый | иллюстрировать |
|---|---|---|---|---|
| тело | тело | объект | нет | никто |
| » app_key | тело | нить | нет | Ключ авторизации |
| » ипс | тело | нить | нет | Перечислите IP-адреса из белого списка, которые необходимо удалить, разделяя их запятыми. |
| » verify_type | тело | нить | нет | Адрес: телефон, электронная почта, wechat, totp. |
| » verify_code | тело | нить | нет | Проверочный код |
Вернуться к примеру
Ответ 200
{
"код": 200,
"msg": "string",
"данные": null
}
Возвращает результаты
| коды состояния | Значение кода состояния | иллюстрировать | Модель данных |
|---|---|---|---|
| 200 | OK | Запрос выполнен успешно. | В соответствии |
Возвращаемая структура данных
Код состояния 200
| имя | тип | Необходимый | ограничение | Китайское имя | иллюстрировать |
|---|---|---|---|---|---|
| » код | целое число | ЛОЖЬ | никто | Код состояния 200 Успех | |
| » сообщение | нить | ЛОЖЬ | никто | Сообщения о состоянии | |
| данные | нулевой | ЛОЖЬ | никто | никто |
Запрос журнала трафика
Сводка данных об использовании GET по дням
GET /ep/user-usage-flow/total
Параметры запроса
| имя | Расположение | тип | Необходимый | иллюстрировать |
|---|---|---|---|---|
| app_key | запрос | строка(пароль) | да | Ключ аутентификации |
| время начала | запрос | string(Ymd H:i:s) | нет | Время начала, с точностью до секунды. Обратите внимание, что при регистрации данных возможна задержка до 5 минут. По умолчанию — в пределах 7 дней. |
| конец_времени | запрос | string(Ymd H:i:s) | нет | Крайний срок, с точностью до секунды. Обратите внимание, что при регистрации может быть задержка до 5 минут. По умолчанию используется текущее время. |
| имя пользователя | запрос | нить | нет | Имя дочерней учетной записи: По умолчанию этот запрос извлекает все учетные записи. Вы можете указать дочернюю учетную запись. Обратите внимание, что если вы добавите дочернюю учетную запись с тем же именем, этот запрос вернет все записи об использовании той же учетной записи прокси. |
| тип продукта | запрос | число | нет | Типы упаковки |
Вернуться к примеру
Ответ 200
{
"код": 200,
"msg": "string",
"данные": {
"список": [
{
"день": "2022-08-01",
"поток": 0
}
]
}
}
Возвращает результаты
| коды состояния | Значение кода состояния | иллюстрировать | Модель данных |
|---|---|---|---|
| 200 | OK | Запрос выполнен успешно. | В соответствии |
Возвращаемая структура данных
Код состояния 200
| имя | тип | Необходимый | ограничение | Китайское имя | иллюстрировать |
|---|---|---|---|---|---|
| » код | целое число | ЛОЖЬ | никто | Коды состояния: 200 Успех, 3 Недействительный ключ приложения, 156 Учетная запись не подтверждена. | |
| » сообщение | нить | ЛОЖЬ | никто | Сообщения о состоянии | |
| данные | объект | ЛОЖЬ | никто | никто | |
| "" список | [объект] | ЛОЖЬ | никто | никто | |
| """ день | нить | ЛОЖЬ | никто | дата | |
| """ поток | целое число | ЛОЖЬ | никто | Потребление данных, в КБ |
Запрос по посылке
Получить список приобретенных пакетов
GET /ep/user-product/list
Параметры запроса
| имя | Расположение | тип | Необходимый | иллюстрировать |
|---|---|---|---|---|
| app_key | запрос | строка(пароль) | да | Ключ аутентификации |
| trade_no | запрос | нить | нет | Номер заказа. Пожалуйста, введите полный номер заказа. Нечеткий поиск не поддерживается. |
| страница | запрос | число | нет | Пагинация, по умолчанию: 1 |
| размер | запрос | число | нет | Количество страниц для отображения (по умолчанию: 20) |
| тип продукта | запрос | число | нет | Типы упаковки |
Вернуться к примеру
Ответ 200
{
"код": 200,
"msg": "string",
"данные": {
"список": [
{
"id": 0,
"created_at": "2022-05-13 12:14:15",
"expired_at": "2022-05-13 12:14:15",
"product_type": 9,
"trade_no": "2022051312134339861461465434",
"заказ": {
"created_at": "2022-05-13 12:13:43",
"pay_at": "2022-05-13 12:13:43",
"title": "入门级"
}
}
],
"страница": 1,
"page_size": 20,
"total_count": 0,
"total_page": 0
}
}
Возвращает результаты
| коды состояния | Значение кода состояния | иллюстрировать | Модель данных |
|---|---|---|---|
| 200 | OK | Запрос выполнен успешно. | В соответствии |
Возвращаемая структура данных
Код состояния 200
| имя | тип | Необходимый | ограничение | Китайское имя | иллюстрировать |
|---|---|---|---|---|---|
| » код | целое число | ЛОЖЬ | никто | Коды состояния: 200 Успех, 3 Недействительный ключ приложения, 156 Учетная запись не подтверждена. | |
| » сообщение | нить | ЛОЖЬ | никто | Сообщения о состоянии | |
| данные | объект | ЛОЖЬ | никто | никто | |
| "" список | [объект] | ЛОЖЬ | никто | никто | |
| """ идентификатор | целое число | ЛОЖЬ | никто | Номер упаковки | |
| создано_в | нить | ЛОЖЬ | никто | эффективное время упаковки | |
| »»» expired_at | нить | ЛОЖЬ | никто | Срок действия тарифного плана истекает; после этого данные станут непригодными для использования. | |
| тип продукта | Типы продуктов | ЛОЖЬ | никто | Типы пакетов: 9 динамических пакетов для домашнего трафика, 11 динамических пакетов IP-адресов для домашнего трафика, 14 статических пакетов IP-адресов для центров обработки данных, 25 статических пакетов IP-адресов для домашнего трафика. | |
| »»» trade_no | нить | ЛОЖЬ | никто | Номер транзакции заказа | |
| """ заказ | объект | ЛОЖЬ | никто | никто | |
| создано_в | нить | ЛОЖЬ | никто | Время создания заказа | |
| »»»» pay_at | нить | ЛОЖЬ | никто | время оплаты заказа | |
| """" заголовок | нить | ЛОЖЬ | никто | Описание заказа | |
| "" страница | целое число | ЛОЖЬ | никто | Текущая страница | |
| »» размер страницы | целое число | ЛОЖЬ | никто | Размер страницы | |
| »» total_count | целое число | ЛОЖЬ | никто | Общее количество записей | |
| »» total_page | целое число | ЛОЖЬ | никто | Общее количество страниц |
Значение перечисления
| свойство | ценить |
|---|---|
| тип продукта | 9 |
| тип продукта | 11 |
| тип продукта | 14 |
| тип продукта | 25 |
Получить сводку данных пользовательского пакета
GET /ep/user-product/summary
Получите сводную статистическую информацию о тарифных планах пользователей, включая общую сумму, действительную сумму, сумму, срок действия которой подходит к концу, и сумму, срок действия которой истек.
Параметры запроса
| имя | Расположение | тип | Необходимый | иллюстрировать |
|---|---|---|---|---|
| app_key | запрос | строка(пароль) | да | Ключ аутентификации |
| тип продукта | запрос | целое число | нет | Поддерживаются только 9 типов продуктов (пакет динамического трафика) и 12 (пакет долгосрочного трафика IDC). |
Значение перечисления
| свойство | ценить |
|---|---|
| тип продукта | 9 |
| тип продукта | 12 |
Вернуться к примеру
Ответ 200
{
"код": 200,
"msg": "Старт",
"данные": {
"Итого": 1048576,
"total_count": 5,
"эффективный": 524288,
"effective_count": 3,
"effective_total": 786432,
"effective_used": 262144,
"временный": 102400,
"temporary_count": 1,
"истек срок действия": 51200,
"expired_count": 1,
"использовано": 473088
}
}
Возвращает результаты
| коды состояния | Значение кода состояния | иллюстрировать | Модель данных |
|---|---|---|---|
| 200 | OK | Запрос выполнен успешно. | В соответствии |
Возвращаемая структура данных
Код состояния 200
| имя | тип | Необходимый | ограничение | Китайское имя | иллюстрировать |
|---|---|---|---|---|---|
| » код | целое число | ЛОЖЬ | никто | Коды состояния: 200 Успех, 3 Недействительный ключ приложения, 156 Учетная запись не подтверждена. | |
| » сообщение | нить | ЛОЖЬ | никто | Сообщения о состоянии | |
| данные | объект | ЛОЖЬ | никто | никто | |
| "" общий | целое число | ЛОЖЬ | никто | Общий объем трафика/IP-адресов (единица измерения: КБ) | |
| »» total_count | целое число | ЛОЖЬ | никто | Общее количество посылок | |
| эффективный | целое число | ЛОЖЬ | никто | Эффективное оставшееся количество (единица измерения: КБ) | |
| »» effective_count | целое число | ЛОЖЬ | никто | Количество действительных посылок | |
| »» effective_total | целое число | ЛОЖЬ | никто | Эффективный общий объем (единица измерения: КБ) | |
| »» effective_used | целое число | ЛОЖЬ | никто | Допустимое использование (единица измерения: КБ) | |
| "" временный | целое число | ЛОЖЬ | никто | Общее количество товаров, срок годности которых истекает в течение 7 дней (единица измерения: КБ). | |
| »» temporary_count | целое число | ЛОЖЬ | никто | Количество упаковок с истекающим сроком годности (срок годности которых истекает в течение 7 дней) | |
| "" истекший | целое число | ЛОЖЬ | никто | Истекший оставшийся объем (единица измерения: КБ) | |
| »» expired_count | целое число | ЛОЖЬ | никто | Количество просроченных упаковок | |
| "" использовал | целое число | ЛОЖЬ | никто | Общий объем использованных ресурсов (в КБ) |
Извлечение IP-адреса
Получить извлечение IP-адреса
GET /ep/ip/v3
Параметры запроса
| имя | Расположение | тип | Необходимый | иллюстрировать |
|---|---|---|---|---|
| app_key | запрос | строка(пароль) | да | Ключ доступа |
| cc | запрос | нить | нет | Страна или регион |
| состояние | запрос | нить | нет | Провинция или штат |
| город | запрос | нить | нет | Город |
| формат | запрос | нить | нет | Получить формат |
| фунт | запрос | нить | нет | Разделитель, допустим только для форматирования текста. |
| число | запрос | число | нет | Количество экстракции |
| жизнь | запрос | число | нет | Цикл поддержания - минуты |
| эп | запрос | нить | нет | Прокси-сеть |
Значение перечисления
| свойство | ценить |
|---|---|
| эп | нас |
| эп | гонконг |
| эп | из |
Вернуться к примеру
Ответ 200
{
"код": 200,
"msg": "string",
"данные": {
"список": [
[
"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 | Запрос выполнен успешно. | В соответствии |
Возвращаемая структура данных
Код состояния 200
| имя | тип | Необходимый | ограничение | Китайское имя | иллюстрировать |
|---|---|---|---|---|---|
| » код | целое число | ЛОЖЬ | никто | Коды состояния: 200 Успех, 3 Недействительный ключ приложения, 156 Учетная запись не подтверждена. | |
| » сообщение | нить | ЛОЖЬ | никто | Сообщения о состоянии | |
| данные | объект | ЛОЖЬ | никто | никто | |
| "" список | [любой] | ЛОЖЬ | никто | никто |
Получить динамический список региональных городов V4
GET /ep/ip/dcl4
Для получения списка городов по имени пользователя требуется авторизация, и учетная запись должна принадлежать текущему пользователю.
Параметры запроса
| имя | Расположение | тип | Необходимый | иллюстрировать |
|---|---|---|---|---|
| имя пользователя | запрос | нить | да | Имя пользователя учетной записи агента |
Вернуться к примеру
Ответ 200
{
"код": 200,
"msg": "string",
"данные": {
"cache": true,
"список": [
{
"Город": "Лос-Анджелес",
"Область": "США",
"Штат": "Калифорния"
}
]
}
}
Возвращает результаты
| коды состояния | Значение кода состояния | иллюстрировать | Модель данных |
|---|---|---|---|
| 200 | OK | Запрос выполнен успешно. | В соответствии |
Возвращаемая структура данных
Код состояния 200
| имя | тип | Необходимый | ограничение | Китайское имя | иллюстрировать |
|---|---|---|---|---|---|
| » код | целое число | ЛОЖЬ | никто | Код состояния 200 Успех | |
| » сообщение | нить | ЛОЖЬ | никто | Сообщения о состоянии | |
| данные | объект | ЛОЖЬ | никто | никто | |
| кэш | логический | ЛОЖЬ | никто | Это из кэша? | |
| "" список | [объект] | ЛОЖЬ | никто | никто | |
| """ Город | нить | ЛОЖЬ | никто | Город | |
| """ Область | нить | ЛОЖЬ | никто | область | |
| """ Состояние | нить | ЛОЖЬ | никто | Штат/Провинция |
Получить динамический список штатов/провинций V4
GET /ep/ip/dsl4
Для получения списка штатов/провинций по имени пользователя требуется авторизация, и учетная запись должна принадлежать текущему пользователю.
Параметры запроса
| имя | Расположение | тип | Необходимый | иллюстрировать |
|---|---|---|---|---|
| имя пользователя | запрос | нить | да | Имя пользователя учетной записи агента |
Вернуться к примеру
Ответ 200
{
"код": 200,
"msg": "string",
"данные": {
"cache": true,
"список": [
{
"Город": "Лос-Анджелес",
"Область": "США",
"Штат": "Калифорния"
}
]
}
}
Возвращает результаты
| коды состояния | Значение кода состояния | иллюстрировать | Модель данных |
|---|---|---|---|
| 200 | OK | Запрос выполнен успешно. | В соответствии |
Возвращаемая структура данных
Код состояния 200
| имя | тип | Необходимый | ограничение | Китайское имя | иллюстрировать |
|---|---|---|---|---|---|
| » код | целое число | ЛОЖЬ | никто | Код состояния 200 Успех | |
| » сообщение | нить | ЛОЖЬ | никто | Сообщения о состоянии | |
| данные | объект | ЛОЖЬ | никто | никто | |
| кэш | логический | ЛОЖЬ | никто | Это из кэша? | |
| "" список | [объект] | ЛОЖЬ | никто | никто | |
| """ Город | нить | ЛОЖЬ | никто | Город | |
| """ Область | нить | ЛОЖЬ | никто | область | |
| """ Состояние | нить | ЛОЖЬ | никто | Штат/Провинция |
Получить динамический список интеграции региональных/провинциальных городов V4
GET /ep/ip/dal4
Получает объединенный список штатов/провинций и городов по имени пользователя, сгруппированный по региону. Требуется аутентификация при входе в систему, и учетная запись должна принадлежать текущему пользователю.
Параметры запроса
| имя | Расположение | тип | Необходимый | иллюстрировать |
|---|---|---|---|---|
| имя пользователя | запрос | нить | да | Имя пользователя учетной записи агента |
Вернуться к примеру
Ответ 200
{
"код": 200,
"msg": "string",
"данные": {
"cache": true,
"список": [
{
"Область": "США",
"штаты": [
{
"State": null,
"города": null
}
]
}
]
}
}
Возвращает результаты
| коды состояния | Значение кода состояния | иллюстрировать | Модель данных |
|---|---|---|---|
| 200 | OK | Запрос выполнен успешно. | В соответствии |
Возвращаемая структура данных
Код состояния 200
| имя | тип | Необходимый | ограничение | Китайское имя | иллюстрировать |
|---|---|---|---|---|---|
| » код | целое число | ЛОЖЬ | никто | Код состояния 200 Успех | |
| » сообщение | нить | ЛОЖЬ | никто | Сообщения о состоянии | |
| данные | объект | ЛОЖЬ | никто | никто | |
| кэш | логический | ЛОЖЬ | никто | Это из кэша? | |
| "" список | [объект] | ЛОЖЬ | никто | Региональный список | |
| """ Область | нить | ЛОЖЬ | никто | Код города | |
| штаты | [объект] | ЛОЖЬ | никто | Список штатов/провинций | |
| """" Состояние | нить | ЛОЖЬ | никто | Название штата/провинции | |
| города | [нить] | ЛОЖЬ | никто | Список городов |
Получить список городов
GET /ep/ip/dynamic-citys
Вернуться к примеру
Ответ 200
{
"код": 200,
"msg": "string",
"данные": {
"список": [
{
"name_zh_cn": "美国",
"name_en": "Соединенные Штаты",
"continent_code": "NA",
"country_code": "US",
"предметы": [
{
"город": null,
"state": null,
"continent_code": null,
"country_code": null
}
]
}
]
}
}
Возвращает результаты
| коды состояния | Значение кода состояния | иллюстрировать | Модель данных |
|---|---|---|---|
| 200 | OK | Запрос выполнен успешно. | В соответствии |
Возвращаемая структура данных
Код состояния 200
| имя | тип | Необходимый | ограничение | Китайское имя | иллюстрировать |
|---|---|---|---|---|---|
| » код | целое число | ЛОЖЬ | никто | Коды состояния: 200 Успех, 3 Недействительный ключ приложения, 156 Учетная запись не подтверждена. | |
| » сообщение | нить | ЛОЖЬ | никто | Сообщения о состоянии | |
| данные | объект | ЛОЖЬ | никто | никто | |
| "" список | [объект] | ЛОЖЬ | никто | Список | |
| »»» name_zh_cn | нить | ЛОЖЬ | никто | Название страны или региона | |
| »»» name_en | нить | ЛОЖЬ | никто | Название страны или региона | |
| »»» continent_code | нить | ЛОЖЬ | никто | Континентальные коды | |
| код страны | нить | ЛОЖЬ | никто | Код страны или региона | |
| """ предметы | [объект] | ЛОЖЬ | никто | Провинция или штат | |
| """" город | нить | ЛОЖЬ | никто | Название города | |
| """" состояние | нить | ЛОЖЬ | никто | код названия провинции или штата | |
| »»»» continent_code | нить | ЛОЖЬ | никто | Континентальные коды | |
| код страны | нить | ЛОЖЬ | никто | Код страны или региона |
Поиск городов
GET /ep/ip/dynamic-citys/search
Параметры запроса
| имя | Расположение | тип | Необходимый | иллюстрировать |
|---|---|---|---|---|
| код страны | запрос | нить | да | Код страны или региона |
| состояние | запрос | нить | да | код штата или провинции |
Вернуться к примеру
Ответ 200
{
"код": 200,
"msg": "string",
"данные": {
"список": [
"нить"
]
}
}
Возвращает результаты
| коды состояния | Значение кода состояния | иллюстрировать | Модель данных |
|---|---|---|---|
| 200 | OK | Запрос выполнен успешно. | В соответствии |
Возвращаемая структура данных
Код состояния 200
| имя | тип | Необходимый | ограничение | Китайское имя | иллюстрировать |
|---|---|---|---|---|---|
| » код | целое число | ЛОЖЬ | никто | Коды состояния: 200 Успех, 3 Недействительный ключ приложения, 156 Учетная запись не подтверждена. | |
| » сообщение | нить | ЛОЖЬ | никто | Сообщения о состоянии | |
| данные | объект | ЛОЖЬ | никто | никто | |
| "" список | [нить] | ЛОЖЬ | никто | Список |
Получить список штатов
GET /ep/ip/dynamic-states
Вернуться к примеру
Ответ 200
{
"код": 200,
"msg": "string",
"данные": {
"список": [
{
"name_zh_cn": "美国",
"name_en": "Соединенные Штаты",
"continent_code": "NA",
"country_code": "US",
"предметы": [
{
"state": null,
"continent_code": null,
"country_code": null
}
]
}
]
}
}
Возвращает результаты
| коды состояния | Значение кода состояния | иллюстрировать | Модель данных |
|---|---|---|---|
| 200 | OK | Запрос выполнен успешно. | В соответствии |
Возвращаемая структура данных
Код состояния 200
| имя | тип | Необходимый | ограничение | Китайское имя | иллюстрировать |
|---|---|---|---|---|---|
| » код | целое число | ЛОЖЬ | никто | Коды состояния: 200 Успех, 3 Недействительный ключ приложения, 156 Учетная запись не подтверждена. | |
| » сообщение | нить | ЛОЖЬ | никто | Сообщения о состоянии | |
| данные | объект | ЛОЖЬ | никто | никто | |
| "" список | [объект] | ЛОЖЬ | никто | Список | |
| »»» name_zh_cn | нить | ЛОЖЬ | никто | Название страны или региона | |
| »»» name_en | нить | ЛОЖЬ | никто | Название страны или региона | |
| »»» continent_code | нить | ЛОЖЬ | никто | Континентальные коды | |
| код страны | нить | ЛОЖЬ | никто | Код страны или региона | |
| """ предметы | [объект] | ЛОЖЬ | никто | Провинция или штат | |
| """" состояние | нить | ЛОЖЬ | никто | код названия провинции или штата | |
| »»»» continent_code | нить | ЛОЖЬ | никто | Континентальные коды | |
| код страны | нить | ЛОЖЬ | никто | Код страны или региона |
Поиск по штату/провинции
GET /ep/ip/dynamic-states/search
Параметры запроса
| имя | Расположение | тип | Необходимый | иллюстрировать |
|---|---|---|---|---|
| код страны | запрос | нить | да | Код страны или региона |
Вернуться к примеру
Ответ 200
{
"код": 200,
"msg": "string",
"данные": {
"список": [
"нить"
]
}
}
Возвращает результаты
| коды состояния | Значение кода состояния | иллюстрировать | Модель данных |
|---|---|---|---|
| 200 | OK | Запрос выполнен успешно. | В соответствии |
Возвращаемая структура данных
Код состояния 200
| имя | тип | Необходимый | ограничение | Китайское имя | иллюстрировать |
|---|---|---|---|---|---|
| » код | целое число | ЛОЖЬ | никто | Коды состояния: 200 Успех, 3 Недействительный ключ приложения, 156 Учетная запись не подтверждена. | |
| » сообщение | нить | ЛОЖЬ | никто | Сообщения о состоянии | |
| данные | объект | ЛОЖЬ | никто | никто | |
| "" список | [нить] | ЛОЖЬ | никто | Список |
GET Получить список приобретенных статических IP-адресов
GET /ep/ip/get-static-ip
Параметры запроса
| имя | Расположение | тип | Необходимый | иллюстрировать |
|---|---|---|---|---|
| код страны | запрос | нить | нет | Код страны или региона |
| тип продукта | запрос | число | нет | Тип продукта: 25: Статические IP-адреса для жилых помещений, 14: IP-адреса для центров обработки данных |
| trade_no | запрос | нить | нет | Фильтрация IP-адресов по номеру заказа |
| страница | запрос | число | нет | номер страницы |
| размер | запрос | число | нет | Количество на странице |
| статус | запрос | число | нет | Статус: 1: Действителен, 2: Недействителен, 3: Срок действия скоро истечет, 4: На техническом обслуживании |
Значение перечисления
| свойство | ценить |
|---|---|
| тип продукта | 14 |
| тип продукта | 25 |
| статус | 1 - 2 - 3 - 4 |
Вернуться к примеру
Ответ 200
{}
Возвращает результаты
| коды состояния | Значение кода состояния | иллюстрировать | Модель данных |
|---|---|---|---|
| 200 | OK | никто | В соответствии |
Возвращаемая структура данных
GET Получить количество статических IP-адресов, доступных для продажи в регионах.
GET /ep/ip/static-ip-region
Параметры запроса
| имя | Расположение | тип | Необходимый | иллюстрировать |
|---|---|---|---|---|
| интернет | запрос | целое число | нет | Фильтрация интернет-провайдера: Фильтрация не выполняется, если данные не передаются (за исключением сайтов 1/4/5, для которых по умолчанию установлено значение 1). |
| асн | запрос | целое число | нет | Следует ли возвращать данные по группам ASN? |
| эксклюзивный | запрос | целое число | нет | Следует ли учитывать товарные запасы как эксклюзивные? |
Подробное описание
isp : Фильтрация интернет-провайдера; если не загружено, фильтрация не работает (за исключением сайтов 1/4/5, для которых по умолчанию используется значение 1).
| ценить | описывать |
|---|---|
| 0 | Статический IP-адрес для центра обработки данных (ЦОД). |
| 1 | Статический IP-адрес для домашнего использования (интернет-провайдер) |
asn : Следует ли возвращать данные о группах ASN.
| ценить | описывать |
|---|---|
| 0 | Не возвращать данные, сгруппированные по ASN (по умолчанию). |
| 1 | Возвращает сгруппированные данные ASN. |
эксклюзивный : Следует ли рассчитывать запасы как эксклюзивные.
| ценить | описывать |
|---|---|
| 0 | Статистические данные основаны на информации о текущем пользователе/общей группе (по умолчанию). |
| 1 | Исключить все назначенные IP-адреса и учитывать только имеющиеся в наличии. |
Значение перечисления
| свойство | ценить |
|---|---|
| интернет | 0 |
| интернет | 1 |
| асн | 0 |
| асн | 1 |
| эксклюзивный | 0 |
| эксклюзивный | 1 |
Вернуться к примеру
Ответ 200
{
"код": 200,
"msg": "Обмен сообщениями",
"данные": {
"список": [
{
"код": "США",
"номер": 55
}
]
}
}
Возвращает результаты
| коды состояния | Значение кода состояния | иллюстрировать | Модель данных |
|---|---|---|---|
| 200 | OK | Запрос выполнен успешно. | В соответствии |
Возвращаемая структура данных
Код состояния 200
| имя | тип | Необходимый | ограничение | Китайское имя | иллюстрировать |
|---|---|---|---|---|---|
| » код | целое число | ЛОЖЬ | никто | Код состояния 200 Успех | |
| » сообщение | нить | ЛОЖЬ | никто | Сообщения о состоянии | |
| данные | объект | ЛОЖЬ | никто | никто | |
| "" список | [объект] | ЛОЖЬ | никто | никто | |
| »»» код | нить | ЛОЖЬ | никто | Код страны или региона | |
| """ число | целое число | ЛОЖЬ | никто | количество |
GET-запросы получают пул хостов. Поддерживаемые страны/регионы.
GET /ep/host-pool/regions
Запросите список стран/регионов, поддерживаемых текущим сайтом службы host_pool.
Этот интерфейс предназначен для сценариев, в которых IP-адреса центров обработки данных выбираются случайным образом на основе точек трафика. Он учитывает только страну/регион доступных IP-адресов центров обработки данных для текущего объекта. Он не поддерживает фильтрацию по ASN, ISP или выделенным IP-адресам, а также не исключает IP-адреса на основе записей о покупках пользователей.
Вернуться к примеру
Ответ 200
{
"код": 200,
"msg": "Обмен сообщениями",
"данные": {
"список": [
{
"код": "США",
"номер": 55,
"name_zh_cn": "美国",
"name_en": "Соединенные Штаты",
"square_flag": "https://example.com/static/flags/us.png"
}
]
}
}
Возвращает результаты
| коды состояния | Значение кода состояния | иллюстрировать | Модель данных |
|---|---|---|---|
| 200 | OK | Запрос выполнен успешно. | В соответствии |
Возвращаемая структура данных
Код состояния 200
| имя | тип | Необходимый | ограничение | Китайское имя | иллюстрировать |
|---|---|---|---|---|---|
| » код | целое число | ЛОЖЬ | никто | Код состояния 200 Успех | |
| » сообщение | нить | ЛОЖЬ | никто | Сообщения о состоянии | |
| данные | объект | ЛОЖЬ | никто | никто | |
| "" список | [объект] | ЛОЖЬ | никто | никто | |
| »»» код | нить | ЛОЖЬ | никто | Код страны или региона, ISO 3166-1 alpha-2 | |
| """ число | целое число | ЛОЖЬ | никто | Количество доступных IP-адресов центра обработки данных на текущей площадке | |
| »»» name_zh_cn | нить | ЛОЖЬ | никто | Китайское название страны или региона | |
| »»» name_en | нить | ЛОЖЬ | никто | Английское название страны или региона | |
| »»» квадратный_флаг | нить | ЛОЖЬ | никто | URL изображения квадратного национального флага |
Управление заказами
Получить список заказов
GET /ep/order/list
Параметры запроса
| имя | Расположение | тип | Необходимый | иллюстрировать |
|---|---|---|---|---|
| страница_нет | запрос | целое число | нет | никто |
| размер страницы | запрос | целое число | нет | никто |
| trade_no | запрос | нить | нет | Номер заказа |
| время начала | запрос | строка(дата-время) | нет | Время начала (включительно), например, 2024-01-01 00:00:00 |
| конец_времени | запрос | строка(дата-время) | нет | Время окончания (исключая) |
| статус | запрос | целое число | нет | Статус заказа |
| тип продукта | запрос | целое число | нет | Тип продукта |
| счет | запрос | целое число | нет | Статус счета: 0 — Без ограничений; 1 — Счет выставлен; -1 — Счет не выставлен (может быть перевыставлен) |
| статус_платежа | запрос | целое число | нет | Фильтрация по сумме: 1. Переплата 2. Недоплата |
Подробное описание
статус : Статус заказа
| состояние | описывать |
|---|---|
| 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 | Видео |
Значение перечисления
| свойство | ценить |
|---|---|
| статус | 0 |
| статус | 1 |
| статус | 2 |
| статус | 3 |
| тип продукта | 3 |
| тип продукта | 9 |
| тип продукта | 11 |
| тип продукта | 12 |
| тип продукта | 14 |
| тип продукта | 16 |
| тип продукта | 17 |
| тип продукта | 18 |
| тип продукта | 19 |
| тип продукта | 21 |
| тип продукта | 24 |
| тип продукта | 25 |
| тип продукта | 26 |
| тип продукта | 27 |
| тип продукта | 28 |
| счет | -1 |
| счет | 0 |
| счет | 1 |
| статус_платежа | 1 |
| статус_платежа | 2 |
Вернуться к примеру
Ответ 200
{
"код": 0,
"message": "操作成功",
"данные": {
"список": [
{
"id": 0,
"trade_no": "string",
"out_trade_no": "string",
"product_id": 0,
"product_type": 0,
"сумма": 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",
"статус": 0,
"title": "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,
"счет": {}
}
],
"пагинация": {
"Итого": 0,
"page_no": 0,
"page_size": 0,
"total_pages": 0
}
}
}
Возвращает результаты
| коды состояния | Значение кода состояния | иллюстрировать | Модель данных |
|---|---|---|---|
| 200 | OK | успех | В соответствии |
Возвращаемая структура данных
POST Создать заказ
POST /ep/order/create
В связи с разнообразием доступных пакетов и различными конфигурациями каждого из них, пожалуйста, заполните параметры в соответствии с вашей реальной ситуацией. Неправильно заполненные параметры могут привести к ошибке при создании заказа.
примеры:
Обновление статического IP-адреса
{
"pid": Идентификатор пакета, // Получено из интерфейса /ep/product
"upids": "1,2,3,4,5,6", // Извлекает соответствующее поле id из интерфейса /ep/ip/get-static-ip.
"pm_id": 1 // Получено из API /ep/payment/list или /ep/payment/groups
}
Приобретение статического IP-адреса для жилого дома
{
"pid": Идентификатор пакета, // Получено из интерфейса /ep/product
"pm_id": Идентификатор способа оплаты, // получен из API /ep/payment/list или /ep/payment/groups.
"region_list": "JP,15,333|DE,10,444|US,5,555" // Формат: Регион, Количество, ASN | Регион, Количество, ASN (номер ASN необязателен)
}
Покупка статического IP-адреса для дата-центра
{
"pid": Идентификатор пакета, // Получено из интерфейса /ep/product
"pm_id": Идентификатор способа оплаты, // получен из API /ep/payment/list или /ep/payment/groups.
"region_list": "JP,15,333|DE,10,444|US,5,555" // Формат: Регион, Количество, ASN | Регион, Количество, ASN (номер ASN необязателен)
}
Динамичные покупки жилого трафика
{
"pid": Идентификатор пакета, // Получено из интерфейса /ep/product
"pm_id": Идентификатор способа оплаты // Получается из API /ep/payment/list или /ep/payment/groups
}
Покупка статического вращающегося транспортного потока
{
"pid": Идентификатор пакета, // Получено из интерфейса /ep/product
"pm_id": Идентификатор способа оплаты // Получается из API /ep/payment/list или /ep/payment/groups
}
Динамическая покупка неограниченного трафика
{
"pid": 套餐ID, // 从 /ep/product 接口获取
"pm_id": 支付方式ID, // 从 /ep/pay/list 或 /ep/pay/groups 接口获取
"product_sku_bandwidth_id": идентификатор канала,
"product_sku_concurrency_id": идентификатор 并发规格
}
Пополнение баланса
{
"pid": Идентификатор пакета, // Получено из интерфейса /ep/product
"pm_id": Идентификатор способа оплаты, // получен из API /ep/payment/list или /ep/payment/groups.
"recharge_amount": Сумма пополнения
}
Параметры запроса тела
{
"pid": 0,
"upids": "string",
"сумма": 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
}
Параметры запроса
| имя | Расположение | тип | Необходимый | иллюстрировать |
|---|---|---|---|---|
| тело | тело | объект | да | никто |
| » pid | тело | целое число | да | Идентификатор пакета берется из поля id, возвращаемого API /ep/product. |
| » upids | тело | нить | нет | Список идентификаторов пакетов продления (разделенных запятыми) из поля`id`, возвращаемого API-функциями `/ep/user-product/list` или `/ep/ip/get-static-ip`. |
| количество | тело | число | нет | Количество новых посылок |
| pm_id | тело | целое число | да | Идентификатор способа оплаты берется из поля`id`, возвращаемого API-интерфейсами `/ep/payment/list` или `/ep/payment/groups`. |
| » region_list | тело | нить | нет | При покупке статических IP-адресов укажите регион, количество и номер автономной системы (ASN). Формат: Регион, Количество, ASN. |
| » coupon_sn | тело | нить | нет | Номер купона |
| » use_invitation_registration_discount | тело | логический | нет | Воспользуйтесь скидкой за регистрацию по приглашению. |
| » renew_duration | тело | целое число | нет | Срок продления — статический IP-адрес по желанию |
| » product_sku_bandwidth_id | тело | целое число | нет | Пакет 11: Идентификатор пакета пропускной способности |
| » product_sku_concurrency_id | тело | целое число | нет | Пакет 11: Идентификатор одновременного пакета |
| » product_sku_duration_id | тело | целое число | нет | Тип пакета=11 Обязательно: Идентификатор спецификации продолжительности |
| » etd | тело | целое число | нет | Множитель продолжительности получается из пакета extension_of_time_days; 2 представляет собой количество дней, умноженное на 2, что приводит к увеличению цены. |
| » сумма_пополнения | тело | целое число | нет | Пакет 3: Сумма пополнения |
Вернуться к примеру
Ответ 200
{
"код": 0,
"message": "操作成功",
"данные": {
"id": 0,
"trade_no": "string",
"out_trade_no": "string",
"product_id": 0,
"product_type": 0,
"сумма": 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",
"статус": 0,
"title": "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,
"счет": {
"имя": "строка",
"org_name": "string",
"first_name": "string",
"last_name": "string",
"телефон": "строка",
"email": "user@example.com",
"role_type": 0,
"vat_id": "string",
"address_country": "string",
"address_city": "string",
"address_line1": "string",
"address_line2": "string",
"address_postal_code": "string"
}
}
}
Возвращает результаты
| коды состояния | Значение кода состояния | иллюстрировать | Модель данных |
|---|---|---|---|
| 200 | OK | Создание успешно | В соответствии |
Возвращаемая структура данных
Отменить заказ
POST /ep/order/close
Параметры запроса тела
{
"trade_no": "string"
}
Параметры запроса
| имя | Расположение | тип | Необходимый | иллюстрировать |
|---|---|---|---|---|
| тело | тело | объект | да | никто |
| » trade_no | тело | нить | да | никто |
Возвращает результаты
| коды состояния | Значение кода состояния | иллюстрировать | Модель данных |
|---|---|---|---|
| 200 | OK | Операция прошла успешно. | Никто |
Предварительная проверка заказа POST
POST /ep/order/check
Эта функция, вызываемая перед созданием заказа, предварительно просматривает цены, скидки, сведения о продлении IP-адреса и т. д., но фактически не создает заказ. Параметры идентичны параметрам в /ep/order/create .
Параметры запроса тела
{
"pid": 0,
"upids": "string",
"сумма": 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
}
Параметры запроса
| имя | Расположение | тип | Необходимый | иллюстрировать |
|---|---|---|---|---|
| тело | тело | объект | да | никто |
| » pid | тело | целое число | да | Идентификатор пакета |
| » upids | тело | нить | нет | Обновление IP-адреса: Список идентификаторов пользовательских пакетов, разделенных запятыми. |
| количество | тело | целое число | нет | Количество закупаемых товаров |
| pm_id | тело | целое число | да | Идентификатор способа оплаты |
| » region_list | тело | нить | нет | Покупка статического IP-адреса: регион + количество, формат: идентификатор региона, количество |
| » coupon_sn | тело | нить | нет | Номер купона |
| » renew_duration | тело | нить | нет | Срок действия IP-адреса: 1m = 1 месяц, 2m = 2 месяца, em = конец следующего месяца. |
| » product_sku_bandwidth_id | тело | целое число | нет | Тип пакета = 11. Требуется: идентификатор спецификации полосы пропускания. |
| » product_sku_concurrency_id | тело | целое число | нет | Тип пакета = 11. Требуется: идентификатор спецификации параллельного выполнения. |
| » product_sku_duration_id | тело | целое число | нет | Тип пакета=11 Обязательно: Идентификатор спецификации продолжительности |
| » etd | тело | целое число | нет | Множитель продолжительности получается из пакета extension_of_time_days. |
| » сумма_пополнения | тело | число | нет | Тип пакета = 3 (обязательно): Сумма пополнения |
Значение перечисления
| свойство | ценить |
|---|---|
| » renew_duration | 1m |
| » renew_duration | 2m |
| » renew_duration | Эм |
Вернуться к примеру
Ответ 200
{
"код": 0,
"message": "操作成功",
"данные": {
"product_id": 0,
"сумма": 0,
"discount_fee": 0.1,
"total_fee": 0.1,
"pay_fee": 0.1,
"product_type": 0,
"title": "string",
"деталь": "струна",
"ip_result": [
{
"ip": "string",
"цена": 0.1,
"country_code": "string",
"текущее_время": "2019-08-24T14:15:22Z",
"renewal_time": "2019-08-24T14:15:22Z",
"страна": {}
}
]
}
}
Возвращает результаты
| коды состояния | Значение кода состояния | иллюстрировать | Модель данных |
|---|---|---|---|
| 200 | OK | Предварительная проверка прошла успешно. | В соответствии |
Возвращаемая структура данных
Управление платежами
Используйте команду GET для получения списка способов оплаты.
GET /ep/payment/list
Параметры запроса
| имя | Расположение | тип | Необходимый | иллюстрировать |
|---|---|---|---|---|
| trade_no | запрос | нить | нет | Номер заказа — этот номер можно ввести, если для некоторых заказов требуется определенный способ оплаты. |
| валюта | запрос | нить | нет | Валюта |
Вернуться к примеру
Ответ 200
{
"код": 0,
"message": "操作成功",
"данные": {
"список": [
{
"id": 0,
"title": "string",
"логотип": "строка",
"группа": "строка",
"handling_rate": 0,
"handling_fee": 0,
"disabled": false,
"мин": 0,
"макс": 0
}
]
}
}
Возвращает результаты
| коды состояния | Значение кода состояния | иллюстрировать | Модель данных |
|---|---|---|---|
| 200 | OK | Успешно получено | В соответствии |
Возвращаемая структура данных
Используйте команду GET для получения списка способов оплаты.
GET /ep/payment/groups
Параметры запроса
| имя | Расположение | тип | Необходимый | иллюстрировать |
|---|---|---|---|---|
| trade_no | запрос | нить | нет | Номер заказа — этот номер можно ввести, если для некоторых заказов требуется определенный способ оплаты. |
Вернуться к примеру
Ответ 200
{
"код": 0,
"message": "操作成功",
"данные": {
"список": [
{
"имя": "строка",
"логотипы": [
нулевой
],
"предметы": [
нулевой
]
}
]
}
}
Возвращает результаты
| коды состояния | Значение кода состояния | иллюстрировать | Модель данных |
|---|---|---|---|
| 200 | OK | Успешно получено | В соответствии |
Возвращаемая структура данных
маркетинг
Получите коэффициент бонуса за пополнение счета
GET /ep/activity/balance-recharge-gift-ratio
Коэффициент бонуса за пополнение счета
Вернуться к примеру
Ответ 200
{
"код": 0,
"message": "操作成功",
"данные": {
"список": [
нулевой
]
}
}
Возвращает результаты
| коды состояния | Значение кода состояния | иллюстрировать | Модель данных |
|---|---|---|---|
| 200 | OK | OK | В соответствии |
Возвращаемая структура данных
продукт
Получить список товаров
GET /ep/product
Получите список доступных пакетов на текущем сайте и отфильтруйте его по типу, сроку действия и другим критериям.
Параметры запроса
| имя | Расположение | тип | Необходимый | иллюстрировать |
|---|---|---|---|---|
| тип | запрос | целое число | нет | Типы пакетов см. в описании перечисления Product.type. Если тип не указан, будут возвращены все типы. |
| родительский продукт_тип | запрос | целое число | нет | Тип родительского пакета, действителен только для типа=19 (продление IP-адреса), используется для фильтрации продуктовых линеек: 14=Центр обработки данных, 25=Жилой сектор. |
| время_дней | запрос | там | нет | Фильтрация по сроку действия в днях, поддерживающая как отдельные значения, так и массивы, например, 30 /[30,90,365] |
| show_type | запрос | там | нет | Фильтрация по типу отображения, поддерживает одно значение или массив. |
Подробное описание
type : Тип пакета, см. описание перечисления Product.type. Если не указано, будут возвращены все типы.
Значение перечисления
| свойство | ценить |
|---|---|
| родительский продукт_тип | 14 |
| родительский продукт_тип | 25 |
Вернуться к примеру
Ответ 200
{
"code": 0,
"message": "操作成功",
"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": [
null
]
},
"sku": {
"bandwidth_list": [
null
],
"duration_list": [
null
],
"concurrency_list": [
null
]
}
}
]
}
Возвращает результаты
| коды состояния | Значение кода состояния | иллюстрировать | Модель данных |
|---|---|---|---|
| 200 | OK | OK | В соответствии |
Возвращаемая структура данных
Модель данных
Типы продуктов
9
Типы пакетов: 9 динамических пакетов для домашнего трафика, 11 динамических пакетов IP-адресов для домашнего трафика, 14 статических пакетов IP-адресов для центров обработки данных, 25 статических пакетов IP-адресов для домашнего трафика.
свойство
| имя | тип | Необходимый | ограничение | Китайское имя | иллюстрировать |
|---|---|---|---|---|---|
| анонимный | целое число | ЛОЖЬ | никто | Типы пакетов: 9 динамических пакетов для домашнего трафика, 11 динамических пакетов IP-адресов для домашнего трафика, 14 статических пакетов IP-адресов для центров обработки данных, 25 статических пакетов IP-адресов для домашнего трафика. |
Значение перечисления
| свойство | ценить |
|---|---|
| анонимный | 9 |
| анонимный | 11 |
| анонимный | 14 |
| анонимный | 25 |
responseCode
200
Коды состояния: 200 — Успех, 3 — Недействительный app_key
свойство
| имя | тип | Необходимый | ограничение | Китайское имя | иллюстрировать |
|---|---|---|---|---|---|
| анонимный | целое число | ЛОЖЬ | никто | Коды состояния: 200 — Успех, 3 — Недействительный app_key |
УспехОтвет
{
"код": 0,
"message": "操作成功",
"данные": {}
}
свойство
| имя | тип | Необходимый | ограничение | Китайское имя | иллюстрировать |
|---|---|---|---|---|---|
| код | целое число | ЛОЖЬ | никто | никто | |
| сообщение | нить | ЛОЖЬ | никто | никто | |
| данные | объект | ЛОЖЬ | никто | никто |
Заказ
{
"id": 0,
"trade_no": "string",
"out_trade_no": "string",
"product_id": 0,
"product_type": 0,
"сумма": 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",
"статус": 0,
"title": "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,
"счет": {
"имя": "строка",
"org_name": "string",
"first_name": "string",
"last_name": "string",
"телефон": "строка",
"email": "user@example.com",
"role_type": 0,
"vat_id": "string",
"address_country": "string",
"address_city": "string",
"address_line1": "string",
"address_line2": "string",
"address_postal_code": "string"
}
}
свойство
| имя | тип | Необходимый | ограничение | Китайское имя | иллюстрировать |
|---|---|---|---|---|---|
| идентификатор | целое число | ЛОЖЬ | никто | Идентификатор заказа | |
| trade_no | нить | ЛОЖЬ | никто | Внутренний номер заказа | |
| out_trade_no | нить | ЛОЖЬ | никто | Внешний номер заказа | |
| продукт_id | целое число | ЛОЖЬ | никто | Идентификатор пакета | |
| тип продукта | целое число | ЛОЖЬ | никто | Типы упаковки перечислены в нумерации типов продукции. | |
| количество | целое число | ЛОЖЬ | никто | Количество закупаемых товаров | |
| цена за единицу товара | число (с плавающей запятой) | ЛОЖЬ | никто | цена за единицу товара | |
| общая_плата | число (с плавающей запятой) | ЛОЖЬ | никто | Общая стоимость заказа (без учета скидок, включая плату за обработку) | |
| goods_fee | число (с плавающей запятой) | ЛОЖЬ | никто | Цена товара (с учетом скидок, за исключением платы за обработку заказа) | |
| плата_ | число (с плавающей запятой) | ЛОЖЬ | никто | Фактическая сумма платежа (включая скидки и комиссию за обработку) | |
| скидка_плата | число (с плавающей запятой) | ЛОЖЬ | никто | Сумма скидки | |
| комиссия за обработку | число (с плавающей запятой) | ЛОЖЬ | никто | плата за обработку | |
| возврат_платы | число (с плавающей запятой) | ЛОЖЬ | никто | Сумма возврата | |
| pm_id | целое число | ЛОЖЬ | никто | Идентификатор 支付方式(来自 /ep/pay/list) | |
| pm_title | нить | ЛОЖЬ | никто | Название способа оплаты | |
| pm_logo | нить | ЛОЖЬ | никто | URL-адрес логотипа способа оплаты | |
| статус | целое число | ЛОЖЬ | никто | Статус заказа | |
| заголовок | нить | ЛОЖЬ | никто | Название пакета | |
| деталь | нить | ЛОЖЬ | никто | Описание упаковки | |
| region_desc | нить | ЛОЖЬ | никто | Региональные характеристики | |
| pay_at | строка(дата-время) | ЛОЖЬ | никто | Время оплаты | |
| pay_timestamp | целое число | ЛОЖЬ | никто | отметка времени платежа | |
| создано_в | строка(дата-время) | ЛОЖЬ | никто | Время создания | |
| статус_платежа | целое число | ЛОЖЬ | никто | Статус длинной/короткой позиции: 0 обычных, 1 длинная позиция (переплата), 2 короткие позиции | |
| счет | объект | ЛОЖЬ | никто | Информация для выставления счета (пригодна только для заказов с онлайн-оплатой) | |
| " имя | нить | ЛОЖЬ | никто | Полное имя | |
| » org_name | нить | ЛОЖЬ | никто | Название компании | |
| " имя | нить | ЛОЖЬ | никто | никто | |
| " фамилия | нить | ЛОЖЬ | никто | никто | |
| " телефон | нить | ЛОЖЬ | никто | никто | |
| " электронная почта | строка(email) | ЛОЖЬ | никто | никто | |
| » role_type | целое число | ЛОЖЬ | никто | 1 человек, 2 компании | |
| » vat_id | нить | ЛОЖЬ | никто | Идентификационный номер налогоплательщика | |
| » address_country | нить | ЛОЖЬ | никто | никто | |
| » адрес_город | нить | ЛОЖЬ | никто | никто | |
| " Адресная строка 1 | нить | ЛОЖЬ | никто | никто | |
| » address_line2 | нить | ЛОЖЬ | никто | никто | |
| » адрес_почтовый_код | нить | ЛОЖЬ | никто | никто |
OrderCheckResult
{
"product_id": 0,
"сумма": 0,
"discount_fee": 0.1,
"total_fee": 0.1,
"pay_fee": 0.1,
"product_type": 0,
"title": "string",
"деталь": "струна",
"ip_result": [
{
"ip": "string",
"цена": 0.1,
"country_code": "string",
"текущее_время": "2019-08-24T14:15:22Z",
"renewal_time": "2019-08-24T14:15:22Z",
"страна": {
"name_zh_cn": "string",
"флаг": "строка",
"square_flag": "string"
}
}
]
}
Заказать результаты предварительной проверки
свойство
| имя | тип | Необходимый | ограничение | Китайское имя | иллюстрировать |
|---|---|---|---|---|---|
| продукт_id | целое число | ЛОЖЬ | никто | Идентификатор пакета | |
| количество | целое число | ЛОЖЬ | никто | количество | |
| скидка_плата | число (с плавающей запятой) | ЛОЖЬ | никто | Сумма скидки | |
| общая_плата | число (с плавающей запятой) | ЛОЖЬ | никто | Общая сумма заказа | |
| плата_ | число (с плавающей запятой) | ЛОЖЬ | никто | Фактическая сумма платежа | |
| тип продукта | целое число | ЛОЖЬ | никто | Типы упаковки | |
| заголовок | нить | ЛОЖЬ | никто | Название пакета | |
| деталь | нить | ЛОЖЬ | никто | Описание упаковки | |
| ip_result | [объект] | ЛОЖЬ | никто | Результаты массового продления IP-адресов (отображаются только при продлении IP-адресов) | |
| » ip | нить | ЛОЖЬ | никто | никто | |
| " цена | число (с плавающей запятой) | ЛОЖЬ | никто | никто | |
| » country_code | нить | ЛОЖЬ | никто | никто | |
| » текущее_время | строка(дата-время) | ЛОЖЬ | никто | никто | |
| » время_возобновления | строка(дата-время) | ЛОЖЬ | никто | никто | |
| " страна | объект | ЛОЖЬ | никто | никто | |
| »» name_zh_cn | нить | ЛОЖЬ | никто | никто | |
| »» флаги | нить | ЛОЖЬ | никто | URL циклического флага | |
| »» квадратный_флаг | нить | ЛОЖЬ | никто | URL квадратного флага |
Продукт
{
"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
}
]
}
}
свойство
| имя | тип | Необходимый | ограничение | Китайское имя | иллюстрировать |
|---|---|---|---|---|---|
| идентификатор | целое число | ЛОЖЬ | никто | Идентификатор пакета | |
| заголовок | нить | ЛОЖЬ | никто | основной заголовок пакета | |
| тип | целое число | ЛОЖЬ | никто | Типы упаковки | |
| show_type | целое число | ЛОЖЬ | никто | Типы отображения: 1. Обычный; 2. Рекомендация высокой ценности; 3. Недоступен для покупки (требуется персонализация); 4. Пробный. | |
| статус | целое число | ЛОЖЬ | никто | Статус: 1 объект в списке, 0 исключено из списка | |
| цена | число (с плавающей запятой) | ЛОЖЬ | никто | цена в юанях | |
| цена в долларах США | число (с плавающей запятой) | ЛОЖЬ | никто | Цена в долларах США | |
| цена_хкд | число (с плавающей запятой) | ЛОЖЬ | никто | цена в гонконгских долларах | |
| оригинальная_цена | число (с плавающей запятой) | ЛОЖЬ | никто | Первоначальная цена (юани) | |
| оригинальная_цена_в_долларах США | число (с плавающей запятой) | ЛОЖЬ | никто | Первоначальная цена (доллары США) | |
| оригинальная_цена_хкд | число (с плавающей запятой) | ЛОЖЬ | никто | Первоначальная цена (гонконгские доллары) | |
| локальная_цена | число (с плавающей запятой) | ЛОЖЬ | никто | Локализованное ценообразование (зависит от предпочтительной валюты) | |
| локальная_оригинальная_цена | число (с плавающей запятой) | ЛОЖЬ | никто | Локализованная первоначальная цена (зависит от предпочтительной валюты) | |
| предпочтительная_валюта | нить | ЛОЖЬ | никто | Рекомендуемая валюта для отображения, например, USD/CNY/HKD | |
| поддержка_валют | нить | ЛОЖЬ | никто | Поддерживаемые валюты, разделенные запятыми, например, USD, CNY. | |
| flow_value | число (с плавающей запятой) | ЛОЖЬ | никто | Стандартный объем данных (ГБ) для этого тарифного плана | |
| flow_give | число (с плавающей запятой) | ЛОЖЬ | никто | Бесплатный объем данных (ГБ) | |
| balance_give | число (с плавающей запятой) | ЛОЖЬ | никто | Бонусная сумма за пополнение баланса | |
| баланс_значение | число (с плавающей запятой) | ЛОЖЬ | никто | Сумма пополнения | |
| time_validity | число (с плавающей запятой) | ЛОЖЬ | никто | Стандартный срок действия пакетных предложений | |
| цена времени | число (с плавающей запятой) | ЛОЖЬ | никто | Цена за IP-адрес в пакетных предложениях | |
| время_дней | целое число | ЛОЖЬ | никто | Срок действия в днях, например, 30/90/180/365 | |
| tip1 | нить | ЛОЖЬ | никто | Описание тега 1 | |
| tip2 | нить | ЛОЖЬ | никто | Описание тега 2 | |
| входить | [нить] | ЛОЖЬ | никто | Список текстовых описаний | |
| region_list_id | целое число | ЛОЖЬ | никто | Идентификатор региона | |
| renew_product_list | нить | ЛОЖЬ | никто | Список идентификаторов возобновляемых пакетов (разделенных запятыми) | |
| родительский продукт_тип | целое число | ЛОЖЬ | никто | Тип родительского пакета (действителен при type=19): 14 или 25 | |
| общее_количество | целое число | ЛОЖЬ | никто | Общий запас, 0 означает отсутствие ограничений. | |
| оставшееся_количество | целое число | ЛОЖЬ | никто | Остаток запасов | |
| продление_временных_дней | [целое число] | ЛОЖЬ | никто | Список множителей длительности пуст или содержит только 1, что указывает на то, что он не поддерживается. | |
| time_days_price_rate | число (с плавающей запятой) | ЛОЖЬ | никто | Фактор ценообразования, зависящий от продолжительности, цена × (1 + (кратное - 1) × ставка) | |
| Я собираюсь. | объект | ЛОЖЬ | никто | Информация об описании упаковки | |
| субтитры | нить | ЛОЖЬ | никто | субтитры | |
| » flow_value | число (с плавающей запятой) | ЛОЖЬ | никто | никто | |
| » flow_give | число (с плавающей запятой) | ЛОЖЬ | никто | никто | |
| » balance_give | число (с плавающей запятой) | ЛОЖЬ | никто | никто | |
| » time_validity | число (с плавающей запятой) | ЛОЖЬ | никто | никто | |
| » time_price | число (с плавающей запятой) | ЛОЖЬ | никто | никто | |
| » тип1 | нить | ЛОЖЬ | никто | никто | |
| » tip2 | нить | ЛОЖЬ | никто | никто | |
| " представлять | [нить] | ЛОЖЬ | никто | никто | |
| артикул | объект | ЛОЖЬ | никто | Параметры спецификации (возвращаются при type=11) | |
| » bandwidth_list | [объект] | ЛОЖЬ | никто | Список технических характеристик полосы пропускания | |
| "" идентификатор | целое число | ЛОЖЬ | никто | никто | |
| "" ценить | целое число | ЛОЖЬ | никто | Значение пропускной способности (Мбит/с) | |
| "" цена | число (с плавающей запятой) | ЛОЖЬ | никто | никто | |
| цена_долларов США | число (с плавающей запятой) | ЛОЖЬ | никто | никто | |
| цена_хкд | число (с плавающей запятой) | ЛОЖЬ | никто | никто | |
| » duration_list | [объект] | ЛОЖЬ | никто | Список технических характеристик продолжительности | |
| "" идентификатор | целое число | ЛОЖЬ | никто | никто | |
| "" ценить | целое число | ЛОЖЬ | никто | Продолжительность (дни) | |
| "" цена | число (с плавающей запятой) | ЛОЖЬ | никто | никто | |
| цена_долларов США | число (с плавающей запятой) | ЛОЖЬ | никто | никто | |
| цена_хкд | число (с плавающей запятой) | ЛОЖЬ | никто | никто | |
| » concurrency_list | [объект] | ЛОЖЬ | никто | Список спецификаций параллельного выполнения | |
| "" идентификатор | целое число | ЛОЖЬ | никто | никто | |
| "" ценить | целое число | ЛОЖЬ | никто | Параллелизм | |
| "" цена | число (с плавающей запятой) | ЛОЖЬ | никто | никто | |
| цена_долларов США | число (с плавающей запятой) | ЛОЖЬ | никто | никто | |
| цена_хкд | число (с плавающей запятой) | ЛОЖЬ | никто | никто |
Пагинация
{
"Итого": 0,
"page_no": 0,
"page_size": 0,
"total_pages": 0
}
свойство
| имя | тип | Необходимый | ограничение | Китайское имя | иллюстрировать |
|---|---|---|---|---|---|
| общий | целое число | ЛОЖЬ | никто | никто | |
| страница_нет | целое число | ЛОЖЬ | никто | никто | |
| размер страницы | целое число | ЛОЖЬ | никто | никто | |
| total_pages | целое число | ЛОЖЬ | никто | никто |