Категории
Методы управления категориями и связями с категориями маркетплейсов
Базовый URL:
https://api.selsup.ru
🔗 Изменить категорию
Позволяет изменить информацию о категории. Обновляет всю категорию полностью
PUT
/api/category/{categoryId}
Параметры пути PATH
| Название | Тип | Обязательный | Описание |
|---|---|---|---|
| categoryId | integer | Да |
Идентификатор категории
|
Параметры запроса QUERY
| Название | Тип | Обязательный | Описание |
|---|---|---|---|
| merge | boolean | Нет |
Объединить с сохраненной категорией
|
Тело запроса *Обязательно
Content-Type:
application/json
| Поле | Тип | Описание | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| name Обязательный > | string | Наименование категории | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| parentId > | integer | Идентификатор родительской категории | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| marked > | boolean | Маркируется ли категория | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| categoryClass > | string | Группы категорий Честного знака | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| wildberriesType > | WildberriesType | Предмет Вайлдбериз | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Структура WildberriesType
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| wildberriesCategoryId > | integer | Идентификатор категории Wildberries, совпадает с ID категории на самом Wildberries | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ozonDescriptionCategoryId > | integer | Идентификатор категории на Ozon. Строится из ID категории + ID типа на Ozon | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| yandexMarketCategoryId > | integer | Идентификатор категории в Яндекс.Маркет. Совпадает с идентификатором категории на самом Яндекс.Маркет | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| yandexMarketCategory > | YandexMarketCategory | Категория Яндекс.Маркета | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Структура YandexMarketCategory
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ozonDescriptionCategory > | OzonDescriptionCategory | Категория Озон | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Структура OzonDescriptionCategory
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| tnved Обязательный > | Tnved | Код ТНВЭД | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Структура Tnved
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| tnvedId > | integer | Идентификатор ТНВЭД | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| laundry > | string | Правила ухода за вещами. Разделяются запятыми | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| params > | string | JSON значений параметров для категории | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| namePattern > | string | Шаблон названий категории | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| aliexpressCategory > | AliexpressCategory | Категория Aliexpress | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Структура AliexpressCategory
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| aliexpressCategoryId > | integer | Идентификатор категории на самом Aliexpress | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| avitoCategory > | AvitoCategory | Категория Авито | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Структура AvitoCategory
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| avitoCategoryId > | integer | Идентификатор категории на самом Avito | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| packDepth > | integer | Глубина упаковки в мм. Проставляется всем товарам в категории | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| packWidth > | integer | Ширина упаковки в мм. Проставляется всем товарам в категории | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| packHeight > | integer | Высота упаковки в мм. Проставляется всем товарам в категории | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| packWeight > | integer | Вес упаковки в граммах. Проставляется всем товарам в категории | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| hasSize > | boolean | Признак разделения товаров в категории по размеру. Меняет вид редактора карточки | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| hasColor > | boolean | Признак разделения товаров в категории по цвету. Меняет вид редактора карточки | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| autoName > | boolean | Автоматически формировать названия товаров в категории | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| removeFbsStock > | boolean | Не передавать остатки товаров по FBS для товаров из этой категории | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| oneCId > | string | Идентификатор категории в 1С | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| externalId > | string | Идентификатор категории на сайте | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| moySkladId > | string | Идентификатор категории в сервисе МойСклад | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| useClientParams > | boolean | Показывать пользовательские параметры в категории | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| requiredExpirationDate > | boolean | Является ли срок годности обязательным параметром | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Тело ответа
✓ 200
OK
▶
Content-Type:
application/json
| Поле | Тип | Описание | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| categoryId > | integer | Идентификатор категории. Проставляется автоматически | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| name > | string | Наименование категории | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| deleted > | boolean | Признак удаленных категорий | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| parentId > | integer | Идентификатор родительской категории | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| clientId > | integer | Идентификатор клиента | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| marked > | boolean | Маркируется ли категория | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| categoryClass > | string | Группы категорий Честного знака | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| wildberriesType > | WildberriesType | Предмет Вайлдбериз | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Структура WildberriesType
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| wildberriesCategoryId > | integer | Идентификатор категории Wildberries, совпадает с ID категории на самом Wildberries | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| wildberriesFbmCommission > | number | Комиссия по тарифу FBM | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| wildberriesFbwCommission > | number | Комиссия по тарифу FBW | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| wildberriesFbsCommission > | number | Комиссия по тарифу FBS | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| wildberriesDbsCommission > | number | Комиссия по тарифу DBS | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| wildberriesEdbsCommission > | number | Комиссия по тарифу EDBS | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| wildberriesCAndCCommission > | number | Комиссия по тарифу C&C | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| wildberriesBookingCommission > | number | Комиссия за бронирование | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ozonDescriptionCategoryId > | integer | Идентификатор категории на Ozon. Строится из ID категории + ID типа на Ozon | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| yandexMarketCategoryId > | integer | Идентификатор категории в Яндекс.Маркет. Совпадает с идентификатором категории на самом Яндекс.Маркет | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| yandexMarketCategory > | YandexMarketCategory | Категория Яндекс.Маркета | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Структура YandexMarketCategory
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ozonDescriptionCategory > | OzonDescriptionCategory | Категория Озон | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Структура OzonDescriptionCategory
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ozonCommission > | number | Комиссия озона. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| tnved > | Tnved | Код ТНВЭД | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Структура Tnved
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| tnvedId > | integer | Идентификатор ТНВЭД | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| laundry > | string | Правила ухода за вещами. Разделяются запятыми | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| params > | string | JSON значений параметров для категории | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| namePattern > | string | Шаблон названий категории | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| aliexpressCategory > | AliexpressCategory | Категория Aliexpress | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Структура AliexpressCategory
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| aliexpressCategoryId > | integer | Идентификатор категории на самом Aliexpress | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| avitoCategory > | AvitoCategory | Категория Авито | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Структура AvitoCategory
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| avitoCategoryId > | integer | Идентификатор категории на самом Avito | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| packDepth > | integer | Глубина упаковки в мм. Проставляется всем товарам в категории | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| packWidth > | integer | Ширина упаковки в мм. Проставляется всем товарам в категории | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| packHeight > | integer | Высота упаковки в мм. Проставляется всем товарам в категории | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| packWeight > | integer | Вес упаковки в граммах. Проставляется всем товарам в категории | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| hasSize > | boolean | Признак разделения товаров в категории по размеру. Меняет вид редактора карточки | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| hasColor > | boolean | Признак разделения товаров в категории по цвету. Меняет вид редактора карточки | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| autoName > | boolean | Автоматически формировать названия товаров в категории | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| removeFbsStock > | boolean | Не передавать остатки товаров по FBS для товаров из этой категории | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| oneCId > | string | Идентификатор категории в 1С | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| externalId > | string | Идентификатор категории на сайте | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| moySkladId > | string | Идентификатор категории в сервисе МойСклад | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| useClientParams > | boolean | Показывать пользовательские параметры в категории | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| requiredExpirationDate > | boolean | Является ли срок годности обязательным параметром | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
⚠ 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 = {
merge: 'true',
};
const response = await axios.put('https://api.selsup.ru/api/category/${categoryId}',
{
"categoryId": 123,
"name": "Иван",
"deleted": false,
"parentId": 123,
"clientId": 123,
"marked": true,
"categoryClass": "SHOES",
"wildberriesType": "standard",
"wildberriesCategoryId": 123,
"wildberriesFbmCommission": 1
},
{
params,
headers: {
'Authorization': 'YOUR_API_KEY',
'Content-Type': 'application/json'
}
}
);
console.log(response.data);
import axios from 'axios';
interface QueryParams {
merge?: string;
}
const params: QueryParams = {
merge: 'true',
};
const response = await axios.put<any>('https://api.selsup.ru/api/category/${categoryId}',
{
"categoryId": 123,
"name": "Иван",
"deleted": false,
"parentId": 123,
"clientId": 123,
"marked": true,
"categoryClass": "SHOES",
"wildberriesType": "standard",
"wildberriesCategoryId": 123,
"wildberriesFbmCommission": 1
},
{
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 = {
'merge': 'true',
}
response = requests.put(
'https://api.selsup.ru/api/category/${categoryId}',
headers=headers,
params=params,
json={
'categoryId': 123,
'name': 'Иван',
'deleted': false,
'parentId': 123,
'clientId': 123,
'marked': true,
'categoryClass': 'SHOES',
'wildberriesType': 'standard',
'wildberriesCategoryId': 123,
'wildberriesFbmCommission': 1
}
)
print(response.json())
package main
import (
"bytes"
"encoding/json"
"fmt"
"net/http"
)
func main() {
client := &http.Client{}
payload := map[string]interface{}{
`categoryId`: 123,
`name`: `Иван`,
`deleted`: false,
`parentId`: 123,
`clientId`: 123,
`marked`: true,
`categoryClass`: `SHOES`,
`wildberriesType`: `standard`,
`wildberriesCategoryId`: 123,
`wildberriesFbmCommission`: 1
}
jsonData, _ := json.Marshal(payload)
req, _ := http.NewRequest("put", "https://api.selsup.ru/api/category/${categoryId}?merge=true", 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/category/${categoryId}?merge=true"))
.header("Authorization", "YOUR_API_KEY")
.header("Content-Type", "application/json")
.put(HttpRequest.BodyPublishers.ofString(
"{\"categoryId\":123,\"name\":\"Иван\",\"deleted\":false,\"parentId\":123,\"clientId\":123,\"marked\":true,\"categoryClass\":\"SHOES\",\"wildberriesType\":\"standard\",\"wildberriesCategoryId\":123,\"wildberriesFbmCommission\":1}"
))
.build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
<?php
$curl = curl_init();
$params = [
'merge' => 'true',
];
$url = 'https://api.selsup.ru/api/category/${categoryId}?' . http_build_query($params);
curl_setopt_array($curl, [
CURLOPT_URL => $url,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => 'put',
CURLOPT_POSTFIELDS => json_encode({
'categoryId': 123,
'name': 'Иван',
'deleted': false,
'parentId': 123,
'clientId': 123,
'marked': true,
'categoryClass': 'SHOES',
'wildberriesType': 'standard',
'wildberriesCategoryId': 123,
'wildberriesFbmCommission': 1
}),
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/category/{categoryId}?merge=true' \
-H 'Authorization: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"categoryId": 123,
"name": "Иван",
"deleted": false,
"parentId": 123,
"clientId": 123,
"marked": true,
"categoryClass": "SHOES",
"wildberriesType": "standard",
"wildberriesCategoryId": 123,
"wildberriesFbmCommission": 1
}'
🔗 Удалить категорию
Позволяет удалить категорию или пометить ее удаленной
DELETE
/api/category/{categoryId}
Параметры пути PATH
| Название | Тип | Обязательный | Описание |
|---|---|---|---|
| categoryId | integer | Да |
Идентификатор категории
|
Параметры запроса QUERY
| Название | Тип | Обязательный | Описание |
|---|---|---|---|
| deleted | boolean | Да |
Для восстановления удаленной категории, необходимо передать deleted=false
|
Тело ответа
✓ 200
OK
▶
Тип:
string
⚠ 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 = {
deleted: 'false',
};
const response = await axios.delete('https://api.selsup.ru/api/category/${categoryId}',
{
params,
headers: {
'Authorization': 'YOUR_API_KEY',
'Content-Type': 'application/json'
}
}
);
console.log(response.data);
import axios from 'axios';
interface QueryParams {
deleted?: string;
}
const params: QueryParams = {
deleted: 'false',
};
const response = await axios.delete<any>('https://api.selsup.ru/api/category/${categoryId}',
{
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 = {
'deleted': 'false',
}
response = requests.delete(
'https://api.selsup.ru/api/category/${categoryId}',
headers=headers,
params=params
)
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/category/${categoryId}?deleted=false", 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/category/${categoryId}?deleted=false"))
.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();
$params = [
'deleted' => 'false',
];
$url = 'https://api.selsup.ru/api/category/${categoryId}?' . http_build_query($params);
curl_setopt_array($curl, [
CURLOPT_URL => $url,
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/category/{categoryId}?deleted=value' \
-H 'Authorization: YOUR_API_KEY' \
-H 'Content-Type: application/json'
🔗 Обновить категорию
Позволяет изменить только переданные поля о категории, объединяя их с сохраненными значениями
PATCH
/api/category/{categoryId}
Параметры пути PATH
| Название | Тип | Обязательный | Описание |
|---|---|---|---|
| categoryId | integer | Да |
Идентификатор категории
|
Тело запроса *Обязательно
Content-Type:
application/json
| Поле | Тип | Описание | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| name Обязательный > | string | Наименование категории | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| parentId > | integer | Идентификатор родительской категории | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| marked > | boolean | Маркируется ли категория | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| categoryClass > | string | Группы категорий Честного знака | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| wildberriesType > | WildberriesType | Предмет Вайлдбериз | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Структура WildberriesType
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| wildberriesCategoryId > | integer | Идентификатор категории Wildberries, совпадает с ID категории на самом Wildberries | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ozonDescriptionCategoryId > | integer | Идентификатор категории на Ozon. Строится из ID категории + ID типа на Ozon | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| yandexMarketCategoryId > | integer | Идентификатор категории в Яндекс.Маркет. Совпадает с идентификатором категории на самом Яндекс.Маркет | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| yandexMarketCategory > | YandexMarketCategory | Категория Яндекс.Маркета | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Структура YandexMarketCategory
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ozonDescriptionCategory > | OzonDescriptionCategory | Категория Озон | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Структура OzonDescriptionCategory
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| tnved Обязательный > | Tnved | Код ТНВЭД | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Структура Tnved
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| tnvedId > | integer | Идентификатор ТНВЭД | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| laundry > | string | Правила ухода за вещами. Разделяются запятыми | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| params > | string | JSON значений параметров для категории | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| namePattern > | string | Шаблон названий категории | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| aliexpressCategory > | AliexpressCategory | Категория Aliexpress | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Структура AliexpressCategory
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| aliexpressCategoryId > | integer | Идентификатор категории на самом Aliexpress | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| avitoCategory > | AvitoCategory | Категория Авито | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Структура AvitoCategory
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| avitoCategoryId > | integer | Идентификатор категории на самом Avito | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| packDepth > | integer | Глубина упаковки в мм. Проставляется всем товарам в категории | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| packWidth > | integer | Ширина упаковки в мм. Проставляется всем товарам в категории | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| packHeight > | integer | Высота упаковки в мм. Проставляется всем товарам в категории | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| packWeight > | integer | Вес упаковки в граммах. Проставляется всем товарам в категории | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| hasSize > | boolean | Признак разделения товаров в категории по размеру. Меняет вид редактора карточки | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| hasColor > | boolean | Признак разделения товаров в категории по цвету. Меняет вид редактора карточки | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| autoName > | boolean | Автоматически формировать названия товаров в категории | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| removeFbsStock > | boolean | Не передавать остатки товаров по FBS для товаров из этой категории | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| oneCId > | string | Идентификатор категории в 1С | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| externalId > | string | Идентификатор категории на сайте | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| moySkladId > | string | Идентификатор категории в сервисе МойСклад | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| useClientParams > | boolean | Показывать пользовательские параметры в категории | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| requiredExpirationDate > | boolean | Является ли срок годности обязательным параметром | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Тело ответа
✓ 200
OK
▶
Content-Type:
application/json
| Поле | Тип | Описание | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| categoryId > | integer | Идентификатор категории. Проставляется автоматически | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| name > | string | Наименование категории | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| deleted > | boolean | Признак удаленных категорий | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| parentId > | integer | Идентификатор родительской категории | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| clientId > | integer | Идентификатор клиента | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| marked > | boolean | Маркируется ли категория | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| categoryClass > | string | Группы категорий Честного знака | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| wildberriesType > | WildberriesType | Предмет Вайлдбериз | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Структура WildberriesType
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| wildberriesCategoryId > | integer | Идентификатор категории Wildberries, совпадает с ID категории на самом Wildberries | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| wildberriesFbmCommission > | number | Комиссия по тарифу FBM | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| wildberriesFbwCommission > | number | Комиссия по тарифу FBW | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| wildberriesFbsCommission > | number | Комиссия по тарифу FBS | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| wildberriesDbsCommission > | number | Комиссия по тарифу DBS | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| wildberriesEdbsCommission > | number | Комиссия по тарифу EDBS | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| wildberriesCAndCCommission > | number | Комиссия по тарифу C&C | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| wildberriesBookingCommission > | number | Комиссия за бронирование | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ozonDescriptionCategoryId > | integer | Идентификатор категории на Ozon. Строится из ID категории + ID типа на Ozon | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| yandexMarketCategoryId > | integer | Идентификатор категории в Яндекс.Маркет. Совпадает с идентификатором категории на самом Яндекс.Маркет | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| yandexMarketCategory > | YandexMarketCategory | Категория Яндекс.Маркета | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Структура YandexMarketCategory
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ozonDescriptionCategory > | OzonDescriptionCategory | Категория Озон | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Структура OzonDescriptionCategory
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ozonCommission > | number | Комиссия озона. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| tnved > | Tnved | Код ТНВЭД | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Структура Tnved
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| tnvedId > | integer | Идентификатор ТНВЭД | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| laundry > | string | Правила ухода за вещами. Разделяются запятыми | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| params > | string | JSON значений параметров для категории | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| namePattern > | string | Шаблон названий категории | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| aliexpressCategory > | AliexpressCategory | Категория Aliexpress | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Структура AliexpressCategory
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| aliexpressCategoryId > | integer | Идентификатор категории на самом Aliexpress | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| avitoCategory > | AvitoCategory | Категория Авито | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Структура AvitoCategory
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| avitoCategoryId > | integer | Идентификатор категории на самом Avito | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| packDepth > | integer | Глубина упаковки в мм. Проставляется всем товарам в категории | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| packWidth > | integer | Ширина упаковки в мм. Проставляется всем товарам в категории | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| packHeight > | integer | Высота упаковки в мм. Проставляется всем товарам в категории | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| packWeight > | integer | Вес упаковки в граммах. Проставляется всем товарам в категории | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| hasSize > | boolean | Признак разделения товаров в категории по размеру. Меняет вид редактора карточки | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| hasColor > | boolean | Признак разделения товаров в категории по цвету. Меняет вид редактора карточки | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| autoName > | boolean | Автоматически формировать названия товаров в категории | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| removeFbsStock > | boolean | Не передавать остатки товаров по FBS для товаров из этой категории | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| oneCId > | string | Идентификатор категории в 1С | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| externalId > | string | Идентификатор категории на сайте | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| moySkladId > | string | Идентификатор категории в сервисе МойСклад | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| useClientParams > | boolean | Показывать пользовательские параметры в категории | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| requiredExpirationDate > | boolean | Является ли срок годности обязательным параметром | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
⚠ 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.patch('https://api.selsup.ru/api/category/${categoryId}',
{
"categoryId": 123,
"name": "Иван",
"deleted": false,
"parentId": 123,
"clientId": 123,
"marked": true,
"categoryClass": "SHOES",
"wildberriesType": "standard",
"wildberriesCategoryId": 123,
"wildberriesFbmCommission": 1
},
{
headers: {
'Authorization': 'YOUR_API_KEY',
'Content-Type': 'application/json'
}
}
);
console.log(response.data);
import axios from 'axios';
const response = await axios.patch<any>('https://api.selsup.ru/api/category/${categoryId}',
{
"categoryId": 123,
"name": "Иван",
"deleted": false,
"parentId": 123,
"clientId": 123,
"marked": true,
"categoryClass": "SHOES",
"wildberriesType": "standard",
"wildberriesCategoryId": 123,
"wildberriesFbmCommission": 1
},
{
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.patch(
'https://api.selsup.ru/api/category/${categoryId}',
headers=headers,
json={
'categoryId': 123,
'name': 'Иван',
'deleted': false,
'parentId': 123,
'clientId': 123,
'marked': true,
'categoryClass': 'SHOES',
'wildberriesType': 'standard',
'wildberriesCategoryId': 123,
'wildberriesFbmCommission': 1
}
)
print(response.json())
package main
import (
"bytes"
"encoding/json"
"fmt"
"net/http"
)
func main() {
client := &http.Client{}
payload := map[string]interface{}{
`categoryId`: 123,
`name`: `Иван`,
`deleted`: false,
`parentId`: 123,
`clientId`: 123,
`marked`: true,
`categoryClass`: `SHOES`,
`wildberriesType`: `standard`,
`wildberriesCategoryId`: 123,
`wildberriesFbmCommission`: 1
}
jsonData, _ := json.Marshal(payload)
req, _ := http.NewRequest("patch", "https://api.selsup.ru/api/category/${categoryId}", 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/category/${categoryId}"))
.header("Authorization", "YOUR_API_KEY")
.header("Content-Type", "application/json")
.patch(HttpRequest.BodyPublishers.ofString(
"{\"categoryId\":123,\"name\":\"Иван\",\"deleted\":false,\"parentId\":123,\"clientId\":123,\"marked\":true,\"categoryClass\":\"SHOES\",\"wildberriesType\":\"standard\",\"wildberriesCategoryId\":123,\"wildberriesFbmCommission\":1}"
))
.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/category/${categoryId}',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => 'patch',
CURLOPT_POSTFIELDS => json_encode({
'categoryId': 123,
'name': 'Иван',
'deleted': false,
'parentId': 123,
'clientId': 123,
'marked': true,
'categoryClass': 'SHOES',
'wildberriesType': 'standard',
'wildberriesCategoryId': 123,
'wildberriesFbmCommission': 1
}),
CURLOPT_HTTPHEADER => [
'Authorization: YOUR_API_KEY',
'Content-Type: application/json'
]
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;
?>
curl -X patch \
'https://api.selsup.ru/api/category/{categoryId}' \
-H 'Authorization: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"categoryId": 123,
"name": "Иван",
"deleted": false,
"parentId": 123,
"clientId": 123,
"marked": true,
"categoryClass": "SHOES",
"wildberriesType": "standard",
"wildberriesCategoryId": 123,
"wildberriesFbmCommission": 1
}'
🔗 Объединение категорий
Позволяет объединить две категории - оставив только одну, перенеся все данные на другую категорию
POST
/api/category/{categoryId}/merge/{removedCategoryId}
Параметры пути PATH
| Название | Тип | Обязательный | Описание |
|---|---|---|---|
| categoryId | integer | Да |
Категория, на которую переносятся данные
|
| removedCategoryId | 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.post('https://api.selsup.ru/api/category/${categoryId}/merge/${removedCategoryId}',
{
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/category/${categoryId}/merge/${removedCategoryId}',
{
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/category/${categoryId}/merge/${removedCategoryId}',
headers=headers
)
print(response.json())
package main
import (
"bytes"
"encoding/json"
"fmt"
"net/http"
)
func main() {
client := &http.Client{}
req, _ := http.NewRequest("post", "https://api.selsup.ru/api/category/${categoryId}/merge/${removedCategoryId}", 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/category/${categoryId}/merge/${removedCategoryId}"))
.header("Authorization", "YOUR_API_KEY")
.header("Content-Type", "application/json")
.post(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/category/${categoryId}/merge/${removedCategoryId}',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => 'post',
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/category/{categoryId}/merge/{removedCategoryId}' \
-H 'Authorization: YOUR_API_KEY' \
-H 'Content-Type: application/json'
🔗 Создание категории
Создает новую категорию клиента. При создании обязательно передавать только название
POST
/api/category/
Тело запроса *Обязательно
Content-Type:
application/json
| Поле | Тип | Описание | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| name Обязательный > | string | Наименование категории | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| parentId > | integer | Идентификатор родительской категории | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| marked > | boolean | Маркируется ли категория | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| categoryClass > | string | Группы категорий Честного знака | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| wildberriesType > | WildberriesType | Предмет Вайлдбериз | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Структура WildberriesType
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| wildberriesCategoryId > | integer | Идентификатор категории Wildberries, совпадает с ID категории на самом Wildberries | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ozonDescriptionCategoryId > | integer | Идентификатор категории на Ozon. Строится из ID категории + ID типа на Ozon | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| yandexMarketCategoryId > | integer | Идентификатор категории в Яндекс.Маркет. Совпадает с идентификатором категории на самом Яндекс.Маркет | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| yandexMarketCategory > | YandexMarketCategory | Категория Яндекс.Маркета | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Структура YandexMarketCategory
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ozonDescriptionCategory > | OzonDescriptionCategory | Категория Озон | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Структура OzonDescriptionCategory
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| tnved Обязательный > | Tnved | Код ТНВЭД | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Структура Tnved
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| tnvedId > | integer | Идентификатор ТНВЭД | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| laundry > | string | Правила ухода за вещами. Разделяются запятыми | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| params > | string | JSON значений параметров для категории | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| namePattern > | string | Шаблон названий категории | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| aliexpressCategory > | AliexpressCategory | Категория Aliexpress | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Структура AliexpressCategory
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| aliexpressCategoryId > | integer | Идентификатор категории на самом Aliexpress | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| avitoCategory > | AvitoCategory | Категория Авито | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Структура AvitoCategory
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| avitoCategoryId > | integer | Идентификатор категории на самом Avito | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| packDepth > | integer | Глубина упаковки в мм. Проставляется всем товарам в категории | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| packWidth > | integer | Ширина упаковки в мм. Проставляется всем товарам в категории | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| packHeight > | integer | Высота упаковки в мм. Проставляется всем товарам в категории | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| packWeight > | integer | Вес упаковки в граммах. Проставляется всем товарам в категории | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| hasSize > | boolean | Признак разделения товаров в категории по размеру. Меняет вид редактора карточки | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| hasColor > | boolean | Признак разделения товаров в категории по цвету. Меняет вид редактора карточки | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| autoName > | boolean | Автоматически формировать названия товаров в категории | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| removeFbsStock > | boolean | Не передавать остатки товаров по FBS для товаров из этой категории | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| oneCId > | string | Идентификатор категории в 1С | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| externalId > | string | Идентификатор категории на сайте | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| moySkladId > | string | Идентификатор категории в сервисе МойСклад | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| useClientParams > | boolean | Показывать пользовательские параметры в категории | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| requiredExpirationDate > | boolean | Является ли срок годности обязательным параметром | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Тело ответа
✓ 200
OK
▶
Content-Type:
application/json
| Поле | Тип | Описание | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| categoryId > | integer | Идентификатор категории. Проставляется автоматически | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| name > | string | Наименование категории | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| deleted > | boolean | Признак удаленных категорий | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| parentId > | integer | Идентификатор родительской категории | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| clientId > | integer | Идентификатор клиента | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| marked > | boolean | Маркируется ли категория | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| categoryClass > | string | Группы категорий Честного знака | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| wildberriesType > | WildberriesType | Предмет Вайлдбериз | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Структура WildberriesType
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| wildberriesCategoryId > | integer | Идентификатор категории Wildberries, совпадает с ID категории на самом Wildberries | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| wildberriesFbmCommission > | number | Комиссия по тарифу FBM | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| wildberriesFbwCommission > | number | Комиссия по тарифу FBW | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| wildberriesFbsCommission > | number | Комиссия по тарифу FBS | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| wildberriesDbsCommission > | number | Комиссия по тарифу DBS | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| wildberriesEdbsCommission > | number | Комиссия по тарифу EDBS | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| wildberriesCAndCCommission > | number | Комиссия по тарифу C&C | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| wildberriesBookingCommission > | number | Комиссия за бронирование | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ozonDescriptionCategoryId > | integer | Идентификатор категории на Ozon. Строится из ID категории + ID типа на Ozon | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| yandexMarketCategoryId > | integer | Идентификатор категории в Яндекс.Маркет. Совпадает с идентификатором категории на самом Яндекс.Маркет | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| yandexMarketCategory > | YandexMarketCategory | Категория Яндекс.Маркета | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Структура YandexMarketCategory
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ozonDescriptionCategory > | OzonDescriptionCategory | Категория Озон | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Структура OzonDescriptionCategory
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ozonCommission > | number | Комиссия озона. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| tnved > | Tnved | Код ТНВЭД | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Структура Tnved
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| tnvedId > | integer | Идентификатор ТНВЭД | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| laundry > | string | Правила ухода за вещами. Разделяются запятыми | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| params > | string | JSON значений параметров для категории | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| namePattern > | string | Шаблон названий категории | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| aliexpressCategory > | AliexpressCategory | Категория Aliexpress | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Структура AliexpressCategory
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| aliexpressCategoryId > | integer | Идентификатор категории на самом Aliexpress | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| avitoCategory > | AvitoCategory | Категория Авито | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Структура AvitoCategory
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| avitoCategoryId > | integer | Идентификатор категории на самом Avito | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| packDepth > | integer | Глубина упаковки в мм. Проставляется всем товарам в категории | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| packWidth > | integer | Ширина упаковки в мм. Проставляется всем товарам в категории | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| packHeight > | integer | Высота упаковки в мм. Проставляется всем товарам в категории | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| packWeight > | integer | Вес упаковки в граммах. Проставляется всем товарам в категории | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| hasSize > | boolean | Признак разделения товаров в категории по размеру. Меняет вид редактора карточки | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| hasColor > | boolean | Признак разделения товаров в категории по цвету. Меняет вид редактора карточки | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| autoName > | boolean | Автоматически формировать названия товаров в категории | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| removeFbsStock > | boolean | Не передавать остатки товаров по FBS для товаров из этой категории | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| oneCId > | string | Идентификатор категории в 1С | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| externalId > | string | Идентификатор категории на сайте | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| moySkladId > | string | Идентификатор категории в сервисе МойСклад | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| useClientParams > | boolean | Показывать пользовательские параметры в категории | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| requiredExpirationDate > | boolean | Является ли срок годности обязательным параметром | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
⚠ 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/category/',
{
"categoryId": 123,
"name": "Иван",
"deleted": false,
"parentId": 123,
"clientId": 123,
"marked": true,
"categoryClass": "SHOES",
"wildberriesType": "standard",
"wildberriesCategoryId": 123,
"wildberriesFbmCommission": 1
},
{
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/category/',
{
"categoryId": 123,
"name": "Иван",
"deleted": false,
"parentId": 123,
"clientId": 123,
"marked": true,
"categoryClass": "SHOES",
"wildberriesType": "standard",
"wildberriesCategoryId": 123,
"wildberriesFbmCommission": 1
},
{
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/category/',
headers=headers,
json={
'categoryId': 123,
'name': 'Иван',
'deleted': false,
'parentId': 123,
'clientId': 123,
'marked': true,
'categoryClass': 'SHOES',
'wildberriesType': 'standard',
'wildberriesCategoryId': 123,
'wildberriesFbmCommission': 1
}
)
print(response.json())
package main
import (
"bytes"
"encoding/json"
"fmt"
"net/http"
)
func main() {
client := &http.Client{}
payload := map[string]interface{}{
`categoryId`: 123,
`name`: `Иван`,
`deleted`: false,
`parentId`: 123,
`clientId`: 123,
`marked`: true,
`categoryClass`: `SHOES`,
`wildberriesType`: `standard`,
`wildberriesCategoryId`: 123,
`wildberriesFbmCommission`: 1
}
jsonData, _ := json.Marshal(payload)
req, _ := http.NewRequest("post", "https://api.selsup.ru/api/category/", 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/category/"))
.header("Authorization", "YOUR_API_KEY")
.header("Content-Type", "application/json")
.post(HttpRequest.BodyPublishers.ofString(
"{\"categoryId\":123,\"name\":\"Иван\",\"deleted\":false,\"parentId\":123,\"clientId\":123,\"marked\":true,\"categoryClass\":\"SHOES\",\"wildberriesType\":\"standard\",\"wildberriesCategoryId\":123,\"wildberriesFbmCommission\":1}"
))
.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/category/',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => 'post',
CURLOPT_POSTFIELDS => json_encode({
'categoryId': 123,
'name': 'Иван',
'deleted': false,
'parentId': 123,
'clientId': 123,
'marked': true,
'categoryClass': 'SHOES',
'wildberriesType': 'standard',
'wildberriesCategoryId': 123,
'wildberriesFbmCommission': 1
}),
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/category/' \
-H 'Authorization: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"categoryId": 123,
"name": "Иван",
"deleted": false,
"parentId": 123,
"clientId": 123,
"marked": true,
"categoryClass": "SHOES",
"wildberriesType": "standard",
"wildberriesCategoryId": 123,
"wildberriesFbmCommission": 1
}'
🔗 Категория по идентификатору
Возвращает категорию клиента по идентификатору
GET
/api/category/{id}
Параметры пути PATH
| Название | Тип | Обязательный | Описание |
|---|---|---|---|
| id | integer | Да |
Идентификатор категории
|
Тело ответа
✓ 200
OK
▶
Content-Type:
application/json
| Поле | Тип | Описание | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| categoryId > | integer | Идентификатор категории. Проставляется автоматически | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| name > | string | Наименование категории | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| deleted > | boolean | Признак удаленных категорий | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| parentId > | integer | Идентификатор родительской категории | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| clientId > | integer | Идентификатор клиента | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| marked > | boolean | Маркируется ли категория | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| categoryClass > | string | Группы категорий Честного знака | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| wildberriesType > | WildberriesType | Предмет Вайлдбериз | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Структура WildberriesType
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| wildberriesCategoryId > | integer | Идентификатор категории Wildberries, совпадает с ID категории на самом Wildberries | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| wildberriesFbmCommission > | number | Комиссия по тарифу FBM | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| wildberriesFbwCommission > | number | Комиссия по тарифу FBW | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| wildberriesFbsCommission > | number | Комиссия по тарифу FBS | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| wildberriesDbsCommission > | number | Комиссия по тарифу DBS | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| wildberriesEdbsCommission > | number | Комиссия по тарифу EDBS | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| wildberriesCAndCCommission > | number | Комиссия по тарифу C&C | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| wildberriesBookingCommission > | number | Комиссия за бронирование | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ozonDescriptionCategoryId > | integer | Идентификатор категории на Ozon. Строится из ID категории + ID типа на Ozon | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| yandexMarketCategoryId > | integer | Идентификатор категории в Яндекс.Маркет. Совпадает с идентификатором категории на самом Яндекс.Маркет | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| yandexMarketCategory > | YandexMarketCategory | Категория Яндекс.Маркета | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Структура YandexMarketCategory
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ozonDescriptionCategory > | OzonDescriptionCategory | Категория Озон | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Структура OzonDescriptionCategory
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ozonCommission > | number | Комиссия озона. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| tnved > | Tnved | Код ТНВЭД | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Структура Tnved
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| tnvedId > | integer | Идентификатор ТНВЭД | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| laundry > | string | Правила ухода за вещами. Разделяются запятыми | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| params > | string | JSON значений параметров для категории | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| namePattern > | string | Шаблон названий категории | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| aliexpressCategory > | AliexpressCategory | Категория Aliexpress | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Структура AliexpressCategory
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| aliexpressCategoryId > | integer | Идентификатор категории на самом Aliexpress | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| avitoCategory > | AvitoCategory | Категория Авито | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Структура AvitoCategory
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| avitoCategoryId > | integer | Идентификатор категории на самом Avito | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| packDepth > | integer | Глубина упаковки в мм. Проставляется всем товарам в категории | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| packWidth > | integer | Ширина упаковки в мм. Проставляется всем товарам в категории | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| packHeight > | integer | Высота упаковки в мм. Проставляется всем товарам в категории | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| packWeight > | integer | Вес упаковки в граммах. Проставляется всем товарам в категории | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| hasSize > | boolean | Признак разделения товаров в категории по размеру. Меняет вид редактора карточки | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| hasColor > | boolean | Признак разделения товаров в категории по цвету. Меняет вид редактора карточки | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| autoName > | boolean | Автоматически формировать названия товаров в категории | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| removeFbsStock > | boolean | Не передавать остатки товаров по FBS для товаров из этой категории | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| oneCId > | string | Идентификатор категории в 1С | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| externalId > | string | Идентификатор категории на сайте | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| moySkladId > | string | Идентификатор категории в сервисе МойСклад | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| useClientParams > | boolean | Показывать пользовательские параметры в категории | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| requiredExpirationDate > | boolean | Является ли срок годности обязательным параметром | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
⚠ 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/category/${id}',
{
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/category/${id}',
{
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/category/${id}',
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/category/${id}", 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/category/${id}"))
.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/category/${id}',
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/category/{id}' \
-H 'Authorization: YOUR_API_KEY' \
-H 'Content-Type: application/json'
🔗 Поиск категории Яндекс.Маркета
Получение списка категорий Яндекс.Маркета по запросу
GET
/api/category/ym/find
Параметры запроса QUERY
| Название | Тип | Обязательный | Описание |
|---|---|---|---|
| query | string | Да |
Поисковый запрос
|
| limit | integer | Да |
Максимальное количество записей
|
Тело ответа
✓ 200
OK
▶
Content-Type:
application/json
Тип ответа:
YandexMarketCategory
Категория Яндекс.Маркета
Элементы массива
| Поле | Тип | Описание | |
|---|---|---|---|
| id | integer | Нет | |
| name | string | Нет | Название категории |
| published | boolean | Нет | |
| parentId | integer | Нет | |
| isLeaf | boolean | Нет | Признак листовой категории, в которой могут находиться товары |
| lastSyncDate | string | Нет | Дата последней синхронизации категории с Озон |
| notChangedDays | 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',
limit: '100',
};
const response = await axios.get('https://api.selsup.ru/api/category/ym/find',
{
params,
headers: {
'Authorization': 'YOUR_API_KEY',
'Content-Type': 'application/json'
}
}
);
console.log(response.data);
import axios from 'axios';
interface QueryParams {
query?: string;
limit?: number;
}
const params: QueryParams = {
query: 'Пример query',
limit: '100',
};
const response = await axios.get<any>('https://api.selsup.ru/api/category/ym/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',
'limit': '100',
}
response = requests.get(
'https://api.selsup.ru/api/category/ym/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/category/ym/find?query=%D0%9F%D1%80%D0%B8%D0%BC%D0%B5%D1%80%20query&limit=100", 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/category/ym/find?query=%D0%9F%D1%80%D0%B8%D0%BC%D0%B5%D1%80%20query&limit=100"))
.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',
'limit' => '100',
];
$url = 'https://api.selsup.ru/api/category/ym/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/category/ym/find?query=%D0%9F%D1%80%D0%B8%D0%BC%D0%B5%D1%80%20query&limit=100' \ -H 'Authorization: YOUR_API_KEY' \ -H 'Content-Type: application/json'
🔗 Поиск предмета Вайлдбериз
Производит поиск предмета Вайлдбериз по запросу
GET
/api/category/wildberries/find
Параметры запроса QUERY
| Название | Тип | Обязательный | Описание |
|---|---|---|---|
| query | string | Да |
Поисковый запрос
|
| limit | integer | Да |
Максимальное количество записей
|
Тело ответа
✓ 200
OK
▶
Content-Type:
application/json
Тип ответа:
WildberriesType
Предмет Вайлдбериз
Элементы массива
| Поле | Тип | Описание | |
|---|---|---|---|
| id | integer | Нет | |
| name | string | Нет | Название |
| published | boolean | Нет | Опубликованность предмета Вайлдбериз |
| hasSize | boolean | Нет | Атрибут, указывающий наличие размера |
| monoBoxMinQuantity | integer | Нет | |
| monoType | string | Нет | |
| monoMinPrice | integer | Нет | |
| hasParent | boolean | Нет | |
| parentId | integer | Нет | |
| wildberriesId | integer | Нет | Идентификатор предмета на Вайлдбериз |
| lastSyncDate | string | Нет | Дата последней синхронизации предмета с Вайлдбериз |
| notChangedDays | integer | Нет | Количество дней, в течение которых данные категории не менялась. Используется для того, чтобы сократить обновление категорий, которые не меняются |
| commission | number | Нет | Комиссия для товаров данного предмета в Вайлдбериз по FBM |
| fbsCommission | number | Нет | Комиссия для товаров данного предмета в Вайлдбериз по FBS |
| fbwCommission | number | Нет | Комиссия по тарифу FBW |
| dbsCommission | number | Нет | Комиссия по тарифу DBS |
| edbsCommission | number | Нет | Комиссия по тарифу EDBS |
| cAndCCommission | number | Нет | Комиссия по тарифу C&C |
| bookingCommission | number | Нет | Комиссия за бронирование |
| logisticPrice | integer | Нет | Стоимость доставки товара к клиенту на Вайлдбериз |
| storagePrice | number | Нет | Стоимость хранения товара на складе Вайлдбериз за штуку в день |
| acceptancePrice | number | Нет | Стоимость приемки товара на складе Вайлдбериз за штуку |
| needDimensions | boolean | Нет | Атрибут обязательности габаритов товара, тк стоимость хранения рассчитывается на основе габаритов |
| candCCommission | number | Нет |
⚠ 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',
limit: '100',
};
const response = await axios.get('https://api.selsup.ru/api/category/wildberries/find',
{
params,
headers: {
'Authorization': 'YOUR_API_KEY',
'Content-Type': 'application/json'
}
}
);
console.log(response.data);
import axios from 'axios';
interface QueryParams {
query?: string;
limit?: number;
}
const params: QueryParams = {
query: 'Пример query',
limit: '100',
};
const response = await axios.get<any>('https://api.selsup.ru/api/category/wildberries/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',
'limit': '100',
}
response = requests.get(
'https://api.selsup.ru/api/category/wildberries/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/category/wildberries/find?query=%D0%9F%D1%80%D0%B8%D0%BC%D0%B5%D1%80%20query&limit=100", 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/category/wildberries/find?query=%D0%9F%D1%80%D0%B8%D0%BC%D0%B5%D1%80%20query&limit=100"))
.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',
'limit' => '100',
];
$url = 'https://api.selsup.ru/api/category/wildberries/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/category/wildberries/find?query=%D0%9F%D1%80%D0%B8%D0%BC%D0%B5%D1%80%20query&limit=100' \ -H 'Authorization: YOUR_API_KEY' \ -H 'Content-Type: application/json'
🔗 Поиск категории
Производит поиск категории клиента для саджеста
GET
/api/category/suggest
Параметры запроса QUERY
| Название | Тип | Обязательный | Описание |
|---|---|---|---|
| query | string | Да |
Поисковый запрос
|
| limit | integer | Да |
Максимальное количество записей
|
Тело ответа
✓ 200
OK
▶
Content-Type:
application/json
Тип ответа:
Category
Категория
Элементы массива
| Поле | Тип | Описание | |
|---|---|---|---|
| categoryId | integer | Нет | Идентификатор категории. Проставляется автоматически |
| name | string | Нет | Наименование категории |
| deleted | boolean | Нет | Признак удаленных категорий |
| parentId | integer | Нет | Идентификатор родительской категории |
| clientId | integer | Нет | Идентификатор клиента |
| marked | boolean | Нет | Маркируется ли категория |
| categoryClass | string | Нет | Группы категорий Честного знака |
| wildberriesType | WildberriesType | Нет | Предмет Вайлдбериз |
| wildberriesCategoryId | integer | Нет | Идентификатор категории Wildberries, совпадает с ID категории на самом Wildberries |
| wildberriesFbmCommission | number | Нет | Комиссия по тарифу FBM |
| wildberriesFbwCommission | number | Нет | Комиссия по тарифу FBW |
| wildberriesFbsCommission | number | Нет | Комиссия по тарифу FBS |
| wildberriesDbsCommission | number | Нет | Комиссия по тарифу DBS |
| wildberriesEdbsCommission | number | Нет | Комиссия по тарифу EDBS |
| wildberriesCAndCCommission | number | Нет | Комиссия по тарифу C&C |
| wildberriesBookingCommission | number | Нет | Комиссия за бронирование |
| ozonDescriptionCategoryId | integer | Нет | Идентификатор категории на Ozon. Строится из ID категории + ID типа на Ozon |
| yandexMarketCategoryId | integer | Нет | Идентификатор категории в Яндекс.Маркет. Совпадает с идентификатором категории на самом Яндекс.Маркет |
| yandexMarketCategory | YandexMarketCategory | Нет | Категория Яндекс.Маркета |
| ozonDescriptionCategory | OzonDescriptionCategory | Нет | Категория Озон |
| ozonCommission | number | Нет | Комиссия озона. |
| tnved | Tnved | Нет | Код ТНВЭД |
| tnvedId | integer | Нет | Идентификатор ТНВЭД |
| laundry | string | Нет | Правила ухода за вещами. Разделяются запятыми |
| params | string | Нет | JSON значений параметров для категории |
| namePattern | string | Нет | Шаблон названий категории |
| aliexpressCategory | AliexpressCategory | Нет | Категория Aliexpress |
| aliexpressCategoryId | integer | Нет | Идентификатор категории на самом Aliexpress |
| avitoCategory | AvitoCategory | Нет | Категория Авито |
| avitoCategoryId | integer | Нет | Идентификатор категории на самом Avito |
| packDepth | integer | Нет | Глубина упаковки в мм. Проставляется всем товарам в категории |
| packWidth | integer | Нет | Ширина упаковки в мм. Проставляется всем товарам в категории |
| packHeight | integer | Нет | Высота упаковки в мм. Проставляется всем товарам в категории |
| packWeight | integer | Нет | Вес упаковки в граммах. Проставляется всем товарам в категории |
| hasSize | boolean | Нет | Признак разделения товаров в категории по размеру. Меняет вид редактора карточки |
| hasColor | boolean | Нет | Признак разделения товаров в категории по цвету. Меняет вид редактора карточки |
| autoName | boolean | Нет | Автоматически формировать названия товаров в категории |
| removeFbsStock | boolean | Нет | Не передавать остатки товаров по FBS для товаров из этой категории |
| oneCId | string | Нет | Идентификатор категории в 1С |
| externalId | string | Нет | Идентификатор категории на сайте |
| moySkladId | string | Нет | Идентификатор категории в сервисе МойСклад |
| useClientParams | boolean | Нет | Показывать пользовательские параметры в категории |
| requiredExpirationDate | boolean | Нет | Является ли срок годности обязательным параметром |
⚠ 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',
limit: '100',
};
const response = await axios.get('https://api.selsup.ru/api/category/suggest',
{
params,
headers: {
'Authorization': 'YOUR_API_KEY',
'Content-Type': 'application/json'
}
}
);
console.log(response.data);
import axios from 'axios';
interface QueryParams {
query?: string;
limit?: number;
}
const params: QueryParams = {
query: 'Пример query',
limit: '100',
};
const response = await axios.get<any>('https://api.selsup.ru/api/category/suggest',
{
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',
'limit': '100',
}
response = requests.get(
'https://api.selsup.ru/api/category/suggest',
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/category/suggest?query=%D0%9F%D1%80%D0%B8%D0%BC%D0%B5%D1%80%20query&limit=100", 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/category/suggest?query=%D0%9F%D1%80%D0%B8%D0%BC%D0%B5%D1%80%20query&limit=100"))
.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',
'limit' => '100',
];
$url = 'https://api.selsup.ru/api/category/suggest?' . 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/category/suggest?query=%D0%9F%D1%80%D0%B8%D0%BC%D0%B5%D1%80%20query&limit=100' \ -H 'Authorization: YOUR_API_KEY' \ -H 'Content-Type: application/json'
🔗 Поиск новой категории Озон
Получение списка категорий Озон по запросу
GET
/api/category/ozon/find
Параметры запроса QUERY
| Название | Тип | Обязательный | Описание |
|---|---|---|---|
| query | string | Да |
Поисковый запрос
|
| limit | integer | Да |
Максимальное количество записей
|
Тело ответа
✓ 200
OK
▶
Content-Type:
application/json
Тип ответа:
OzonDescriptionCategory
Категория Озон
Элементы массива
| Поле | Тип | Описание | |
|---|---|---|---|
| id | integer | Нет | Идентификатор категории на Ozon. Состоит из двух идентификаторов Категории + ID типа на самом Ozon |
| name | string | Нет | Название категории |
| published | boolean | Нет | |
| parentId | integer | Нет | |
| isLeaf | boolean | Нет | Признак листовой категории, в которой могут находиться товары |
| lastSyncDate | string | Нет | Дата последней синхронизации категории с Озон |
| notChangedDays | integer | Нет | Количество дней, в течение которых данные категории не менялась. Используется для того, чтобы сократить обновление категорий, которые не меняются |
| isError | boolean | Нет | |
| errorDate | string | Нет | |
| types | string | Нет | |
| typeId | integer | Нет | Идентификатор типа на Ozon |
⚠ 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',
limit: '100',
};
const response = await axios.get('https://api.selsup.ru/api/category/ozon/find',
{
params,
headers: {
'Authorization': 'YOUR_API_KEY',
'Content-Type': 'application/json'
}
}
);
console.log(response.data);
import axios from 'axios';
interface QueryParams {
query?: string;
limit?: number;
}
const params: QueryParams = {
query: 'Пример query',
limit: '100',
};
const response = await axios.get<any>('https://api.selsup.ru/api/category/ozon/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',
'limit': '100',
}
response = requests.get(
'https://api.selsup.ru/api/category/ozon/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/category/ozon/find?query=%D0%9F%D1%80%D0%B8%D0%BC%D0%B5%D1%80%20query&limit=100", 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/category/ozon/find?query=%D0%9F%D1%80%D0%B8%D0%BC%D0%B5%D1%80%20query&limit=100"))
.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',
'limit' => '100',
];
$url = 'https://api.selsup.ru/api/category/ozon/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/category/ozon/find?query=%D0%9F%D1%80%D0%B8%D0%BC%D0%B5%D1%80%20query&limit=100' \ -H 'Authorization: YOUR_API_KEY' \ -H 'Content-Type: application/json'
🔗 Поиск связанных категорий
Позволяет найти связанные категории для категорий маркетплейсов,чтобы их быстро указать
GET
/api/category/links
Параметры запроса QUERY
| Название | Тип | Обязательный | Описание |
|---|---|---|---|
| filter | object | Да |
Фильтр записей
|
Тело ответа
✓ 200
OK
▶
Content-Type:
application/json
Тип ответа:
CategoryLink
Элементы массива
| Поле | Тип | Описание | |
|---|---|---|---|
| id | integer | Нет | |
| sourceServiceId | integer | Нет | |
| sourceCategoryId | string | Нет | |
| resultServiceId | integer | Нет | |
| resultCategoryId | string | Нет | |
| resultCategory | object | Нет | |
| probability | number | Нет | |
| resultService | string | Нет | Сервис |
| sourceService | string | Нет | Сервис |
⚠ 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 = {
filter: '[object Object]',
};
const response = await axios.get('https://api.selsup.ru/api/category/links',
{
params,
headers: {
'Authorization': 'YOUR_API_KEY',
'Content-Type': 'application/json'
}
}
);
console.log(response.data);
import axios from 'axios';
interface QueryParams {
filter?: string;
}
const params: QueryParams = {
filter: '[object Object]',
};
const response = await axios.get<any>('https://api.selsup.ru/api/category/links',
{
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 = {
'filter': '[object Object]',
}
response = requests.get(
'https://api.selsup.ru/api/category/links',
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/category/links?filter=%5Bobject%20Object%5D", 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/category/links?filter=%5Bobject%20Object%5D"))
.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 = [
'filter' => '[object Object]',
];
$url = 'https://api.selsup.ru/api/category/links?' . 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/category/links?filter=%5Bobject%20Object%5D' \ -H 'Authorization: YOUR_API_KEY' \ -H 'Content-Type: application/json'
🔗 Поиск категории
Позволяет найти категории по фильтру
GET
/api/category/find
Параметры запроса QUERY
| Название | Тип | Обязательный | Описание |
|---|---|---|---|
| query | string | Нет |
Поисковый запрос по названию категории
|
| actual | boolean | Нет |
Поиск актуальных категорий
|
| ozonCategoryId | integer | Нет |
Поиск по категории Ozon
|
| aliexpressCategoryId | integer | Нет |
Поиск по категории Aliexpress
|
| categoryOneCId | integer | Нет |
Идентификатор категории в 1С
|
| services | Array of string | Нет |
Список сервисов в которых не указана связь
|
| limit | integer | Нет |
Ограничение на количество записей. Максимальное значение - 500
|
| page | integer | Нет |
Номер страницы начиная с 1
|
| count | boolean | Нет |
Возвратить в ответе общее количество записей
|
| sortBy | "CATEGORYID""NAME""CATEGORYCLASS""TNVED""MARKED" | Нет |
Поле для сортировки
|
| ascending | boolean | Нет |
Порядок сортировки - по возрастанию?. Работает только при получении списка.
|
Тело ответа
✓ 200
OK
▶
Content-Type:
application/json
| Поле | Тип | Описание | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| rows > | Array of Category | Строки с результатом поиска | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Структура Category
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 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',
actual: 'true',
ozonCategoryId: '123',
aliexpressCategoryId: '123',
categoryOneCId: 'Пример categoryOneCId',
services: '',
limit: '100',
page: '1',
count: 'Россия',
sortBy: 'CATEGORYID',
ascending: 'true',
};
const response = await axios.get('https://api.selsup.ru/api/category/find',
{
params,
headers: {
'Authorization': 'YOUR_API_KEY',
'Content-Type': 'application/json'
}
}
);
console.log(response.data);
import axios from 'axios';
interface QueryParams {
query?: string;
actual?: string;
ozonCategoryId?: number;
aliexpressCategoryId?: number;
categoryOneCId?: string;
services?: string;
limit?: number;
page?: number;
count?: string;
sortBy?: string;
ascending?: string;
}
const params: QueryParams = {
query: 'Пример query',
actual: 'true',
ozonCategoryId: '123',
aliexpressCategoryId: '123',
categoryOneCId: 'Пример categoryOneCId',
services: '',
limit: '100',
page: '1',
count: 'Россия',
sortBy: 'CATEGORYID',
ascending: 'true',
};
const response = await axios.get<any>('https://api.selsup.ru/api/category/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',
'actual': 'true',
'ozonCategoryId': '123',
'aliexpressCategoryId': '123',
'categoryOneCId': 'Пример categoryOneCId',
'services': '',
'limit': '100',
'page': '1',
'count': 'Россия',
'sortBy': 'CATEGORYID',
'ascending': 'true',
}
response = requests.get(
'https://api.selsup.ru/api/category/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/category/find?query=%D0%9F%D1%80%D0%B8%D0%BC%D0%B5%D1%80%20query&actual=true&ozonCategoryId=123&aliexpressCategoryId=123&categoryOneCId=%D0%9F%D1%80%D0%B8%D0%BC%D0%B5%D1%80%20categoryOneCId&services=&limit=100&page=1&count=%D0%A0%D0%BE%D1%81%D1%81%D0%B8%D1%8F&sortBy=CATEGORYID&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/category/find?query=%D0%9F%D1%80%D0%B8%D0%BC%D0%B5%D1%80%20query&actual=true&ozonCategoryId=123&aliexpressCategoryId=123&categoryOneCId=%D0%9F%D1%80%D0%B8%D0%BC%D0%B5%D1%80%20categoryOneCId&services=&limit=100&page=1&count=%D0%A0%D0%BE%D1%81%D1%81%D0%B8%D1%8F&sortBy=CATEGORYID&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',
'actual' => 'true',
'ozonCategoryId' => '123',
'aliexpressCategoryId' => '123',
'categoryOneCId' => 'Пример categoryOneCId',
'services' => '',
'limit' => '100',
'page' => '1',
'count' => 'Россия',
'sortBy' => 'CATEGORYID',
'ascending' => 'true',
];
$url = 'https://api.selsup.ru/api/category/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/category/find?query=%D0%9F%D1%80%D0%B8%D0%BC%D0%B5%D1%80%20query&actual=true&ozonCategoryId=123&aliexpressCategoryId=123&categoryOneCId=%D0%9F%D1%80%D0%B8%D0%BC%D0%B5%D1%80%20categoryOneCId&services=&limit=100&page=1&count=%D0%A0%D0%BE%D1%81%D1%81%D0%B8%D1%8F&sortBy=CATEGORYID&ascending=true' \ -H 'Authorization: YOUR_API_KEY' \ -H 'Content-Type: application/json'
🔗 Поиск категории Avito
Получение списка категорий Avito по запросу
GET
/api/category/avito/find
Параметры запроса QUERY
| Название | Тип | Обязательный | Описание |
|---|---|---|---|
| query | string | Да |
Поисковый запрос
|
| limit | integer | Да |
Сколько отдать категорий в ответе
|
Тело ответа
✓ 200
OK
▶
Content-Type:
application/json
Тип ответа:
AvitoCategory
Категория Авито
Элементы массива
| Поле | Тип | Описание | |
|---|---|---|---|
| id | integer | Нет | Идентификатор категории на Авито.Совпадает с идентификатором Авито |
| name | string | Нет | Полное название категории (включает в себя названия родительских категорий) |
| shortName | string | Нет | Краткое название категории |
| published | boolean | Нет | Опубликована категория |
| parentId | integer | Нет | id родительской категории Авито. Используется при импорте обьявлений с Авито |
| lastSyncDate | string | Нет | Дата последней синхронизации категории |
| isLeaf | boolean | Нет | Категория является листовой. Карточки можно добавлять только в листовые |
| goodsType | string | Нет | Тег GoodsType в фиде |
| category | string | Нет | Тег Category в фиде |
⚠ 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',
limit: '100',
};
const response = await axios.get('https://api.selsup.ru/api/category/avito/find',
{
params,
headers: {
'Authorization': 'YOUR_API_KEY',
'Content-Type': 'application/json'
}
}
);
console.log(response.data);
import axios from 'axios';
interface QueryParams {
query?: string;
limit?: number;
}
const params: QueryParams = {
query: 'Пример query',
limit: '100',
};
const response = await axios.get<any>('https://api.selsup.ru/api/category/avito/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',
'limit': '100',
}
response = requests.get(
'https://api.selsup.ru/api/category/avito/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/category/avito/find?query=%D0%9F%D1%80%D0%B8%D0%BC%D0%B5%D1%80%20query&limit=100", 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/category/avito/find?query=%D0%9F%D1%80%D0%B8%D0%BC%D0%B5%D1%80%20query&limit=100"))
.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',
'limit' => '100',
];
$url = 'https://api.selsup.ru/api/category/avito/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/category/avito/find?query=%D0%9F%D1%80%D0%B8%D0%BC%D0%B5%D1%80%20query&limit=100' \ -H 'Authorization: YOUR_API_KEY' \ -H 'Content-Type: application/json'
🔗 Поиск категории Aliexpress
Получение списка категорий Aliexpress по запросу
GET
/api/category/aliexpress/find
Параметры запроса QUERY
| Название | Тип | Обязательный | Описание |
|---|---|---|---|
| query | string | Да |
Поисковый запрос
|
| limit | integer | Да |
Максимальное количество записей
|
Тело ответа
✓ 200
OK
▶
Content-Type:
application/json
Тип ответа:
AliexpressCategory
Категория Aliexpress
Элементы массива
| Поле | Тип | Описание | |
|---|---|---|---|
| id | integer | Нет | |
| name | string | Нет | |
| published | boolean | Нет | |
| parentId | integer | Нет | |
| aliexpressId | integer | Нет | |
| lastSyncDate | string | Нет | Дата последней синхронизации категории |
| notChangedDays | integer | Нет | Количество дней, в течение которых данные категории не менялась. Используется для того, чтобы сократить обновление категорий, которые не меняются |
| isLeaf | boolean | Нет | Категория является листовой. Карточки можно добавлять только в листовые |
⚠ 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',
limit: '100',
};
const response = await axios.get('https://api.selsup.ru/api/category/aliexpress/find',
{
params,
headers: {
'Authorization': 'YOUR_API_KEY',
'Content-Type': 'application/json'
}
}
);
console.log(response.data);
import axios from 'axios';
interface QueryParams {
query?: string;
limit?: number;
}
const params: QueryParams = {
query: 'Пример query',
limit: '100',
};
const response = await axios.get<any>('https://api.selsup.ru/api/category/aliexpress/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',
'limit': '100',
}
response = requests.get(
'https://api.selsup.ru/api/category/aliexpress/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/category/aliexpress/find?query=%D0%9F%D1%80%D0%B8%D0%BC%D0%B5%D1%80%20query&limit=100", 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/category/aliexpress/find?query=%D0%9F%D1%80%D0%B8%D0%BC%D0%B5%D1%80%20query&limit=100"))
.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',
'limit' => '100',
];
$url = 'https://api.selsup.ru/api/category/aliexpress/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/category/aliexpress/find?query=%D0%9F%D1%80%D0%B8%D0%BC%D0%B5%D1%80%20query&limit=100' \ -H 'Authorization: YOUR_API_KEY' \ -H 'Content-Type: application/json'
🔗 Удалить связать параметра с категорией
Удаляет связь пользовательского параметра с категорией
DELETE
/api/category/{categoryId}/param/{paramId}
Параметры пути PATH
| Название | Тип | Обязательный | Описание |
|---|---|---|---|
| paramId | integer | Да |
Параметр paramId
|
| categoryId | 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/category/${categoryId}/param/${paramId}',
{
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/category/${categoryId}/param/${paramId}',
{
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/category/${categoryId}/param/${paramId}',
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/category/${categoryId}/param/${paramId}", 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/category/${categoryId}/param/${paramId}"))
.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/category/${categoryId}/param/${paramId}',
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/category/{categoryId}/param/{paramId}' \
-H 'Authorization: YOUR_API_KEY' \
-H 'Content-Type: application/json'
Управление API ключом
Ключ будет сохранен локально в браузере