User authentication and session management for B2B integrations
- Example of a request to get the composition of a category
Search products and categories
Get Products
Edit Products
Delete Items
Get a list of products
Create product
Example of a request to get categories
Get a list of product categories by ID
Create a Product Category
Edit a Product Category
Delete a Product Category
Get a list of product categories
Example of a request to g...
Business Management (1.0.0)
Full-featured B2B API for business operations.
Base URL: https://api.alteg.io/api
V1 will be gradually deprecated. We recommend using V2 API for new integrations. V1 endpoints are maintained for backward compatibility, but new features will be released in V2 only.
Download OpenAPI description
Overview
Languages
Servers
Mock server
https://developer.alteg.io/_mock/en/b2b-v1/openapi
Production
https://api.alteg.io/api/v1
- Mock serverhttps://developer.alteg.io/_mock/en/b2b-v1/openapi/company/{location_id}/goods_categories/{parent_category_id}
- Productionhttps://api.alteg.io/api/v1/company/{location_id}/goods_categories/{parent_category_id}
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X GET \
'https://developer.alteg.io/_mock/en/b2b-v1/openapi/company/{location_id}/goods_categories/{parent_category_id}?Accept=string&Content-Type=string&Authorization=string' \
-H 'Authorization: Bearer <YOUR_Bearer {PartnerToken}, User {UserToken}_HERE>'Response
application/json
{ "success": true, "data": [ { … }, { … }, { … } ], "meta": { "count": 94 } }
Request
##№ Composition of the product category
Information on a product category and its descendants can be obtained by making a request specifying the location ID and product category. Pagination is supported, specified by the page and count parameters.
Composition of a product category has the following structure:
| Field | Type | Description |
|---|---|---|
| parent_id | number | Parent element ID (0 for root elements) |
| item_id | number | Item ID (always 0) |
| category_id | number | Product category ID |
| title | string | Product category name |
| is_chain | boolean | Is the element chain-bound? true - the element is connected to the chain, false - not connected |
| is_category | boolean | Is the element a category? always true |
| is_item | boolean | Is the item a product? always false |
| children | array of objects (Product tree element) | Child elements of a product category |
| children_count | number | Total number of child products and categories (no recursion) |
Security
BearerPartnerUser
- Mock serverhttps://developer.alteg.io/_mock/en/b2b-v1/openapi/goods/category_node/{location_id}/{category_id}
- Productionhttps://api.alteg.io/api/v1/goods/category_node/{location_id}/{category_id}
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X GET \
'https://developer.alteg.io/_mock/en/b2b-v1/openapi/goods/category_node/{location_id}/{category_id}?page=0&count=0' \
-H 'Accept: application/vnd.api.v2+json' \
-H 'Authorization: Bearer <YOUR_Bearer {PartnerToken}, User {UserToken}_HERE>' \
-H 'Content-Type: string'OK
Object with data
Example: {"parent_id":0,"item_id":0,"category_id":123,"title":"Root category 1","is_chain":false,"is_category":true,"is_item":false,"children":[{"parent_id":123,"item_id":0,"category_id":456,"title":"Child category","is_chain":false,"is_category":true,"is_item":false},{"parent_id":123,"item_id":789,"category_id":0,"title":"Child product","is_chain":false,"is_category":false,"is_item":true}],"children_count":2}
Response
application/json
{ "success": true, "data": { "parent_id": 0, "item_id": 0, "category_id": 123, "title": "Root category 1", "is_chain": false, "is_category": true, "is_item": false, "children": [ … ], "children_count": 2 } }
- Mock serverhttps://developer.alteg.io/_mock/en/b2b-v1/openapi/goods_categories/multiple/{location_id}
- Productionhttps://api.alteg.io/api/v1/goods_categories/multiple/{location_id}
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X GET \
'https://developer.alteg.io/_mock/en/b2b-v1/openapi/goods_categories/multiple/{location_id}?location_id=0' \
-H 'Accept: application/vnd.api.v2+json' \
-H 'Authorization: Bearer <YOUR_Bearer {PartnerToken}, User {UserToken}_HERE>' \
-H 'Content-Type: string'Response
application/json
{ "success": true, "data": [ { … }, { … } ], "meta": [] }