Сұраулардың мынадай түрлері іске асырылды:
1. БСН немесе ЖСН бойынша заңды тұлға немесе дара кәсіпкер бойынша деректерді алу
GET
https://old.stat.gov.kz/api/juridical/counter/api/?bin={BIN}&lang={LANG}
Bin және Lang – толтыру үшін міндетті парамертлер
Онда:
{BIN} = заңды тұлғаның немесе дара кәсіпкердің БСН/ЖСН-ін;
{LANG} = сұралған деректердің тілін көрсету керек
Параметр мәні {LANG} = ru/kk/en
Жауап JSON форматында қайтарылады
{
"description": "string",
"obj": {},
"success": true
}
Сұрадың мысалы
https://old.stat.gov.kz/api/juridical/counter/api/?bin=012345678910&lang=kk
БСН бойынша жауаптың мысалы:
{"success":true,"obj":
{"bin":" БСН ",
"name":"Атауы"",
"registerDate":"Тіркелген күні",
"okedCode":" ЭҚЖЖ негізгі коды",
"okedName":" Экономикалық қызмет түрінің атауы ",
"secondOkeds":" Қосалқы ЭҚЖЖ коды",
"krpCode":" КМЖ коды (филиалдарды ескере отырып)",
"krpName":" КМЖ атауы",
"krpBfCode":" КМЖ коды (филиалдарды ескерусіз)",
"krpBfName":" КМЖ атауы",
"katoCode":" ӘАОЖ","katoId":null,
"katoAddress":" Заңды мекенжайы",
"fio":" Басшының тегі, аты, әкесінің аты",
"ip":false},
"description":null}
ЖСН бойынша жауаптың мысалы:
{"success":true,
"obj":{"bin":"ЖСН",
"name":" Атауы ",
"okedCode":" ЭҚЖЖ негізгі коды ",
"okedName":" Негізгі қызмет түрінің атауы",
"secondOkeds":" Қосалқы ЭҚЖЖ коды ",
"krpCode":" КМЖ коды (филиалдарды ескере отырып)",
"krpName":" КМЖ атауы",
"katoCode":" ӘАОЖ ",
"katoAddress":" ЖК тұрған жері ",
"fio":" Басшының тегі, аты, әкесінің аты ",
"ip":true},
"description":null}
2. Берілген параметрлер бойынша заңды тұлға немесе дара кәсіпкер бойынша деректер алу
2.1 Кесінділер тізімін алу
GET
https://old.stat.gov.kz/api/rcut/kk
Жауап JSON форматында қайтарылады
{
"description": "string",
"obj": {},
"success": true
}
Мысал
[{"id":618,"name":"01.01.2020 жылға"},{"id":615,"name":"01.12.2019 жылға"},
{"id":612,"name":"01.11.2019 жылға"},{"id":609,"name":"01.10.2019 жылға"},
{"id":606,"name":"01.09.2019 жылға"},{"id":603,"name":"01.08.2019 жылға"},
{"id":600,"name":"01.07.2019 жылға"},{"id":597,"name":"01.06.2019 жылға"},
{"id":594,"name":"01.05.2019 жылға"},{"id":591,"name":"01.04.2019 жылға"},
{"id":587,"name":"01.03.2019 жылға"},{"id":585,"name":"01.02.2019 жылға"},
{"id":580,"name":"01.01.2019 жылға"},{"id":577,"name":"01.12.2018 жылға"},
{"id":574,"name":"01.11.2018 жылға"},{"id":571,"name":"01.10.2018 жылға"},
{"id":567,"name":"01.09.2018 жылға"},{"id":564,"name":"01.08.2018 жылға"},
{"id":561,"name":"01.07.2018 жылға"},{"id":558,"name":"01.06.2018 жылға"},
{"id":555,"name":"01.05.2018 жылға"},{"id":552,"name":"01.04.2018 жылға"},
{"id":547,"name":"01.03.2018 жылға"},{"id":544,"name":"01.02.2018 жылға"}]
2.2 Іріктеуге сұрау жіберу және өтінім нөмірін алу
POST
https://old.stat.gov.kz/api/sbr/request/?api
Параметрлер:
{ "conditions": [ { "classVersionId": 0, "itemIds": [ 0 ] } ], "cutId": 0 }
Мұнда:
"classVersionId": 0 - 0 = анықтамалықтың ID-і.
"itemIds": [ 0 ] - [0] = элементінің ID-і.
Іріктеуге сұрау мысалы:
{conditions: [{classVersionId: 2153, itemIds: [742679]}], cutId: 615}
Мұнда
classVersionId":2153,"itemIds":[742679] = «Құқықтық бірлік типі» анықтамалығы, «Заңды тұлға» элементі; cutId: 615 = «01.12.2019 жылға» СБТ базасынан кесінді.
Немесе
{"conditions":
[{"classVersionId":2153,"itemIds":[742679]},
{"classVersionId":213,"itemIds":[247784]},
{"classVersionId":1989,"itemIds":[39354,39355,39356,39358,534829,39359]}],
"cutId":615}
Мұнда
classVersionId":2153,"itemIds":[742679] = «Құқықтық бірлік типі» анықтамалығы, «Заңды тұлға» элементі;
classVersionId":213,"itemIds":[247784] = «ӘАОЖ» анықтамалығы, «Көкшетау Қ.Ә.» элементі;
classVersionId":1989,"itemIds":[39354,39355,39356,39358,534829,39359] = «Ахуалдық кодтар» анықтамалығы,
«Тіркелген» тобы;
cutId: 615 = «01.12.2019 жылға» базадан кесінді.
Іріктеуге сұрау жіберілгеннен кейін (/api/sbr/request), деректер кетеді, серверден форматтағы номермен жауап келеді:
{success: true, obj: "2a1650ca-2ded-4903-9fb6-c4484f7db771", description: null}
Мұнда:
obj: "{NUMBER}" – өтінімді одан әрі тексеру үшін
2.3 Өтінімнің мәртебесін тексеру
GET
https://stat.gov.kz/api/sbr/requestResult/{NUMBER}/{LANG}
Мысалы:
https://stat.gov.kz/api/sbr/requestResult/2a1650ca-2ded-4903-9fb6-c4484f7db771/ru
Сұрау мәртебесін қайтару
{"success":true,"obj":
{"bucket":"SBR",
"fileGuid":"5df090b77d0b3f0001aa2785"},
"description":"Обработан"}
Мұнда:
"fileGuid":"{ GUID}"
2.4 zip-архив кесіндісін жүктеу
https://stat.gov.kz/api/sbr/download?bucket=SBR_UREQUEST&guid={GUID}
Мысалы:
https://stat.gov.kz/api/sbr/download?bucket=SBR_UREQUEST&guid=5df090b77d0b3f0001aa2785
нәтижесінде пайдаланушы архивтік файл алады.
3. Параметрлер бойынша сұрауды қалыптастыру үшін қосымша
classVersionId | Анықтамалық (сүзгі) атауы | Сілтеме |
2153 | Құқықтық бірлік типі | жүктеу |
213 | ӘАОЖ | жүктеу |
4855 | ЭҚЖЖ | жүктеу |
15 | КМЖ | жүктеу |
1989 | Ахуалдық кодтар | жүктеу |
17 | МНЖ | жүктеу |
996 | ҰҚНЖ | жүктеу |