Метки товаров

Методы для создания/получения/добавления/удаления тегов товарамподдерживается пагинация и сортировка

Базовый URL: https://api.selsup.ru

🔗 Обновление тэга товара

Изменяет имя существующего тэга по его идентификатору.

PUT /api/tag/{tagId}

Параметры пути PATH

Название	Тип	Обязательный	Описание
tagId	integer	Да	Параметр tagId

Тело запроса *Обязательно

Content-Type: application/json

Поле	Тип	Описание
name Обязательный	string	Название метки

Тело ответа

✓ 200 OK ▶

Content-Type: application/json

Поле	Тип	Описание
id	integer	Идентификатор метки
name	string	Название метки
clientId	integer	Идентификатор клиента

⚠ 400 Ошибка с данными запроса ▶

Content-Type: application/json

Поле	Тип	Описание
error Обязательный	string	Код ошибки
localMessage Обязательный	string	Текст ошибки на языке пользователя
params	object	Дополнительные параметры ошибки

⚠ 403 Доступ запрещен ▶

Content-Type: application/json

Поле	Тип	Описание
error Обязательный	string	Код ошибки

✗ 500 Внутренняя ошибка сервера ▶

Content-Type: application/json

Поле	Тип	Описание
error Обязательный	string	Код ошибки
message	string	Описание ошибки
system	string	Системная ошибки парсинга данных запроса

Укажите ключ API в правом верхнем углу, чтобы попробовать использовать метод

Примеры кода

const axios = require('axios');

const response = await axios.put('https://api.selsup.ru/api/tag/${tagId}',
  {
    "id": "Иванович",
    "name": "Иван",
    "clientId": 123
  },
  {
    headers: {
      'Authorization': 'YOUR_API_KEY',
      'Content-Type': 'application/json'
    }
  }
);

console.log(response.data);

import axios from 'axios';

const response = await axios.put<any>('https://api.selsup.ru/api/tag/${tagId}',
  {
    "id": "Иванович",
    "name": "Иван",
    "clientId": 123
  },
  {
    headers: {
      'Authorization': 'YOUR_API_KEY',
      'Content-Type': 'application/json'
    }
  }
);

console.log(response.data);

import requests

headers = {
    'Authorization': 'YOUR_API_KEY',
    'Content-Type': 'application/json'
}

response = requests.put(
    'https://api.selsup.ru/api/tag/${tagId}',
    headers=headers,
    json={
    'id': 'Иванович',
    'name': 'Иван',
    'clientId': 123
}
)

print(response.json())

package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "net/http"
)

func main() {
    client := &http.Client{}

    payload := map[string]interface{}{
        `id`: `Иванович`,
        `name`: `Иван`,
        `clientId`: 123
}
    jsonData, _ := json.Marshal(payload)

    req, _ := http.NewRequest("put", "https://api.selsup.ru/api/tag/${tagId}", bytes.NewBuffer(jsonData))
    req.Header.Set("Authorization", "YOUR_API_KEY")
    req.Header.Set("Content-Type", "application/json")

    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    var result map[string]interface{}
    json.NewDecoder(resp.Body).Decode(&result)
    fmt.Println(result)
}

import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

HttpClient client = HttpClient.newHttpClient();

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.selsup.ru/api/tag/${tagId}"))
    .header("Authorization", "YOUR_API_KEY")
    .header("Content-Type", "application/json")
    .put(HttpRequest.BodyPublishers.ofString(
        "{\"id\":\"Иванович\",\"name\":\"Иван\",\"clientId\":123}"
    ))
    .build();

HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

<?php
$curl = curl_init();

curl_setopt_array($curl, [
    CURLOPT_URL => 'https://api.selsup.ru/api/tag/${tagId}',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'put',
    CURLOPT_POSTFIELDS => json_encode({
    'id': 'Иванович',
    'name': 'Иван',
    'clientId': 123
}),
    CURLOPT_HTTPHEADER => [
        'Authorization: YOUR_API_KEY',
        'Content-Type: application/json'
    ]
]);

$response = curl_exec($curl);
curl_close($curl);

echo $response;
?>

curl -X put \
  'https://api.selsup.ru/api/tag/{tagId}' \
  -H 'Authorization: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "id": "Иванович",
  "name": "Иван",
  "clientId": 123
}'

🔗 Удаление тэга товара

Удаляет тэг по идентификатору. Тэг отвязывается от всех товаров.

