Les champs de logo apparaissent après le téléchargement d'une image. Les champ s'affichent volontairement.
Brand10 champs
brandIdinteger
Identifiant de marque dans le compte SelSup en cours.
read-only
namestring
Les espaces avant et arrière sont supprimés lorsqu'ils sont enregistrés.
Obligatoire
logoUrlstring
L'URL publique du logo actuel.
read-only
logoSizeinteger
Taille du logo en octets.
read-only
logoWidthinteger
Largeur du logo en pixels.
read-only
logoHeightinteger
La hauteur du logo en pixels.
read-only
deletedboolean
Si la marque est archivée.
ozonNamestring
Nom de marque dans le catalogue Ozon.
nullable
ozonIdinteger · int64
Identifiant de marque à Ozon.
nullable
oneCIdstring
Identifiant de marque externe dans le 1C.
nullable
Contrats d'erreur
Comment les erreurs d'application sont retournées
Le code error est identique dans chaque locale, tandis que le message d'utilisateur est traduit par le serveur.
Le projet de loi
Code stable lisible par machine pour la logique d'intégration.
Le projet de loi
Message prêt à être affiché dans la langue de l'utilisateur de jeton API.
Le projet de loi
Les valeurs interpolées par le serveur dans le modèle de message localisé.
文
localMessage utilise le champ lang de l'utilisateur qui possède le jeton API. Le langage de documentation et l'en-tête Accept-Language ne le modifient pas; le russe est utilisé lorsque l'usager n'a pas de langue configurée.
RULocalisation de l'utilisateur est ru
{
"error": "error_brand_already_exists",
"localMessage": "Бренд Base уже существует",
"params": {
"name": "Base"
}
}
FRFrançais (fr)
{
"error": "error_brand_already_exists",
"localMessage": "La marque Base existe déjà",
"params": {
"name": "Base"
}
}
Les points de fin
Les points de fin
GET
Trouver des marques
/api/brand/find
Token avec accès à la lecture
Le point final principal pour les listes, la recherche et la synchronisation. Il renvoie les marques du compte courant et prend en charge la pagination stable.
i
total est retourné uniquement lorsque count=true. Désactiver le compte pour les pages suivantes.
Paramètres de requête
Champ
Type
Obligatoire
Description
query
string
Non
Sous-string à rechercher dans le nom de marque.
deleted
boolean
Non
vrai pour archivé, faux pour actif.
brandOneCId
string
Non
Identifiant externe 1C.
hasOzonId
boolean
Non
Il est vrai de ne retourner que les marques mappées à Ozon.
limitValeur par défaut: 50
integer
Non
Des enregistrements par page, jusqu'à 500.
pageValeur par défaut: 1
integer
Non
Numéro de page à partir de 1.
countValeur par défaut: false
boolean
Non
Incluez le nombre total de correspondances au total.
sortBy
stringNAME, BRANDID
Non
Nom pour la marque, marque pour l'identifiant interne.
ascendingValeur par défaut: false
boolean
Non
vrai pour l'ordre ascendant, faux pour l"ordre descendant.
curl --request GET 'https://api.selsup.ru/api/brand/find?query=Base&limit=50&page=1&count=true&sortBy=NAME&ascending=true' \
--header 'Authorization: YOUR_API_TOKEN'
Les erreurs d'application sont normalement renvoyées sous le nom JSON avec error, localMessage et params. Brancher sur XPRO TECTED4X; le texte localisé peut changer. Comment les erreurs d'application sont retournées ↑
401auth_required
Autentification requise
Authorization est manquant, vide ou contient un jeton non valide.
400error_access_denied
Accès refusé
Le jeton existe, mais son rôle ne peut pas effectuer cette opération.
500error_unknown
Une erreur inconnue s'est produite. Si le problème persiste, contactez le service d'assistance
Faillite interne: économiser le temps de la demande et le support de contact; ne réessayez pas aveuglément une mutation.
GET
Liste de toutes les marques
/api/brand/all
Token avec accès à la lecture
Retourne toutes les marques du compte, triées par nom.
i
Pour les grands répertoires et la synchronisation récurrente, utilisez /find avec pagination.
curl --request GET 'https://api.selsup.ru/api/brand/all' \
--header 'Authorization: YOUR_API_TOKEN'
Les erreurs d'application sont normalement renvoyées sous le nom JSON avec error, localMessage et params. Brancher sur XPRO TECTED4X; le texte localisé peut changer. Comment les erreurs d'application sont retournées ↑
401auth_required
Autentification requise
Authorization est manquant, vide ou contient un jeton non valide.
400error_access_denied
Accès refusé
Le jeton existe, mais son rôle ne peut pas effectuer cette opération.
500error_unknown
Une erreur inconnue s'est produite. Si le problème persiste, contactez le service d'assistance
Faillite interne: économiser le temps de la demande et le support de contact; ne réessayez pas aveuglément une mutation.
GET
Obtenez une marque par carte d'identité
/api/brand/{brandId}
Token avec accès à la lecture
Retour d'une marque sur le compte courant par son identifiant interne.
i
L'implémentation actuelle renvoie une valeur vide pour un brandId inconnu au lieu de HTTP 404.
Parametres de parcours
Champ
Type
Obligatoire
Description
brandId
integer
Oui
Identifiant de marque dans SelSup.
curl --request GET 'https://api.selsup.ru/api/brand/8124' \
--header 'Authorization: YOUR_API_TOKEN'
Les erreurs d'application sont normalement renvoyées sous le nom JSON avec error, localMessage et params. Brancher sur XPRO TECTED4X; le texte localisé peut changer. Comment les erreurs d'application sont retournées ↑
401auth_required
Autentification requise
Authorization est manquant, vide ou contient un jeton non valide.
400error_access_denied
Accès refusé
Le jeton existe, mais son rôle ne peut pas effectuer cette opération.
500error_unknown
Une erreur inconnue s'est produite. Si le problème persiste, contactez le service d'assistance
Faillite interne: économiser le temps de la demande et le support de contact; ne réessayez pas aveuglément une mutation.
POST
Créer une marque
/api/brand
Token avec accès à l'écriture
Créer une marque dans le compte courant. Le nom suffit pour le cas commun.
i
Les noms sont comparés de manière insensible aux cas; Base et base sont traités comme la même marque.
Organisme de demande
application/json
Champ
Type
Obligatoire
Description
name
string
Oui
Un nom de marque unique et non vide.
ozonName
string
Non
Nom du répertoire Ozon, si on le sait.
ozonId
integer · int64
Non
Identification de marque Ozon lorsque les cartes sont envoyées sans importation préalable.
Les erreurs d'application sont normalement renvoyées sous le nom JSON avec error, localMessage et params. Brancher sur XPRO TECTED4X; le texte localisé peut changer. Comment les erreurs d'application sont retournées ↑
401auth_required
Autentification requise
Authorization est manquant, vide ou contient un jeton non valide.
400error_access_denied
Accès refusé
Le jeton existe, mais son rôle ne peut pas effectuer cette opération.
400error_empty_brand_name
Nom de marque non spécifié
le nom est manquant, vide ou ne contient que l'espace blanc.
400error_brand_already_exists
La marque {name} existe déjà
Le compte contient déjà un match insensible au cas. params.name contient le nom contradictoire.
400error_subscription_expired
Votre abonnement a expiré. Veuillez payer l'abonnement pour continuer à utiliser le service.
Pour continuer à utiliser le service, payez le tarif.
500error_unknown
Une erreur inconnue s'est produite. Si le problème persiste, contactez le service d'assistance
Faillite interne: économiser le temps de la demande et le support de contact; ne réessayez pas aveuglément une mutation.
PUT
Mise à jour d'une marque
/api/brand/{brandId}
Token avec accès à l'écriture
Le code d'identification provient de l'URL; ne pas envoyer le code didentification dans JSON.
i
Ceci est PUT, alors inclure toutes les valeurs que vous devez préserver. Les champs de logo sont gérés par des points d'extrémité séparés.
Les erreurs d'application sont normalement renvoyées sous le nom JSON avec error, localMessage et params. Brancher sur XPRO TECTED4X; le texte localisé peut changer. Comment les erreurs d'application sont retournées ↑
401auth_required
Autentification requise
Authorization est manquant, vide ou contient un jeton non valide.
400error_access_denied
Accès refusé
Le jeton existe, mais son rôle ne peut pas effectuer cette opération.
400error_empty_brand_name
Nom de marque non spécifié
le nom est manquant, vide ou ne contient que l'espace blanc.
400error_brand_already_exists
La marque {name} existe déjà
Le compte contient déjà un match insensible au cas. params.name contient le nom contradictoire.
400error_subscription_expired
Votre abonnement a expiré. Veuillez payer l'abonnement pour continuer à utiliser le service.
Pour continuer à utiliser le service, payez le tarif.
500error_unknown
Une erreur inconnue s'est produite. Si le problème persiste, contactez le service d'assistance
Faillite interne: économiser le temps de la demande et le support de contact; ne réessayez pas aveuglément une mutation.
DELETE
Supprimer, archiver ou restaurer une marque
/api/brand/{brandId}
Token avec accès à l'écriture
Avec deleted=true, SelSup tente une suppression dure. Si des références existent, il archivera la marque à la place. deleted = false la restaurera.
Parametres de parcours
Champ
Type
Obligatoire
Description
brandId
integer
Oui
Identifiant de marque.
Paramètres de requête
Champ
Type
Obligatoire
Description
deleted
boolean
Oui
vrai pour supprimer ou archiver; faux pour restaurer.
Les références ont empêché la suppression, de sorte que la marque a été archivée.
brand_has_been_restore
La marque a été restaurée de l'archivage.
"brand_signed_as_deleted"
Les erreurs3
Les erreurs d'application sont normalement renvoyées sous le nom JSON avec error, localMessage et params. Brancher sur XPRO TECTED4X; le texte localisé peut changer. Comment les erreurs d'application sont retournées ↑
401auth_required
Autentification requise
Authorization est manquant, vide ou contient un jeton non valide.
400error_access_denied
Accès refusé
Le jeton existe, mais son rôle ne peut pas effectuer cette opération.
500error_unknown
Une erreur inconnue s'est produite. Si le problème persiste, contactez le service d'assistance
Faillite interne: économiser le temps de la demande et le support de contact; ne réessayez pas aveuglément une mutation.
POST
Télécharger un logo
/api/brand/{brandId}/image
Token avec accès à l'écriture
Une image est téléchargée sous forme multipart/form-data. Un logo existant est remplacé.
i
Envoyez le fichier binaire dans le fixier; ce point final n'accepte pas JSON.
Les erreurs d'application sont normalement renvoyées sous le nom JSON avec error, localMessage et params. Brancher sur XPRO TECTED4X; le texte localisé peut changer. Comment les erreurs d'application sont retournées ↑
401auth_required
Autentification requise
Authorization est manquant, vide ou contient un jeton non valide.
400error_access_denied
Accès refusé
Le jeton existe, mais son rôle ne peut pas effectuer cette opération.
400error_brand_to_found
Marque {name} non trouvée
La documentation conserve le code error exactement comme le rend le API.
400error_wrong_image_format
Format d'image incorrect pour le fichier : {name}
Le fichier ne pouvait pas être décodé en format d'image pris en charge.
400error_max_upload_size_exceeded
Taille de fichier autorisée dépassée
La demande multipart dépasse la limite de téléchargement du serveur.
400error_subscription_expired
Votre abonnement a expiré. Veuillez payer l'abonnement pour continuer à utiliser le service.
Pour continuer à utiliser le service, payez le tarif.
500error_unknown
Une erreur inconnue s'est produite. Si le problème persiste, contactez le service d'assistance
Faillite interne: économiser le temps de la demande et le support de contact; ne réessayez pas aveuglément une mutation.
DELETE
Supprimer un logo
/api/brand/{brandId}/image
Token avec accès à l'écriture
Supprime le fichier de logo et réinitialise ses dimensions dans le dossier de marque.
Les erreurs d'application sont normalement renvoyées sous le nom JSON avec error, localMessage et params. Brancher sur XPRO TECTED4X; le texte localisé peut changer. Comment les erreurs d'application sont retournées ↑
401auth_required
Autentification requise
Authorization est manquant, vide ou contient un jeton non valide.
400error_access_denied
Accès refusé
Le jeton existe, mais son rôle ne peut pas effectuer cette opération.
400error_brand_to_found
Marque {name} non trouvée
La documentation conserve le code error exactement comme le rend le API.
400error_empty_brand_logo
La marque n'a pas d'image
La suppression du logo a été demandée pour une marque sans logo.
400error_cant_remove_brand_logo
Impossible de supprimer l'image de la marque
Le stockage n'a pas pu supprimer le fichier ou mettre à jour le dossier de marque.
400error_subscription_expired
Votre abonnement a expiré. Veuillez payer l'abonnement pour continuer à utiliser le service.
Pour continuer à utiliser le service, payez le tarif.
500error_unknown
Une erreur inconnue s'est produite. Si le problème persiste, contactez le service d'assistance
Faillite interne: économiser le temps de la demande et le support de contact; ne réessayez pas aveuglément une mutation.
POST
Les doublons de fusion
/api/brand/{brandId}/merge/{removeBrandId}
Token avec accès à l'écriture
Mette les modèles de produit de RemoveBrandId à BrandId, puis supprime définitivement RemoveBandId.
i
Cette procédure ne peut pas être annulée. la marque d'identification est conservée; supprimer la marche d' identification est le double à supprimer.
Parametres de parcours
Champ
Type
Obligatoire
Description
brandId
integer
Oui
Identifiant de marque principal.
removeBrandId
integer
Oui
Identifiant de marque à supprimer.
curl --request POST 'https://api.selsup.ru/api/brand/8124/merge/9012' \
--header 'Authorization: YOUR_API_TOKEN'
Les erreurs d'application sont normalement renvoyées sous le nom JSON avec error, localMessage et params. Brancher sur XPRO TECTED4X; le texte localisé peut changer. Comment les erreurs d'application sont retournées ↑
401auth_required
Autentification requise
Authorization est manquant, vide ou contient un jeton non valide.
400error_access_denied
Accès refusé
Le jeton existe, mais son rôle ne peut pas effectuer cette opération.
400error_brand_not_found
Marque non trouvée : {name}
L'une des marques demandées pour la fusion n'existe pas dans le compte courant.
400error_subscription_expired
Votre abonnement a expiré. Veuillez payer l'abonnement pour continuer à utiliser le service.
Pour continuer à utiliser le service, payez le tarif.
500error_unknown
Une erreur inconnue s'est produite. Si le problème persiste, contactez le service d'assistance
Faillite interne: économiser le temps de la demande et le support de contact; ne réessayez pas aveuglément une mutation.