WbProducts icon

WbProducts

n8n node to interact with WB API

Overview

This node interacts with a specific API to retrieve characteristics (properties) of an object based on its subject ID within the "Категории Предметы И Характеристики" (Categories, Items, and Characteristics) resource. The operation "Get Object Charcs By Subjectid" fetches detailed attributes related to a particular subject/item identified by its numeric ID.

Typical use cases include:

  • Fetching detailed metadata or characteristics for a product or item in a catalog.
  • Localizing the response fields (subjectName and name) into different languages such as Russian, English, or Chinese.
  • Integrating with systems that require enriched data about items based on their IDs.

For example, if you have a product ID and want to get all its descriptive characteristics in English or Russian, this node will provide that information.

Properties

Name Meaning
Subject Id Numeric ID of the subject/item whose characteristics are to be retrieved. Example: 105
Locale Language of the response fields subjectName and name. Options: ru (Russian), en (English), zh (Chinese). Defaults to en. Not used in sandbox mode.

Output

The node outputs JSON data containing the characteristics of the specified subject. Key fields in the output include localized names and descriptions of the object's characteristics. The exact structure depends on the API response but generally includes:

  • subjectName: The name of the subject/item in the requested locale.
  • name: The name of each characteristic/property in the requested locale.
  • Additional metadata about each characteristic relevant to the subject.

No binary data output is indicated.

Dependencies

  • Requires access to the external API endpoint defined in the bundled Swagger/OpenAPI specification.
  • Needs an API key credential or similar authentication token configured in n8n to authorize requests.
  • The base URL and request headers are set according to the imported OpenAPI spec.
  • The locale parameter is sent as a query parameter to control language localization.

Troubleshooting

  • Missing or invalid Subject Id: Ensure the Subject Id property is provided and is a valid number. Errors may occur if the ID does not exist or is malformed.
  • Locale not supported: Using unsupported locale codes might result in default language responses or errors.
  • Authentication issues: If the API key or credentials are missing or incorrect, the node will fail to authenticate.
  • API downtime or network issues: External API unavailability will cause execution failures.
  • Sandbox limitations: The locale parameter is noted as not used in sandbox mode; expect default language responses there.

Common error messages might include HTTP 401 Unauthorized (authentication failure), 404 Not Found (invalid subject ID), or 500 Internal Server Error (API issues). Verify credentials, input parameters, and API status to resolve these.

Links and References

  • No direct links provided in the source code.
  • Refer to the API documentation corresponding to the "Категории Предметы И Характеристики" resource for detailed schema and usage.
  • Localization standards for language codes: ISO 639-1

Discussion