DELETE /api/tag/{tagId}

Параметры пути PATH

Название	Тип	Обязательный	Описание
tagId	integer	Да	Параметр tagId

Тело ответа

✓ 200 OK ▶

⚠ 400 Ошибка с данными запроса ▶

Content-Type: application/json

Поле	Тип	Описание
error Обязательный	string	Код ошибки
localMessage Обязательный	string	Текст ошибки на языке пользователя
params	object	Дополнительные параметры ошибки

⚠ 403 Доступ запрещен ▶

Content-Type: application/json

Поле	Тип	Описание
error Обязательный	string	Код ошибки

✗ 500 Внутренняя ошибка сервера ▶

Content-Type: application/json

Поле	Тип	Описание
error Обязательный	string	Код ошибки
message	string	Описание ошибки
system	string	Системная ошибки парсинга данных запроса

Укажите ключ API в правом верхнем углу, чтобы попробовать использовать метод

Примеры кода

const axios = require('axios');

const response = await axios.delete('https://api.selsup.ru/api/tag/${tagId}',
  {
    headers: {
      'Authorization': 'YOUR_API_KEY',
      'Content-Type': 'application/json'
    }
  }
);

console.log(response.data);

import axios from 'axios';

const response = await axios.delete<any>('https://api.selsup.ru/api/tag/${tagId}',
  {
    headers: {
      'Authorization': 'YOUR_API_KEY',
      'Content-Type': 'application/json'
    }
  }
);

console.log(response.data);

import requests

headers = {
    'Authorization': 'YOUR_API_KEY',
    'Content-Type': 'application/json'
}

response = requests.delete(
    'https://api.selsup.ru/api/tag/${tagId}',
    headers=headers
)

print(response.json())

package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "net/http"
)

func main() {
    client := &http.Client{}

    req, _ := http.NewRequest("delete", "https://api.selsup.ru/api/tag/${tagId}", nil)
    req.Header.Set("Authorization", "YOUR_API_KEY")
    req.Header.Set("Content-Type", "application/json")

    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    var result map[string]interface{}
    json.NewDecoder(resp.Body).Decode(&result)
    fmt.Println(result)
}

import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

HttpClient client = HttpClient.newHttpClient();

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.selsup.ru/api/tag/${tagId}"))
    .header("Authorization", "YOUR_API_KEY")
    .header("Content-Type", "application/json")
    .delete(HttpRequest.BodyPublishers.noBody())
    .build();

HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

<?php
$curl = curl_init();

curl_setopt_array($curl, [
    CURLOPT_URL => 'https://api.selsup.ru/api/tag/${tagId}',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'delete',
    CURLOPT_HTTPHEADER => [
        'Authorization: YOUR_API_KEY',
        'Content-Type: application/json'
    ]
]);

$response = curl_exec($curl);
curl_close($curl);

echo $response;
?>

curl -X delete \
  'https://api.selsup.ru/api/tag/{tagId}' \
  -H 'Authorization: YOUR_API_KEY' \
  -H 'Content-Type: application/json'

🔗 Привязать тэг к продукту

Привязывает указанный тэг к продукту по их идентификаторам.

PUT /api/tag/product/{tagId}/{productId}

Параметры пути PATH

Название	Тип	Обязательный	Описание
tagId	integer	Да	Параметр tagId
productId	integer	Да	Идентификатор товара

Тело ответа

✓ 200 OK ▶

⚠ 400 Ошибка с данными запроса ▶

Content-Type: application/json

Поле	Тип	Описание
error Обязательный	string	Код ошибки
localMessage Обязательный	string	Текст ошибки на языке пользователя
params	object	Дополнительные параметры ошибки

⚠ 403 Доступ запрещен ▶

Content-Type: application/json

Поле	Тип	Описание
error Обязательный	string	Код ошибки

✗ 500 Внутренняя ошибка сервера ▶

Content-Type: application/json

Поле	Тип	Описание
error Обязательный	string	Код ошибки
message	string	Описание ошибки
system	string	Системная ошибки парсинга данных запроса

Укажите ключ API в правом верхнем углу, чтобы попробовать использовать метод

Примеры кода

const axios = require('axios');

const response = await axios.put('https://api.selsup.ru/api/tag/product/${tagId}/${productId}',
  {
    headers: {
      'Authorization': 'YOUR_API_KEY',
      'Content-Type': 'application/json'
    }
  }
);

console.log(response.data);

