API компании
JSON по HTTPS для своей программы, сайта, колл-центра или 1С: номенклатура, остатки, контрагенты, счета и акты, объекты, заявки. Отдельной платы нет: работает, пока у компании действует подписка.
Ключ и права
- Администратор компании: «Настройки → 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 растёт по заявкам клиентов.