Витрина

Изменить название и наценку

Меняет только переданные поля: brand_name — название, которое видят ваши клиенты в документах и в VPN-приложении (по умолчанию VARGO); markup_percent — наценка к цене платформы, после неё GET /plans сразу отдаёт новые цены, а уже выставленные счета не меняются; support_link — поддержка в VPN-приложении клиента: пустая строка её убирает, null ничего не меняет. Значения свои у API: название и цены ваших Telegram-ботов на платформе они не меняют. Пустое тело, пустое название, наценка вне 0–1000 или ссылка не на https — 422 VALIDATION_ERROR.

PATCH

api

partner

account

Изменить название, наценку и поддержку

curl --request PATCH \
  --url https://api.vargopartners.com/api/partner/v1/account \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "brand_name": "North VPN",
  "markup_percent": "50.00",
  "support_link": "https://t.me/north_help"
}
'

import requests

url = "https://api.vargopartners.com/api/partner/v1/account"

payload = {
    "brand_name": "North VPN",
    "markup_percent": "50.00",
    "support_link": "https://t.me/north_help"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    brand_name: 'North VPN',
    markup_percent: '50.00',
    support_link: 'https://t.me/north_help'
  })
};

fetch('https://api.vargopartners.com/api/partner/v1/account', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "brand_name": "<string>",
  "markup_percent": "50.00",
  "support_link": "https://t.me/north_help",
  "trial_enabled": true,
  "currency": "RUB"
}

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "<string>",
    "fields": {}
  }
}

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "<string>",
    "fields": {}
  }
}

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "<string>",
    "fields": {}
  }
}

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "<string>",
    "fields": {}
  }
}

Authorizations

Authorization

string

header

required

Ключ партнёра vgo_live_…: выпускается в кабинете партнёра, раздел «API». Хранится только на сервере партнёра.

Body

application/json

Тело PATCH /account: меняются только переданные поля, хотя бы одно обязательно.

Неизвестные поля отклоняются — 422 VALIDATION_ERROR.

brand_name

string | null

Название сервиса: 1–64 символов, пробелы по краям срезаются

Required string length: 1 - 64

Example:

"North VPN"

markup_percent

Наценка к цене платформы, %: от 0 до 1000, до двух знаков после точки. Цена для клиента округляется до целого рубля и не бывает ниже цены платформы; уже выставленные счета не меняются. Своя у API: цены ваших Telegram-ботов на платформе не меняет

Required range: 0 <= x <= 1000

Example:

"50.00"

support_link

string | null

Ссылка поддержки: https, до 255 символов, пробелы по краям срезаются. Пустая строка убирает поддержку; null ничего не меняет

Maximum string length: 255

Example:

"https://t.me/north_help"

Response

Аккаунт после изменения

brand_name

string

required

Название вашего сервиса — его видят клиенты в документах и в VPN-приложении. По умолчанию VARGO, меняется запросом PATCH /account

markup_percent

string

required

Наценка к цене платформы, %; меняется запросом PATCH /account

Example:

"50.00"

support_link

string | null

required

Поддержка в VPN-приложении ваших клиентов; null — кнопки поддержки нет. Меняется запросом PATCH /account

Example:

"https://t.me/north_help"

trial_enabled

boolean

required

Пробный период через API включён

currency

string

required

Валюта цен и сумм

Example:

"RUB"

Изменить название, наценку и поддержку

curl --request PATCH \
  --url https://api.vargopartners.com/api/partner/v1/account \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "brand_name": "North VPN",
  "markup_percent": "50.00",
  "support_link": "https://t.me/north_help"
}
'

import requests

url = "https://api.vargopartners.com/api/partner/v1/account"

payload = {
    "brand_name": "North VPN",
    "markup_percent": "50.00",
    "support_link": "https://t.me/north_help"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    brand_name: 'North VPN',
    markup_percent: '50.00',
    support_link: 'https://t.me/north_help'
  })
};

fetch('https://api.vargopartners.com/api/partner/v1/account', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "brand_name": "<string>",
  "markup_percent": "50.00",
  "support_link": "https://t.me/north_help",
  "trial_enabled": true,
  "currency": "RUB"
}

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "<string>",
    "fields": {}
  }
}

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "<string>",
    "fields": {}
  }
}

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "<string>",
    "fields": {}
  }
}

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "<string>",
    "fields": {}
  }
}

Витрина

Оплата

Клиенты

Устройства и ссылка

Изменить название и наценку

Authorizations

Body

Response