import axios from 'axios';

const response = await axios.put<any>('https://api.selsup.ru/api/tag/product/${tagId}/${productId}',
  {
    headers: {
      'Authorization': 'YOUR_API_KEY',
      'Content-Type': 'application/json'
    }
  }
);

console.log(response.data);

import requests

headers = {
    'Authorization': 'YOUR_API_KEY',
    'Content-Type': 'application/json'
}

response = requests.put(
    'https://api.selsup.ru/api/tag/product/${tagId}/${productId}',
    headers=headers
)

print(response.json())

package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "net/http"
)

func main() {
    client := &http.Client{}

    req, _ := http.NewRequest("put", "https://api.selsup.ru/api/tag/product/${tagId}/${productId}", nil)
    req.Header.Set("Authorization", "YOUR_API_KEY")
    req.Header.Set("Content-Type", "application/json")

    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    var result map[string]interface{}
    json.NewDecoder(resp.Body).Decode(&result)
    fmt.Println(result)
}

import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

HttpClient client = HttpClient.newHttpClient();

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.selsup.ru/api/tag/product/${tagId}/${productId}"))
    .header("Authorization", "YOUR_API_KEY")
    .header("Content-Type", "application/json")
    .put(HttpRequest.BodyPublishers.noBody())
    .build();

HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

<?php
$curl = curl_init();

curl_setopt_array($curl, [
    CURLOPT_URL => 'https://api.selsup.ru/api/tag/product/${tagId}/${productId}',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'put',
    CURLOPT_HTTPHEADER => [
        'Authorization: YOUR_API_KEY',
        'Content-Type: application/json'
    ]
]);

$response = curl_exec($curl);
curl_close($curl);

echo $response;
?>

curl -X put \
  'https://api.selsup.ru/api/tag/product/{tagId}/{productId}' \
  -H 'Authorization: YOUR_API_KEY' \
  -H 'Content-Type: application/json'

🔗 Отвязать тэг от продукта

Удаляет связь между тэгом и продуктом по их идентификаторам.

DELETE /api/tag/product/{tagId}/{productId}

Параметры пути PATH

Название	Тип	Обязательный	Описание
tagId	integer	Да	Параметр tagId
productId	integer	Да	Идентификатор товара

Тело ответа

✓ 200 OK ▶

⚠ 400 Ошибка с данными запроса ▶

Content-Type: application/json

Поле	Тип	Описание
error Обязательный	string	Код ошибки
localMessage Обязательный	string	Текст ошибки на языке пользователя
params	object	Дополнительные параметры ошибки

⚠ 403 Доступ запрещен ▶

Content-Type: application/json

Поле	Тип	Описание
error Обязательный	string	Код ошибки

✗ 500 Внутренняя ошибка сервера ▶

Content-Type: application/json

Поле	Тип	Описание
error Обязательный	string	Код ошибки
message	string	Описание ошибки
system	string	Системная ошибки парсинга данных запроса

Укажите ключ API в правом верхнем углу, чтобы попробовать использовать метод

Примеры кода

const axios = require('axios');

const response = await axios.delete('https://api.selsup.ru/api/tag/product/${tagId}/${productId}',
  {
    headers: {
      'Authorization': 'YOUR_API_KEY',
      'Content-Type': 'application/json'
    }
  }
);

console.log(response.data);

import axios from 'axios';

const response = await axios.delete<any>('https://api.selsup.ru/api/tag/product/${tagId}/${productId}',
  {
    headers: {
      'Authorization': 'YOUR_API_KEY',
      'Content-Type': 'application/json'
    }
  }
);

console.log(response.data);

import requests

headers = {
    'Authorization': 'YOUR_API_KEY',
    'Content-Type': 'application/json'
}

response = requests.delete(
    'https://api.selsup.ru/api/tag/product/${tagId}/${productId}',
    headers=headers
)

print(response.json())

package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "net/http"
)

func main() {
    client := &http.Client{}

    req, _ := http.NewRequest("delete", "https://api.selsup.ru/api/tag/product/${tagId}/${productId}", nil)
    req.Header.Set("Authorization", "YOUR_API_KEY")
    req.Header.Set("Content-Type", "application/json")

    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    var result map[string]interface{}
    json.NewDecoder(resp.Body).Decode(&result)
    fmt.Println(result)
}

import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

