API-ի միջոցով հնարավոր է ստանալ (GET), ստեղծել (POST), թարմացնել (PUT) և հեռացնել (DELETE) ապրանքների գծիկավոր կոդերը։
URI
|
https://api.armsoft.am/trade/v1/directories/barcodes
|
Տվյալ ռեսուրսի համար պահանջվում է ավտորիզացիա՝ API բանալու օգտագործմամբ։ Այն անհրաժեշտ է տեղադրել հարցման գլխագրի apiKey դաշտում. API բանալին ստանալու համար անհրաժեշտ է կատարել API գաղտնի բանալու ստացում էջում նկարագրված քայլերը:
-H 'apiKey: hJk:|^&99։՛(=0#biWc:'
|
Այս հարցման դեպքում գործում է էջավորման մեխանիզմը:
Ապրանքների գծիկավոր կոդերի օբյեկտի դաշտերը
Ստորև ներկայացված է օբյեկտի դաշտերի նկարագրությունը.
Անվանում
|
Տեսակ
|
Կիրառումը
|
Նկարագրություն
|
code
|
String(20)
|
*Required
|
Ապրանքի (ծառայության) գծիկավոր կոդ։
|
itemId
|
Integer
|
System defined
|
Ապրանքի (ծառայության) ներքին նույնացուցիչ։
|
itemCode
|
String(20)
|
*Required
Reference type
|
Ապրանքի (ծառայության) կոդ։
|
itemName
|
String(200)
|
Read only
|
Ապրանքի (ծառայության) անվանում։
|
unitMeasure
|
String(3)
|
*Required
Reference type
|
Ապրանքի (ծառայության) չափման միավորի կոդ։
|
unitMeasureAbbreviation
|
String(6)
|
Read only
|
Ապրանքի (ծառայության) չափման միավորի հապավում։
|
weightItem
|
Boolean
|
Read only
|
Նշվում է` տվյալ ապրանքը քաշային է, թե ոչ: Կիրառվում է էլեկտրոնային կշեռքով աշխատելու դեպքում:
|
Օրինակ 1. Նշված կոդով և չափման միավորով ապրանքի կամ ծառայության գծիկավոր կոդի ավելացում
POST
|
Request
curl -X POST \
'https://api.armsoft.am/trade/v1/directories/barcodes' \
-H 'accept: text/plain' \
-H 'Accept-Language: hy-AM' \
-H 'apiKey: %}uPbv>T0xZ}3beLxR{1' \
-H 'Content-Type: application/json' \
-d '
{
"code": "1111",
"itemCode": "1001",
"unitMeasure": "001"
}'
Response body (201 Created)
{
"code": "1111",
"itemId": 100000,
"itemCode": "1001",
"itemName": "",
"unitMeasure": "001",
"unitMeasureAbbreviation": "",
"weightItem": false
}
|
|
Օրինակ 2. Նշված կոդով ապրանքի կամ ծառայության գծիկավոր կոդի տվյալների ստացում
GET
|
Request
curl -X GET \
'https://api.armsoft.am/trade/v1/directories/barcodes/1001' \
-H 'accept: */*' \
-H 'Accept-Language: hy-AM' \
-H 'apiKey: %}uPbv>T0xZ}3beLxR{1'
Response body (200 OK)
{
"code": "1001",
"itemId": 100000,
"itemCode": "1001",
"itemName": "Հեռուստացույց LED Panasonic TX-LR55ET5",
"unitMeasure": "001",
"unitMeasureAbbreviation": "հատ",
"weightItem": false
}
|
|
Օրինակ 3. Նշված գծիկավոր կոդի խմբագրում
PUT
|
Request
curl -X PUT \
'https://api.armsoft.am/trade/v1/directories/barcodes/1001' \
-H 'accept: text/plain' \
-H 'Accept-Language: hy-AM' \
-H 'apiKey: %}uPbv>T0xZ}3beLxR{1' \
-H 'Content-Type: application/json' \
-d
{
"code": "9999999"
}'
Response body (200 OK)
{
"code": "9999999",
"itemId": 100000,
"itemCode": "1001",
"itemName": "Հեռուստացույց LED Panasonic TX-LR55ET5",
"unitMeasure": "001",
"unitMeasureAbbreviation": "հատ",
"weightItem": false
}
|
|
Օրինակ 4. Նշված կոդով ապրանքի կամ ծառայության գծիկավոր կոդի խմբագրում
PUT
|
Request
curl -X PUT \
'https://api.armsoft.am/trade/v1/directories/barcodes/1001' \
-H 'accept: text/plain' \
-H 'Accept-Language: hy-AM' \
-H 'apiKey: %}uPbv>T0xZ}3beLxR{1' \
-H 'Content-Type: application/json' \
-d{
"code": "1111",
"itemCode": "1001",
"unitMeasure": "002"
}'
Response body (200 OK)
{
"code": "1111",
"itemId": 100000,
"itemCode": "1001",
"itemName": "Հեռուստացույց LED Panasonic TX-LR55ET5",
"unitMeasure": "002",
"unitMeasureAbbreviation": "հատ",
"weightItem": false
}
|
|
Օրինակ 4. Նշված գծիկավոր կոդի հեռացում
DELETE
|
Request
curl -X DELETE \
'https://api.armsoft.am/trade/v1/directories/barcodes/1111' \
-H 'accept: */*' \
-H 'Accept-Language: hy-AM' \
-H 'apiKey: %}uPbv>T0xZ}3beLxR{1'
Response body (200 OK)
|
|