Add Category

Description: Creates a new category with details like status, alias, image, and multilingual descriptions. Requires authentication headers (apikey, secure-business-key, apiconnection, userToken) and form-data fields such as status, descriptions. Add a new category with specified attributes.

Headers

Key	Value	Description	Type
`apikey`	`5f28583f26a1a`	API key for authentication; contact support to obtain. `Required`	`string`
`apiconnection`	`appmobile`	Connection type; contact support to obtain. `Required`	`string`
`secure-business-key`	`4765066450c0bd66325.48403130`	Business-specific key; contact support for valid values. `Required`	`string`
`userToken`	`09119b2691afaa567bc1d46c829ebd41193c8545191146cc5df791681a792ad9`	User token from authentication API. `Required` (Get user token from `https://testaccounts.vodoerp.com/api/login` or `https://accounts.vodoerp.com/api/login`)	`string`

Body or Form Data

Key	Value	Description	Type
`status`	`1`	Category status (1 or 0).	`string`
`top`	`0`	Top category (1 or 0).	`string`
`alias`	`454722tsccscscscgfegfrhhjgvsbfd`	Category alias. `Required`	`string`
`sort`	`10`	Sorting order.	`string`
`image`	`http://127.0.0.1:8000/data/47/lfm/code.png`	Category image URL.	`string`
`parent`	(empty)	Parent category ID. (Get from api request `{{APP_URL}}/api/v1/ecomm_categories`)	`string`
`descriptions[0][lang]`	`en`	Language for first description. `Required`	`string`
`descriptions[0][keyword]`	`keyword_en`	Keyword for first description. `Required`	`string`
`descriptions[0][title]`	`Category Name ENscegefrhdghd`	Title for first description. `Required`	`string`
`descriptions[0][description]`	`Category Description EN`	Description for first description. `Required`	`string`
`descriptions[1][lang]`	`ar`	Language for second description. `Required`	`string`
`descriptions[1][keyword]`	`keyword_ar`	Keyword for second description. `Required`	`string`
`descriptions[1][title]`	`Category Name ARscegefrhdghd`	Title for second description. `Required`	`string`
`descriptions[1][description]`	`Category Description AR`	Description for second description. `Required`	`string`

The response will contain the result of the category addition, including the category ID and any relevant success or error messages.

curl --location -g --request POST 'https://www.testecommerce.vodoerp.com/{{categories}}' \ --header 'apikey: 5f28583f26a1a' \ --header 'apiconnection: appmobile' \ --header 'secure-business-key: 4765066450c0bd66325.48403130' \ --header 'userToken: 09119b2691afaa567bc1d46c829ebd41193c8545191146cc5df791681a792ad9' \ --form 'status="1"' \ --form 'top="0"' \ --form 'alias="454722tsccscscscgfegfrhhjgvsbfd"' \ --form 'sort="10"' \ --form 'image="http://127.0.0.1:8000/data/47/lfm/code.png"' \ --form 'parent=""' \ --form 'descriptions[0][lang]="en"' \ --form 'descriptions[0][keyword]="keyword_en"' \ --form 'descriptions[0][title]="Category Name ENscegefrhdghd"' \ --form 'descriptions[0][description]="Category Description EN"' \ --form 'descriptions[1][lang]="ar"' \ --form 'descriptions[1][keyword]="keyword_ar"' \ --form 'descriptions[1][title]="Category Name ARscegefrhdghd"' \ --form 'descriptions[1][description]="Category Description AR"'

Request

Header Params

apikey

string

required

You must contact support to get the apikey.

Example:

5f28583f26a1a

apiconnection

string

required

You must contact support to get the apiconnection.

Example:

appmobile

secure-business-key

string

required

You must contact support to get the secure-business-key like: 4765066450c0bd66325.48403130
728106399db2b289783.89154521
2680667168f2f8a68f6.12561200
140356399db2b2c32f0.25237063
96701678e330f31f768.22400604
14807664478836358b0.31329842

Example:

4765066450c0bd66325.48403130

userToken

string

required

Get user token from
https://testaccounts.vodoerp.com/api/login
or
https://accounts.vodoerp.com/api/login

Example:

09119b2691afaa567bc1d46c829ebd41193c8545191146cc5df791681a792ad9

Body Params multipart/form-data

status

string

required

1 or 0

Example:

top

string

required

1 or 0

Example:

alias

string

required

Example:

454722tsccscscscgfegfrhhjgvsbfd

sort

string

required

Example:

image

string

required

Example:

http://127.0.0.1:8000/data/47/lfm/code.png

parent

string

required

descriptions[0][lang]

string

required

Example:

descriptions[0][keyword]

string

optional

Example:

keyword_en

descriptions[0][title]

string

optional

Example:

Category Name ENscegefrhdghd

descriptions[0][description]

string

required

Example:

Category Description EN

descriptions[1][lang]

string

required

Example:

descriptions[1][keyword]

string

required

Example:

keyword_ar

descriptions[1][title]

string

required

Example:

Category Name ARscegefrhdghd

descriptions[1][description]

string

required

Example:

Category Description AR

Request

Responses