HttpClient client = HttpClient.newHttpClient();

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.selsup.ru/api/tag/product/${tagId}/${productId}"))
    .header("Authorization", "YOUR_API_KEY")
    .header("Content-Type", "application/json")
    .delete(HttpRequest.BodyPublishers.noBody())
    .build();

HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

<?php
$curl = curl_init();

curl_setopt_array($curl, [
    CURLOPT_URL => 'https://api.selsup.ru/api/tag/product/${tagId}/${productId}',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'delete',
    CURLOPT_HTTPHEADER => [
        'Authorization: YOUR_API_KEY',
        'Content-Type: application/json'
    ]
]);

$response = curl_exec($curl);
curl_close($curl);

echo $response;
?>

curl -X delete \
  'https://api.selsup.ru/api/tag/product/{tagId}/{productId}' \
  -H 'Authorization: YOUR_API_KEY' \
  -H 'Content-Type: application/json'

🔗 Привязать тэг ко всем товарам модели

Привязывает указанный тэг ко всем продуктам модели.

PUT /api/tag/model/{tagId}/{modelId}

Параметры пути PATH

Название	Тип	Обязательный	Описание
tagId	integer	Да	Параметр tagId
modelId	integer	Да	Параметр modelId

Тело ответа

✓ 200 OK ▶

⚠ 400 Ошибка с данными запроса ▶

Content-Type: application/json

Поле	Тип	Описание
error Обязательный	string	Код ошибки
localMessage Обязательный	string	Текст ошибки на языке пользователя
params	object	Дополнительные параметры ошибки

⚠ 403 Доступ запрещен ▶

Content-Type: application/json

Поле	Тип	Описание
error Обязательный	string	Код ошибки

✗ 500 Внутренняя ошибка сервера ▶

Content-Type: application/json

Поле	Тип	Описание
error Обязательный	string	Код ошибки
message	string	Описание ошибки
system	string	Системная ошибки парсинга данных запроса

Укажите ключ API в правом верхнем углу, чтобы попробовать использовать метод

Примеры кода

const axios = require('axios');

const response = await axios.put('https://api.selsup.ru/api/tag/model/${tagId}/${modelId}',
  {
    headers: {
      'Authorization': 'YOUR_API_KEY',
      'Content-Type': 'application/json'
    }
  }
);

console.log(response.data);

import axios from 'axios';

const response = await axios.put<any>('https://api.selsup.ru/api/tag/model/${tagId}/${modelId}',
  {
    headers: {
      'Authorization': 'YOUR_API_KEY',
      'Content-Type': 'application/json'
    }
  }
);

console.log(response.data);

import requests

headers = {
    'Authorization': 'YOUR_API_KEY',
    'Content-Type': 'application/json'
}

response = requests.put(
    'https://api.selsup.ru/api/tag/model/${tagId}/${modelId}',
    headers=headers
)

print(response.json())

package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "net/http"
)

func main() {
    client := &http.Client{}

    req, _ := http.NewRequest("put", "https://api.selsup.ru/api/tag/model/${tagId}/${modelId}", nil)
    req.Header.Set("Authorization", "YOUR_API_KEY")
    req.Header.Set("Content-Type", "application/json")

    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    var result map[string]interface{}
    json.NewDecoder(resp.Body).Decode(&result)
    fmt.Println(result)
}

import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

HttpClient client = HttpClient.newHttpClient();

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.selsup.ru/api/tag/model/${tagId}/${modelId}"))
    .header("Authorization", "YOUR_API_KEY")
    .header("Content-Type", "application/json")
    .put(HttpRequest.BodyPublishers.noBody())
    .build();

HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

<?php
$curl = curl_init();

curl_setopt_array($curl, [
    CURLOPT_URL => 'https://api.selsup.ru/api/tag/model/${tagId}/${modelId}',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'put',
    CURLOPT_HTTPHEADER => [
        'Authorization: YOUR_API_KEY',
        'Content-Type: application/json'
    ]
]);

$response = curl_exec($curl);
curl_close($curl);

echo $response;
?>

curl -X put \
  'https://api.selsup.ru/api/tag/model/{tagId}/{modelId}' \
  -H 'Authorization: YOUR_API_KEY' \
  -H 'Content-Type: application/json'

🔗 Отвязать тэг от всех товаров модели

Удаляет связь между тэгом и всеми продуктами модели.

DELETE /api/tag/model/{tagId}/{modelId}

Параметры пути PATH

Название	Тип	Обязательный	Описание
tagId	integer	Да	Параметр tagId
modelId	integer	Да	Параметр modelId

