API-ի միջոցով հնարավոր է ստանալ (GET), ստեղծել (POST), թարմացնել (PUT) և հեռացնել (DELETE) ՆԱ խմբեր տեղեկատուն:
URI
|
https://api.armsoft.am/accountant/v1/directories/materialsgroups
|
Տվյալ ռեսուրսի համար պահանջվում է ավտորիզացիա՝ API բանալու օգտագործմամբ։ Այն անհրաժեշտ է տեղադրել հարցման գլխագրի apiKey դաշտում. API բանալին ստանալու համար անհրաժեշտ է կատարել API գաղտնի բանալու ստացում էջում նկարագրված քայլերը:
ՆԱ խմբեր օբյեկտի դաշտերը
Անվանում
|
Տեսակ
|
Կիրառումը
|
Նկարագրություն
|
code
|
String(5)
|
*Required
|
ՆԱ խմբի կոդ։ Արժեք չտալու դեպքում համակարգի կողմից ավտոմատ գեներացվում է հաջորդական կոդ։
|
name
|
String(50)
|
*Required
|
ՆԱ խմբի անվանում։
|
parent
|
String(5)
|
Optional
Reference type
|
Կուտակիչ խմբի կոդ։
|
path
|
String()
|
System defined
|
Ապրանքային խմբի անվանումը, որի մեջ մտնում է տվյալ ենթախումբը։
|
Օրինակ 1. ՆԱ խմբի ավելացում
POST
|
Request
curl -X 'POST' \
'https://api.armsoft.am/accountant/v1/directories/materialsgroups' \
-H 'accept: text/plain' \
-H 'Accept-Language: hy-AM' \
-H 'apiKey: N03S=AI8*vE]vkhplZYD' \
-H 'Content-Type: application/json' \
-d '{
"name": "գրենական պիտույքներ"
}'
Response body (200 Created)
{
"code": "00002",
"name": "գրենական պիտույքներ",
"parent": "",
"path": "00002"
}
|
|
Օրինակ 2. ՆԱ խմբերի ցուցակի ստացում
GET
|
Request
curl -X 'GET' \
'https://api.armsoft.am/accountant/v1/directories/materialsgroups \
-H 'accept: */*' \
-H 'Accept-Language: hy-AM' \
-H 'apiKey: N03S=AI8*vE]vkhplZYD'
Response body (200 OK)
[
{
"code": "00001",
"name": "string",
"parent": "",
"path": "00001"
},
{
"code": "00002",
"name": "գրենական պիտույքներ",
"parent": "",
"path": "00002"
},
{
"code": "10",
"name": "Ապրանք",
"parent": "",
"path": "10 "
},
{
"code": "20",
"name": "Արտադրանք",
"parent": "",
"path": "20 "
},
{
"code": "30",
"name": "Արտադրական նյութեր",
"parent": "",
"path": "30 "
},
{
"code": "40",
"name": "Արագամաշ առարկաներ",
"parent": "",
"path": "40 "
}
]
|
|
Օրինակ 3. Նշված կոդով ՆԱ խմբի տվյալների ստացում
GET
|
Request
curl -X 'GET' \
'https://api.armsoft.am/accountant/v1/directories/materialsgroups/00002' \
-H 'accept: */*' \
-H 'Accept-Language: hy-AM' \
-H 'apiKey: N03S=AI8*vE]vkhplZYD'
Response body (200 OK)
{
"code": "00002",
"name": "գրենական պիտույքներ",
"parent": "",
"path": "00002"
}
|
|
Օրինակ 4. Նշված կոդով ՆԱ խմբի տվյալների խմբագրում
PUT
|
Request
curl -X 'PUT' \
'https://api.armsoft.am/accountant/v1/directories/materialsgroups/00001' \
-H 'accept: text/plain' \
-H 'Accept-Language: hy-AM' \
-H 'apiKey: N03S=AI8*vE]vkhplZYD' \
-H 'Content-Type: application/json' \
-d '{
"code": "50",
"name": "տնտեսական ապրանքներ",
"parent": "10"
}'
Response body (200 OK)
{
"code": "00001",
"name": "տնտեսական ապրանքներ",
"parent": "10",
"path": "10 !00001"
}
|
|
Օրինակ 5. Նշված կոդով ՆԱ խմբի տվյալների հեռացում
DELETE
|
Request
curl -X 'DELETE' \
'https://api.armsoft.am/accountant/v1/directories/materialsgroups/000001' \
-H 'accept: */*' \
-H 'Accept-Language: hy-AM' \
-H 'apiKey: N03S=AI8*vE]vkhplZYD'
Response body (200 OK)
|
|