API-ի միջոցով հնարավոր է ստանալ (GET), ստեղծել (POST), թարմացնել (PUT) և հեռացնել (DELETE) ապրանքների և ծառայությունների խմբերը։
URI
|
https://api.armsoft.am/trade/v1/directories/productsgroups
|
Տվյալ ռեսուրսի համար պահանջվում է ավտորիզացիա՝ API բանալու օգտագործմամբ։ Այն անհրաժեշտ է տեղադրել հարցման գլխագրի apiKey դաշտում. API բանալին ստանալու համար անհրաժեշտ է կատարել API գաղտնի բանալու ստացում էջում նկարագրված քայլերը:
-H 'apiKey: hJk:|^&99։՛(=0#biWc:'
|
Ապրանքների խմբեր օբյեկտի դաշտերը
Ստորև ներկայացված է օբյեկտի դաշտերի նկարագրությունը.
Անվանում
|
Տեսակ
|
Կիրառումը
|
Նկարագրություն
|
code
|
String(5)
|
*Required
|
Ապրանքի (ծառայության) խմբի կոդ։ Արժեք չտալու դեպքում համակարգի կողմից ավտոմատ գեներացվում է հաջորդական կոդ։
|
name
|
String(50)
|
*Required
|
Ապրանքի (ծառայության) խմբի անվանում։
|
parent
|
String(5)
|
Optional
Reference type
|
Կուտակիչ խմբի կոդ։
|
path
|
String()
|
System defined
|
Ապրանքային խմբի անվանումը, որի մեջ մտնում է տվյալ ենթախումբը։
|
nameEN
|
String(200)
|
Optional
|
Անվանում (անգլերեն)։
|
nameRU
|
String(200)
|
Optional
|
Անվանում (ռուսերեն)։
|
Օրինակ 1. Ապրանքների և ծառայությունների խմբի ավելացում
POST
|
Request
curl -X POST \
'https://api.armsoft.am/trade/v1/directories/productsgroups' \
-H 'accept: text/plain' \
-H 'Accept-Language: hy-AM' \
-H 'apiKey: %}uPbv>T0xZ}3beLxR{1' \
-H 'Content-Type: application/json' \
-d '
{
"code": "11",
"name": "Հեռուստացույց",
"parent": "1",
"path": "",
"nameEN": "",
"nameRU": ""
}'
Response body (201 Created)
{
"code": "11",
"name": "Հեռուստացույց",
"parent": "1",
"path": "1!11",
"nameEN": "",
"nameRU": ""
}
|
|
Օրինակ 2. Նշված կոդով ապրանքների և ծառայությունների խմբի տվյալների ստացում
GET
|
Request
curl -X GET \
'https://api.armsoft.am/trade/v1/directories/productsgroups/1' \
-H 'accept: */*' \
-H 'Accept-Language: hy-AM' \
-H 'apiKey: %}uPbv>T0xZ}3beLxR{1'
Response body (200 OK)
{
"code": "1",
"name": "Տեխնիկա",
"parent": "",
"path": "1",
"nameEN": "",
"nameRU": ""
}
|
|
Օրինակ 3. Ապրանքների և ծառայությունների խմբերի ցուցակի ստացում
GET
|
Request
curl -X GET \
'https://api.armsoft.am/trade/v1/directories/productsgroups' \
-H 'accept: */*' \
-H 'Accept-Language: hy-AM' \
-H 'apiKey: %}uPbv>T0xZ}3beLxR{1'
Response body (200 OK)
[
{
"code": "1",
"name": "Տեխնիկա",
"parent": "",
"path": "1",
"nameEN": "",
"nameRU": ""
},
{
"code": "11",
"name": "Հեռուստացույց",
"parent": "1",
"path": "1!11",
"nameEN": "",
"nameRU": ""
}
]
|
|
Օրինակ 4. Նշված կոդով ապրանքների և ծառայությունների խմբի դաշտերի խմբագրում
PUT
|
Request
curl -X PUT \
'https://api.armsoft.am/trade/v1/directories/productsgroups/11' \
-H 'accept: text/plain' \
-H 'Accept-Language: hy-AM' \
-H 'apiKey: %}uPbv>T0xZ}3beLxR{1'\
-H 'Content-Type: application/json' \
-d {
"code": "11",
"name": "LG Հեռուստացույցներ",
"parent": "1",
"path": "1!11",
"nameEN": "",
"nameRU": ""
}'
Response body (200 OK)
{
"code": "11",
"name": "LG Հեռուստացույցներ",
"parent": "1",
"path": "1!11",
"nameEN": "",
"nameRU": ""
}
|
|
Օրինակ 5. Նշված կոդով ապրանքների և ծառայությունների խմբի հեռացում
DELETE
|
Request
curl -X DELETE \
'https://api.armsoft.am/trade/v1/directories/productsgroups/11' \
-H 'accept: */*' \
-H 'Accept-Language: hy-AM' \
-H 'apiKey: %}uPbv>T0xZ}3beLxR{1'
Response body (200 OK)
|
|