Тело ответа

✓ 200 OK ▶

⚠ 400 Ошибка с данными запроса ▶

Content-Type: application/json

Поле	Тип	Описание
error Обязательный	string	Код ошибки
localMessage Обязательный	string	Текст ошибки на языке пользователя
params	object	Дополнительные параметры ошибки

⚠ 403 Доступ запрещен ▶

Content-Type: application/json

Поле	Тип	Описание
error Обязательный	string	Код ошибки

✗ 500 Внутренняя ошибка сервера ▶

Content-Type: application/json

Поле	Тип	Описание
error Обязательный	string	Код ошибки
message	string	Описание ошибки
system	string	Системная ошибки парсинга данных запроса

Укажите ключ API в правом верхнем углу, чтобы попробовать использовать метод

Примеры кода

const axios = require('axios');

const response = await axios.delete('https://api.selsup.ru/api/tag/model/${tagId}/${modelId}',
  {
    headers: {
      'Authorization': 'YOUR_API_KEY',
      'Content-Type': 'application/json'
    }
  }
);

console.log(response.data);

import axios from 'axios';

const response = await axios.delete<any>('https://api.selsup.ru/api/tag/model/${tagId}/${modelId}',
  {
    headers: {
      'Authorization': 'YOUR_API_KEY',
      'Content-Type': 'application/json'
    }
  }
);

console.log(response.data);

import requests

headers = {
    'Authorization': 'YOUR_API_KEY',
    'Content-Type': 'application/json'
}

response = requests.delete(
    'https://api.selsup.ru/api/tag/model/${tagId}/${modelId}',
    headers=headers
)

print(response.json())

package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "net/http"
)

func main() {
    client := &http.Client{}

    req, _ := http.NewRequest("delete", "https://api.selsup.ru/api/tag/model/${tagId}/${modelId}", nil)
    req.Header.Set("Authorization", "YOUR_API_KEY")
    req.Header.Set("Content-Type", "application/json")

    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    var result map[string]interface{}
    json.NewDecoder(resp.Body).Decode(&result)
    fmt.Println(result)
}

import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

HttpClient client = HttpClient.newHttpClient();

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.selsup.ru/api/tag/model/${tagId}/${modelId}"))
    .header("Authorization", "YOUR_API_KEY")
    .header("Content-Type", "application/json")
    .delete(HttpRequest.BodyPublishers.noBody())
    .build();

HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

<?php
$curl = curl_init();

curl_setopt_array($curl, [
    CURLOPT_URL => 'https://api.selsup.ru/api/tag/model/${tagId}/${modelId}',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'delete',
    CURLOPT_HTTPHEADER => [
        'Authorization: YOUR_API_KEY',
        'Content-Type: application/json'
    ]
]);

$response = curl_exec($curl);
curl_close($curl);

echo $response;
?>

curl -X delete \
  'https://api.selsup.ru/api/tag/model/{tagId}/{modelId}' \
  -H 'Authorization: YOUR_API_KEY' \
  -H 'Content-Type: application/json'

🔗 Создание тэга товара

Создаёт новый тэг для товаров клиента. Имя тэга должно быть уникальным в рамках клиента.

POST /api/tag

Тело запроса *Обязательно

Content-Type: application/json

Поле	Тип	Описание
name Обязательный	string	Название метки

Тело ответа

✓ 200 OK ▶

Content-Type: application/json

Поле	Тип	Описание
id	integer	Идентификатор метки
name	string	Название метки
clientId	integer	Идентификатор клиента

⚠ 400 Ошибка с данными запроса ▶

Content-Type: application/json

Поле	Тип	Описание
error Обязательный	string	Код ошибки
localMessage Обязательный	string	Текст ошибки на языке пользователя
params	object	Дополнительные параметры ошибки

⚠ 403 Доступ запрещен ▶

Content-Type: application/json

Поле	Тип	Описание
error Обязательный	string	Код ошибки

✗ 500 Внутренняя ошибка сервера ▶

Content-Type: application/json

Поле	Тип	Описание
error Обязательный	string	Код ошибки
message	string	Описание ошибки
system	string	Системная ошибки парсинга данных запроса

Укажите ключ API в правом верхнем углу, чтобы попробовать использовать метод

Примеры кода

const axios = require('axios');

