1С үшін API: REST, HTTP-сервистер және OData
1С-ті сайттарға, мобильді қосымшаларға, боттарға және серіктестерге қолжетімді етеміз. 1С ішіндегі HTTP-сервистердегі REST API немесе стандартты OData интерфейсі, JSON алмасу, авторизациясы, журналы және құжаттамасы бар.
- Шикі кестелер емес, сіздің сценарийлеріңізге арналған JSON-дағы 1С REST API
- Каталог пен қалдықтарды жылдам оқуға арналған стандартты OData
- Авторизация, қолжетімділік шектеулері және сұраулар журналы
- Сыртқы жүйе әзірлеушілеріне арналған құжаттама
HTTP-сервистердегі 1С үшін API 350 000 теңгеден басталады және екі-үш аптаны алады. Кэші, кезегі және жүктемені шектеуі бар нұсқа төрт аптадан басталады.
1С-ке API не үшін керек
1С деректеріне басқа жүйелер жүгінуі және мұны сенімді жасауы керек болғанда.
1С ең маңыздысын сақтайды: тауарлар, бағалар, қалдықтар, клиенттер, тапсырыстар, қарыздар. Ерте ме, кеш пе бұл деректер сыртта керек болады. Сайтқа каталог, сауда өкілінің мобильді қосымшасына клиенттің қалдықтары мен бағалары, Telegram-ботқа тапсырыс мәртебесі, серіктеске өз форматындағы прайс керек.
API-сіз әдеттегі көрініс: менеджер күніне бір рет қалдықтары бар Excel-ді түсіріп, серіктестерге жібереді, сайт түнгі файлмен жаңартылады, ал мобильді қосымша кешегі деректерді көрсетеді. Әр арна өз кешігуімен өмір сүреді.
API-сіз алмасу файлдарды түсіруге, қолмен жасалатын есептерге немесе әр жаңартуда бұзылатын дерекқорға тікелей қолжетімділікке құрылады. 1С үшін API алмасуды болжамды етеді: сыртқы жүйе сұрау жіберіп, түсінікті JSON форматында жауап алады, ал қолжетімділік ережелері мен тексерістер 1С ішінде қалады.
API пайдасына тағы бір дәлел: өзгерістердің жылдамдығы. Жаңа қосымша немесе жаңа серіктес пайда болғанда, оны тағы бір бөлек алмасу құрмай, жұмыс істеп тұрған API-ге қосады. Бір жылдан кейін компанияда ешкім есіне алмайтын бес түрлі түсіру емес, журналы мен құқықтары бар 1С-ке бір түсінікті кіріс болады.
Жақсы API жылдар бойы өмір сүреді. Конфигурация жаңартылады, ішкі кестелер өзгереді, ал сыртқы келісімшарт бұрынғыдай қалады, қосымшаға ештеңені қайта жасаудың қажеті жоқ.
1С деректерін ашудың үш тәсілі
Таңдау міндетке байланысты: оқу, жазу немесе екеуі де.
| Тәсіл | Қашан лайық | Мерзімі мен бағасы |
|---|---|---|
| Стандартты OData интерфейсі | каталогты, қалдықтарды, анықтамалықтарды жылдам оқу | 2-3 апта, 350 000 ₸-ден |
| HTTP-сервис (JSON-дағы REST API) | екі жақты алмасу, өз логикасы, қосымшалар | 2-3 апта, 350 000 ₸-ден |
| Кэші мен кезегі бар HTTP-сервис | жоғары жүктеме, көп клиент, лездік оқиғалар | 4 аптадан |
| SOAP веб-сервисі | серіктес немесе мемлекеттік жүйе SOAP талап етеді | бағалау бойынша |
Кейде кері жол бөлек керек: 1С өзі сыртқы жүйеге оқиға туралы хабарлайды. Мысалы, тапсырыс жөнелтілді немесе төлем түсті. Онда 1С құжат өткізілгеннен кейін бірден сыртқы жүйенің мекенжайын шақырады, ал қосымша оқиға туралы келесі сұраудан емес, секундтарда біледі.
Көп міндеттер үшін HTTP-сервисті ұсынамыз: сыртқы жүйеге конфигурацияның ішкі құрылымын білудің қажеті жоқ, ал тексерістер логикасы 1С-те қалады. OData оқуға жылдам бастау керек жерде жақсы. Екі тәсілді мысалдармен салыстыру OData немесе HTTP-сервистер мақаласында.
1С HTTP-сервистеріндегі REST API
Қосымшалар, сайттар және боттар үшін негізгі тәсіл.
HTTP-сервис дегеніміз кәдімгі HTTP-сұрауларды қабылдап, JSON-да жауап беретін 1С конфигурациясының объектісі. Біз оны база құрылымына емес, сіздің сценарийлеріңізге жобалаймыз. Мысалы, қалдықтардың бүкіл кестесін берудің орнына қосымша «Астанадағы қоймада осы санаттағы тауарлардың қалдықтары» деп сұрап, қысқа жауап алады.
Сауда компаниясына арналған 1С REST API әдістерінің әдеттегі жиынтығы:
- сипаттамалары бар каталог және соңғы сұраудан бергі өзгерістер;
- клиенттің баға түрі бойынша бағалар және қоймалар бойынша қалдықтар;
- баға, қалдық және қарыз лимитін тексерумен тапсырыс құру;
- тапсырыстың, жөнелтімнің және төлемнің мәртебесі;
- клиент карточкасы: қарыз, бонустар, сатып алу тарихы.
Ондаған мың позициядан асатын каталогтар үшін беттеп беруді және өзгерістерді іріктеуді қосамыз: қосымша әр сұрауда бүкіл каталогты емес, тек өткен жолдан бергі өзгергенін алады. Бұл трафик пен серверге жүктемені ондаған есе азайтады.
HTTP-сервисті конфигурация кеңейтуіне қосамыз, сондықтан типтік қолдауда қалады. Жариялау сізде бұрыннан тұрған немесе біз баптайтын веб-сервер арқылы жүреді.
1С-тегі стандартты OData интерфейсі
Деректерді жылдам оқуға арналған платформаның дайын механизмі.
1С-тегі стандартты OData интерфейсі баяғыда пайда болған және 8.3 платформасындағы барлық заманауи конфигурацияларда қолдау табады. Көптеген оқу міндеттері үшін бұл база ішінде бір жол кодсыз 1С REST API алудың ең жылдам тәсілі.
1С:Предприятие 8.3 платформасы конфигурация объектілерін OData хаттамасы бойынша автоматты түрде жариялай алады. Ол үшін 1С-те код жазудың қажеті жоқ: объектілер құрамын таңдап, базаны веб-серверде жариялау жеткілікті. Сыртқы жүйе бірден анықтамалықтарды, құжаттар мен регистрлерді оқи алады.
OData шектеулерін алдын ала түсіну маңызды. Сыртқы жүйе 1С объектілерінің ішкі атауларымен жұмыс істейді, сондықтан конфигурация өзгергенде оның сұраулары бұзылуы мүмкін. OData арқылы жазу бизнес-логиканың бір бөлігін айналып өтеді, сондықтан құжаттар құру үшін біз оны қолданбаймыз. Үлкен көлемдерде OData серверді арнайы жобаланған әдістен көбірек жүктейді.
OData сұраулары стандартты түрде жазылады: сүзгілер, өрістерді таңдау, сұрыптау, беттеп беру. Көптеген дайын талдау құралдары мен интеграциялық платформалар OData-мен тікелей жұмыс істей алады, бұл оны оқуға қолданудың тағы бір себебі.
Тәжірибедегі жақсы схема: бастапқыда каталог пен қалдықтарды оқу үшін OData, тапсырыстарды жазу және өсетін барлық нәрсе үшін HTTP-сервис.
Қауіпсіздік және жүктеме
API есепке қолжетімділік ашады. Демек, оны қорғау керек.
- Ең аз құқықтары бар бөлек пайдаланушы. API тек өзіне керекті көреді және, мысалы, бағаларды өзгерте алмайды.
- Токен немесе логин бойынша авторизация. Әр сыртқы жүйе бөлек өшіруге болатын өз қолжетімділігін алады.
- HTTPS. 1С пен сыртқы жүйе арасындағы деректер шифрланған түрде беріледі.
- Сұраулар журналы. Кім, қашан және не сұрады, қандай қатемен. Бұл кез келген ақау кезінде алдымен қарайтын жер.
- Жиілікті шектеу. Сыртқы жүйе 1С-ті сұраулармен басып, бухгалтерия жұмысын тежей алмайды.
- Жиі сұрауларға кэш. Каталог пен қалдықтар әр жүгінгенде қайта есептелмей, кэштен беріледі.
Деректерді өзгертетін сұраулар үшін, мысалы тапсырыс құру, қайталаудан қорғау қосамыз. Егер байланыс үзіліп, қосымша тапсырысты екі рет жіберсе, 1С оны бір рет құрады. Онсыз сауда өкілінің интернеті нашар болған сайын тапсырыс қайталанулары пайда болады.
Мыңдаған пайдаланушысы бар мобильді қосымшалар үшін аралық қабат қоямыз: қосымша соған жүгінеді, ал ол бірнеше минутта бір рет 1С-пен синхрондалады. Сонда 1С-ке жүктеме пайдаланушылар санына тәуелді болмайды.
1С үшін API-ді қалай әзірлейміз
Сценарийлерден әдістерге, әдістерден құжаттамаға.
- Сценарийлер. Сыртқы жүйе не істейді: каталогты көрсетеді, тапсырыс құрады, қарызды тексереді. Сценарийлерден әдістер тізімін аламыз.
- Келісімшарт. JSON-дағы сұраулар мен жауаптар форматы, қате кодтары. Код басталғанға дейін сыртқы жүйе әзірлеушілерімен келісеміз.
- Әзірлеу. Базаның көшірмесіндегі кеңейтуде тексерістері мен журналы бар HTTP-сервис.
- Сынақ стенді. Сыртқы жүйе көшірмеге қосылып, барлық сценарийлерді нақты деректерде тексереді.
- Жариялау. Веб-серверді, HTTPS-ті, құқықтарды, шектеулерді баптау.
- Құжаттама. Кез келген әзірлеуші бізсіз қосыла алуы үшін сұраулар мен жауаптардың мысалдары бар әдістер сипаттамасы.
Нұсқалауды бірінші күннен саламыз. Жауап форматын өзгерту керек болғанда әдістің жаңа нұсқасы пайда болады, ал ескісі барлық сыртқы жүйелер көшкенше жұмыс істей береді. Осылайша API жаңартуы жұмыс істеп тұрған қосымшаларды тоқтатпайды.
Бір міндетке арналған API-дің бүкіл жолы әдетте 2-3 аптаны алады, оның бір аптасы сыртқы жүйе әзірлеушілерімен бірге тестілеуге кетеді.
Егер сыртқы жүйені де біз жасасақ, мысалы сайт немесе мобильді қосымша, келісімшартты екі жаққа бір рет жобалаймыз.
API қандай міндеттерге керек
Қазақстан компанияларындағы ең жиі сценарийлер.
Сауда өкілдеріне арналған мобильді қосымша. Каталог, клиент бағалары, қалдықтар, қарызды тексерумен тапсырыс құру. Қосымшаның өзін біздің Applications.kz командамыз жасайды, 1С жағындағы API-ді біз жасаймыз.
Сайт және B2B-клиенттің жеке кабинеті. Клиент өз бағаларын, қалдықтарды, тапсырыстар тарихын, салыстыру актілері мен қарызын көреді. Толығырақ 1С-тің сайтпен интеграциясы бетінде.
Telegram-бот және хабарламалар. Бот 1С-тен тапсырыс мәртебесін немесе қалдықты сұрайды, ал 1С оқиғалар туралы хабарламаларды өзі жібереді.
Қойма және ТСД. Деректер жинау терминалдары мен қойма қосымшалары жинауға тапсырмалар алып, нәтижелерді файлдарсыз және қолмен көшірусіз 1С-ке жібереді. Толығырақ қойманы автоматтандыру бетінде.
Серіктестер мен жеткізушілер. Дилер поштамен файл күтпей, прайс пен қалдықтарды автоматты түрде алады.
Талдау және дашбордтар. 1С деректері BI-жүйеге немесе өз дашбордыңызға кетеді. Бұл туралы 1С үшін есептер бетінде.
1С үшін API қанша тұрады
Баға әдістер санына, жүктемеге және базаның күйіне байланысты.
| Жұмыс | Мерзімі | Құны |
|---|---|---|
| Оқуға арналған OData жариялау | 2-3 апта | 350 000 ₸-ден |
| Бір міндетке арналған HTTP-сервис | 2-3 апта | 350 000 ₸-ден |
| Кэші, лимиттері және журналы бар REST API | 4 аптадан | бағалау бойынша |
| Кезегі мен оқиғалары бар алмасу | 6-10 апта | 1 500 000-3 000 000 ₸ |
| API-ді қолдау | ай сайын | 80 000 ₸/ай-дан |
Жұмысты кезеңдерге бөлген ыңғайлы: алдымен сыртқы жүйе жұмыс істей алатын оқу әдістері, содан кейін тапсырыстарды жазу және оқиғалар. Әр кезеңді келесісінің төлеміне дейін сынақ стендінде қабылдайсыз.
Құжаттама мен сынақ стенді құнға кіреді. Базада сипаттамасыз типтікке ескі түзетулер көп болса, қымбатырақ шығады: талдауға уақыт керек. Сыртқы жүйені де біз жасасақ және келісімшартты үшінші тараппен келісудің қажеті болмаса, арзанырақ.
1С деректерін ашудағы жиі қателер
Бөтен интеграциялардан кейін нені жөндейміз.
Бұл қателердің көбі немқұрайдылықтан емес, асығыстықтан пайда болады: API кеше керек, және оны бүгін жұмыс істейтіндей жасайды. Жарты жылдан кейін үнем сатылымдардың тоқтауына айналады.
- SQL базасына тікелей қолжетімділік. Сыртқы жүйе кестелерді тікелей оқиды. Бірінші жаңартуға дейін жұмыс істейді, содан кейін ескертусіз бұзылады.
- Толық құқықтары бар API пайдаланушысы. Қосымшадағы қате есеп деректерін өзгертуі немесе жоюы мүмкін.
- OData арқылы құжаттарды жазу. Құжат тексерістерді айналып өтіп құрылады, кейін бухгалтерия оның қайдан келгенін анықтайды.
- Журнал жоқ. Ақау кезінде сайт тапсырысты жіберді ме және 1С не жауап берді, соны түсіну мүмкін емес.
- Құжаттама жоқ. API жасаған әзірлеуші кетті, қандай әдістер бар және оларды қалай шақыру керектігін ешкім білмейді.
Неге біз
Алмасуды екі жағынан көреміз және сізге құжаттаманы қалдырамыз.
Біз 1С-ті бағдарламалаймыз және сайттарды, қосымшалар мен боттарды әзірлейміз. Сондықтан API-ді тек жұмыс істеуі үшін емес, қолдануға ыңғайлы болуы үшін жобалаймыз. Келісімшарт, құжаттама, сынақ стенді және журнал әдепкі бойынша жұмысқа кіреді.
Бүкіл Қазақстанмен қашықтан жұмыс істейміз. Базаның көшірмесіне сіз бақылайтын қолжетімділік арқылы қосыламыз, жұмыс серверіндегі жариялауды қызметкерлерге кедергі келтірмеу үшін келісілген уақытта жасаймыз.
Кодты кеңейтуде жасаймыз, типтік конфигурация штаттық түрде жаңартылады. Бастапқы кодтар мен құжаттаманы сізге береміз. Өз 1С бағдарламашыңыз немесе сыртқы әзірлеушіңіз болса, ол бізсіз жалғастырады. 1С-тің өзінде логиканы пысықтау керек болса, оларды API жазатын сол 1С бағдарламашысы жасайды.
1С үшін API туралы жиі қойылатын сұрақтар
REST API, OData және қауіпсіздік туралы.
1С-те дайын REST API бар ма?
Платформа стандартты OData интерфейсін жариялай алады, бұл оқуға арналған дайын REST. Жазу және өз логикасы үшін JSON-да жауап беретін HTTP-сервис жасаймыз.
1С үшін API әзірлеу қанша тұрады?
Бір міндетке арналған HTTP-сервис немесе OData жариялау үшін 350 000 ₸-ден, мерзімі 2-3 апта. Кэші, лимиттері мен журналы бар API 4 аптадан.
Не жақсы: OData ма, әлде HTTP-сервис пе?
OData-ны оқу үшін тезірек іске қосуға болады. HTTP-сервис жаңартулар кезінде тұрақтырақ және жазу үшін қауіпсізірек, себебі тексерістер 1С-те қалады.
API 1С жұмысын тежемей ме?
Жоқ, егер сұраулар жиілігін шектеп, жиі жауаптарды кэштесе. Мыңдаған пайдаланушысы бар қосымшалар үшін аралық қабат қоямыз.
1С API-і үшін веб-сервер керек пе?
Иә, HTTP-сервистер мен OData Apache немесе IIS веб-сервері арқылы жарияланады. Егер ол әлі болмаса, HTTPS-пен бірге баптаймыз.
1С жаңартылғаннан кейін API бұзыла ма?
Кеңейтудегі HTTP-сервис типтіктің жаңартуларынан аман өтеді. 1С ішінде бірдеңе өзгерсе де, сыртқы жүйеге арналған келісімшарт бұрынғыдай қалады.
API 1С-тің файлдық базасымен жұмыс істей ме?
Техникалық тұрғыдан иә, бірақ тұрақты жүктеме үшін клиент-серверлік нұсқаны ұсынамыз. Серверді таңдауға көмектесеміз.
API-ге құжаттама бересіздер ме?
Иә, әрқашан: әдістер сипаттамасы, сұраулар мен жауаптардың мысалдары, қате кодтары. Оған қоса базаның көшірмесіндегі сынақ стенді.
1С бойынша басқа қызметтер
Әдетте бірге шешілетін іргелес міндеттер.
1С интеграциясы
Сайтпен, CRM-мен, банкпен және алаңдармен алмасу.
1С және Kaspi
Бағалар мен қалдықтар Kaspi-ге, тапсырыстар 1С-ке қайта.
1С бағдарламашысы
Әр міндеттің бағасы бар тапсырыс бойынша 1С әзірлеу.
Есептер мен дашбордтар
1С ішінде және сыртында 1С деректері бойынша талдау.
1С үшін сервер
Қазақстандағы серверде клиент-серверлік 1С.
Өтінім қалдыру
Міндетті сипаттаңыз: жұмыс күні ішінде жауап береміз, бағаны жұмыс басталғанға дейін айтамыз.