Компания API-і
Өз бағдарламаңызға, сайтқа, колл-орталыққа немесе 1С-ке HTTPS арқылы JSON: номенклатура, қалдықтар, контрагенттер, шоттар мен актілер, объектілер, өтінімдер. Бөлек ақы жоқ: компанияның жазылымы әрекет етіп тұрғанда жұмыс істейді.
Кілт және құқықтар
- Компания әкімшісі: «Баптаулар → API және интеграциялар» → «Кілт шығару».
- Кілтке ат қойыңыз («1С Бухгалтерия», «Сайт») және құқықтарды белгілеңіз — тек бағдарламаға керегін.
- Кілт бір рет көрсетіледі; шығарылған кілттің құқықтары өзгермейді — басқасы керек болса, жаңасын шығарыңыз.
| Құқық | Нені ашады |
|---|---|
katalog |
номенклатура — оқу |
ostatki |
қойма қалдықтары — оқу |
kontragenty |
контрагенттер — оқу |
kontragenty.zapis |
контрагенттер — БСН бойынша енгізу және түзету |
dokumenty |
тапсырыс берушілерге шоттар және қол қойылған актілер — оқу |
obyekty |
объектілер — оқу |
zayavki.zapis |
өтінімдер — енгізу (сайттан, колл-орталықтан) |
dengi |
бағалар мен сомалар; онсыз жауаптарда ақша өрістері жоқ |
Сұраулар
Мекенжай: https://none.kz/api/kompaniya/v1/…, тақырып Authorization: Bearer none_api_….
| Сұрау | Құқық | Не береді |
|---|---|---|
GET /katalog |
katalog |
позициялар: id, атауы, артикул, өлшем бірлігі, НКТ коды, қызмет; dengi-мен — бағалар |
GET /ostatki |
ostatki |
қоймалар және позициялар қалдығы |
GET /kontragenty |
kontragenty |
контрагенттер: атауы, БСН/ЖСН, мекенжай, телефон, банк, рөлдер |
POST /kontragenty |
kontragenty.zapis |
БСН бойынша енгізу немесе жаңарту: {"bin", "nazvanie", "adres", "telefon", "email", "bank"} |
GET /scheta |
dokumenty |
тапсырыс берушілерге шоттар; dengi-мен — сомалар және ҚҚС |
GET /akty |
dokumenty |
орындалған жұмыстардың қол қойылған актілері; dengi-мен — сомалар |
GET /obyekty |
obyekty |
объектілер: атауы, мекенжайы, мәртебесі |
POST /zayavki |
zayavki.zapis |
жаңа өтінім: {"tema", "opisanie", "adres", "telefon"} |
Тізімдер — 500-ден беттермен: жауаптағы dalshe — жалғастыратын id (?posle_id=); null — әрі
қарай жоқ. ?izmeneno_posle=2026-10-12T00:00:00 — тек өзгергені: бәрін емес, жаңасын алыңыз.
Жауаптар мен қателер
| Код | Мағынасы |
|---|---|
200, 201 |
дайын |
401 |
кілт табылмады немесе кері қайтарылды |
402 |
компания жазылымы аяқталды |
403 |
кілтке бұл сұрауға құқық берілмеген |
422 |
сұрау қате — денесінде нақты не екені |
429 |
бір кілтке минутына 120-дан көп шақыру |
Қате — {"ok": false, "oshibka": "…"}, сөзбен, орыс тілінде.
Қауіпсіздік
- Тек өз компанияңыздың деректері: кілт басқаларды жауаптарда да, қателерде де көрмейді.
- Әр шақыру — компания журналында («Баптаулар → API және интеграциялар»): кілт, сұрау, нәтиже, мекенжай; 90 күн сақталады. Сұраулардың денесі журналға жазылмайды.
- Кілт бір батырмамен кері қайтарылады — онымен жұмыс істейтін бағдарлама бірден тоқтайды.
- API қызметкерлердің құпиясөздерін қабылдамайды және бермейді.
Неге құқықтар тар, «бәрі бірден» емес
Бухгалтерия бағдарламасына өтінімдер, ал сайтқа актілердің сомасы керек емес. Артық құқықты кілт — жылыстаған кезде артық зиян. Сондықтан әр құқық бөлек белгіленеді, ал ақша — қалғанынан бөлек.
Мысал
Колл-орталық өз бағдарламасынан өтінім енгізеді:
POST https://none.kz/api/kompaniya/v1/zayavki
Authorization: Bearer none_api_…
{"tema": "Шатыр ағып тұр", "adres": "Алматы қ., Абай к-сі, 10, 5-пәтер", "telefon": "+7 701 000 00 00"}
Жауап — {"ok": true, "id": 812, "nomer": "З-2026-0412"}: өтінім диспетчердің кабинетінде тұр.
Мұнда жоқ сұрау керек болса — қолдау қызметіне жазыңыз: API клиенттердің өтінімдері бойынша өседі.