const response = await axios.post('https://api.selsup.ru/api/tag',
  {
    "id": "Иванович",
    "name": "Иван",
    "clientId": 123
  },
  {
    headers: {
      'Authorization': 'YOUR_API_KEY',
      'Content-Type': 'application/json'
    }
  }
);

console.log(response.data);

import axios from 'axios';

const response = await axios.post<any>('https://api.selsup.ru/api/tag',
  {
    "id": "Иванович",
    "name": "Иван",
    "clientId": 123
  },
  {
    headers: {
      'Authorization': 'YOUR_API_KEY',
      'Content-Type': 'application/json'
    }
  }
);

console.log(response.data);

import requests

headers = {
    'Authorization': 'YOUR_API_KEY',
    'Content-Type': 'application/json'
}

response = requests.post(
    'https://api.selsup.ru/api/tag',
    headers=headers,
    json={
    'id': 'Иванович',
    'name': 'Иван',
    'clientId': 123
}
)

print(response.json())

package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "net/http"
)

func main() {
    client := &http.Client{}

    payload := map[string]interface{}{
        `id`: `Иванович`,
        `name`: `Иван`,
        `clientId`: 123
}
    jsonData, _ := json.Marshal(payload)

    req, _ := http.NewRequest("post", "https://api.selsup.ru/api/tag", bytes.NewBuffer(jsonData))
    req.Header.Set("Authorization", "YOUR_API_KEY")
    req.Header.Set("Content-Type", "application/json")

    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    var result map[string]interface{}
    json.NewDecoder(resp.Body).Decode(&result)
    fmt.Println(result)
}

import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

HttpClient client = HttpClient.newHttpClient();

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.selsup.ru/api/tag"))
    .header("Authorization", "YOUR_API_KEY")
    .header("Content-Type", "application/json")
    .post(HttpRequest.BodyPublishers.ofString(
        "{\"id\":\"Иванович\",\"name\":\"Иван\",\"clientId\":123}"
    ))
    .build();

HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

<?php
$curl = curl_init();

curl_setopt_array($curl, [
    CURLOPT_URL => 'https://api.selsup.ru/api/tag',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'post',
    CURLOPT_POSTFIELDS => json_encode({
    'id': 'Иванович',
    'name': 'Иван',
    'clientId': 123
}),
    CURLOPT_HTTPHEADER => [
        'Authorization: YOUR_API_KEY',
        'Content-Type: application/json'
    ]
]);

$response = curl_exec($curl);
curl_close($curl);

echo $response;
?>

curl -X post \
  'https://api.selsup.ru/api/tag' \
  -H 'Authorization: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "id": "Иванович",
  "name": "Иван",
  "clientId": 123
}'

🔗 Поиск и фильтрация тегов

Возвращает список тегов с поддержкой фильтрации, сортировки и пагинации.

GET /api/tag/find

Параметры запроса QUERY

Название	Тип	Обязательный	Описание
query	string	Нет	Запрос на поиск тега
productId	integer	Нет	Идентификатор продукта
limit	integer	Нет	Ограничение на количество записей. Максимальное значение - 500
page	integer	Нет	Номер страницы начиная с 1
count	boolean	Нет	Возвратить в ответе общее количество записей
sortBy	"ID""NAME"	Нет	Поле для сортировки
ascending	boolean	Нет	Порядок сортировки - по возрастанию?. Работает только при получении списка.

Тело ответа

✓ 200 OK ▶

Content-Type: application/json

Поле

Тип

Описание

rows

Array of ProductTag

Строки с результатом поиска

Структура ProductTag

Поле	Тип	Описание
id	integer	Идентификатор метки
name Обязательный	string	Название метки
clientId	integer	Идентификатор клиента

total

integer

Общее количество найденных записей. Возвращается только, когда count = true

page

integer

Номер запрошенной страницы

hasNextPage

boolean

Есть ли следующая страница

emptyPurchase

integer

Показатель пустой закупочной цены

⚠ 400 Ошибка с данными запроса ▶

Content-Type: application/json

Поле	Тип	Описание
error Обязательный	string	Код ошибки
localMessage Обязательный	string	Текст ошибки на языке пользователя
params	object	Дополнительные параметры ошибки

⚠ 403 Доступ запрещен ▶

Content-Type: application/json

Поле	Тип	Описание
error Обязательный	string	Код ошибки

✗ 500 Внутренняя ошибка сервера ▶

Content-Type: application/json

Поле	Тип	Описание
error Обязательный	string	Код ошибки
message	string	Описание ошибки
system	string	Системная ошибки парсинга данных запроса

Укажите ключ API в правом верхнем углу, чтобы попробовать использовать метод

Примеры кода

const axios = require('axios');

const params = {
  query: 'Пример query',
  productId: '123',
  limit: '100',
  page: '1',
  count: 'Россия',
  sortBy: 'ID',
  ascending: 'true',
};

const response = await axios.get('https://api.selsup.ru/api/tag/find',
  {
    params,
    headers: {
      'Authorization': 'YOUR_API_KEY',
      'Content-Type': 'application/json'
    }
  }
);

console.log(response.data);

import axios from 'axios';

interface QueryParams {
  query?: string;
  productId?: number;
  limit?: number;
  page?: number;
  count?: string;
  sortBy?: string;
  ascending?: string;
}

const params: QueryParams = {
  query: 'Пример query',
  productId: '123',
  limit: '100',
  page: '1',
  count: 'Россия',
  sortBy: 'ID',
  ascending: 'true',
};

const response = await axios.get<any>('https://api.selsup.ru/api/tag/find',
  {
    params,
    headers: {
      'Authorization': 'YOUR_API_KEY',
      'Content-Type': 'application/json'
    }
  }
);

console.log(response.data);

import requests

headers = {
    'Authorization': 'YOUR_API_KEY',
    'Content-Type': 'application/json'
}

params = {
    'query': 'Пример query',
    'productId': '123',
    'limit': '100',
    'page': '1',
    'count': 'Россия',
    'sortBy': 'ID',
    'ascending': 'true',
}

response = requests.get(
    'https://api.selsup.ru/api/tag/find',
    headers=headers,
    params=params
)

print(response.json())

package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "net/http"
)

func main() {
    client := &http.Client{}

    req, _ := http.NewRequest("get", "https://api.selsup.ru/api/tag/find?query=%D0%9F%D1%80%D0%B8%D0%BC%D0%B5%D1%80%20query&productId=123&limit=100&page=1&count=%D0%A0%D0%BE%D1%81%D1%81%D0%B8%D1%8F&sortBy=ID&ascending=true", nil)
    req.Header.Set("Authorization", "YOUR_API_KEY")
    req.Header.Set("Content-Type", "application/json")

    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    var result map[string]interface{}
    json.NewDecoder(resp.Body).Decode(&result)
    fmt.Println(result)
}

import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

HttpClient client = HttpClient.newHttpClient();

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.selsup.ru/api/tag/find?query=%D0%9F%D1%80%D0%B8%D0%BC%D0%B5%D1%80%20query&productId=123&limit=100&page=1&count=%D0%A0%D0%BE%D1%81%D1%81%D0%B8%D1%8F&sortBy=ID&ascending=true"))
    .header("Authorization", "YOUR_API_KEY")
    .header("Content-Type", "application/json")
    .get(HttpRequest.BodyPublishers.noBody())
    .build();

HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

<?php
$curl = curl_init();

$params = [
    'query' => 'Пример query',
    'productId' => '123',
    'limit' => '100',
    'page' => '1',
    'count' => 'Россия',
    'sortBy' => 'ID',
    'ascending' => 'true',
];

$url = 'https://api.selsup.ru/api/tag/find?' . http_build_query($params);

curl_setopt_array($curl, [
    CURLOPT_URL => $url,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'get',
    CURLOPT_HTTPHEADER => [
        'Authorization: YOUR_API_KEY',
        'Content-Type: application/json'
    ]
]);

$response = curl_exec($curl);
curl_close($curl);

echo $response;
?>

curl -X get \
  'https://api.selsup.ru/api/tag/find?query=%D0%9F%D1%80%D0%B8%D0%BC%D0%B5%D1%80%20query&productId=123&limit=100&page=1&count=%D0%A0%D0%BE%D1%81%D1%81%D0%B8%D1%8F&sortBy=ID&ascending=true' \
  -H 'Authorization: YOUR_API_KEY' \
  -H 'Content-Type: application/json'

🔗 Получить теги товаров по id модели

Возвращает список объектов,в которых сопоставляются id продукта и его теги

GET /api/tag/find/{modelId}

Параметры пути PATH

Название	Тип	Обязательный	Описание
modelId	integer	Да	Параметр modelId

Тело ответа

✓ 200 OK ▶

Content-Type: application/json

Поле

Тип

Описание

rows

Array of ProductTagInfo

Строки с результатом поиска

Структура ProductTagInfo

Поле

Тип

Описание

productId

integer

productTags

Array of ProductTag

Структура ProductTag

Поле	Тип	Описание
id	integer	Идентификатор метки
name Обязательный	string	Название метки
clientId	integer	Идентификатор клиента

total

integer

Общее количество найденных записей. Возвращается только, когда count = true

page

integer

Номер запрошенной страницы

hasNextPage

boolean

Есть ли следующая страница

emptyPurchase

integer

Показатель пустой закупочной цены

⚠ 400 Ошибка с данными запроса ▶

Content-Type: application/json

Поле	Тип	Описание
error Обязательный	string	Код ошибки
localMessage Обязательный	string	Текст ошибки на языке пользователя
params	object	Дополнительные параметры ошибки

⚠ 403 Доступ запрещен ▶

Content-Type: application/json

Поле	Тип	Описание
error Обязательный	string	Код ошибки

✗ 500 Внутренняя ошибка сервера ▶

Content-Type: application/json

Поле	Тип	Описание
error Обязательный	string	Код ошибки
message	string	Описание ошибки
system	string	Системная ошибки парсинга данных запроса

Укажите ключ API в правом верхнем углу, чтобы попробовать использовать метод

Примеры кода

const axios = require('axios');

const response = await axios.get('https://api.selsup.ru/api/tag/find/${modelId}',
  {
    headers: {
      'Authorization': 'YOUR_API_KEY',
      'Content-Type': 'application/json'
    }
  }
);

console.log(response.data);

import axios from 'axios';

const response = await axios.get<any>('https://api.selsup.ru/api/tag/find/${modelId}',
  {
    headers: {
      'Authorization': 'YOUR_API_KEY',
      'Content-Type': 'application/json'
    }
  }
);

console.log(response.data);

import requests

headers = {
    'Authorization': 'YOUR_API_KEY',
    'Content-Type': 'application/json'
}

response = requests.get(
    'https://api.selsup.ru/api/tag/find/${modelId}',
    headers=headers
)

print(response.json())

package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "net/http"
)

func main() {
    client := &http.Client{}

    req, _ := http.NewRequest("get", "https://api.selsup.ru/api/tag/find/${modelId}", nil)
    req.Header.Set("Authorization", "YOUR_API_KEY")
    req.Header.Set("Content-Type", "application/json")

    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    var result map[string]interface{}
    json.NewDecoder(resp.Body).Decode(&result)
    fmt.Println(result)
}

import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

HttpClient client = HttpClient.newHttpClient();

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.selsup.ru/api/tag/find/${modelId}"))
    .header("Authorization", "YOUR_API_KEY")
    .header("Content-Type", "application/json")
    .get(HttpRequest.BodyPublishers.noBody())
    .build();

HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

<?php
$curl = curl_init();

curl_setopt_array($curl, [
    CURLOPT_URL => 'https://api.selsup.ru/api/tag/find/${modelId}',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'get',
    CURLOPT_HTTPHEADER => [
        'Authorization: YOUR_API_KEY',
        'Content-Type: application/json'
    ]
]);

$response = curl_exec($curl);
curl_close($curl);

echo $response;
?>

curl -X get \
  'https://api.selsup.ru/api/tag/find/{modelId}' \
  -H 'Authorization: YOUR_API_KEY' \
  -H 'Content-Type: application/json'

Метки товаров

🔗 Обновление тэга товара

Параметры пути PATH

Тело запроса *Обязательно

Тело ответа

Примеры кода

🔗 Удаление тэга товара

Параметры пути PATH

Тело ответа

Примеры кода

🔗 Привязать тэг к продукту

Параметры пути PATH

Тело ответа

Примеры кода

🔗 Отвязать тэг от продукта

Параметры пути PATH

Тело ответа

Примеры кода

🔗 Привязать тэг ко всем товарам модели

Параметры пути PATH

Тело ответа

Примеры кода

🔗 Отвязать тэг от всех товаров модели

Параметры пути PATH

Тело ответа

Примеры кода

🔗 Создание тэга товара

Тело запроса *Обязательно

Тело ответа

Примеры кода

🔗 Поиск и фильтрация тегов

Параметры запроса QUERY

Тело ответа

Примеры кода

🔗 Получить теги товаров по id модели

Параметры пути PATH

Тело ответа

Примеры кода

Управление API ключом

Тестирование API

Ответ сервера