A8PRO CR · Local API · Windows
A8PRO CR жүйесін бағдарламаңызға қосыңыз
Үйлесімді картридер немесе паспорт сканері арқылы құжаттарды жергілікті оқу. Мұнда қосылу тәртібі, API командалары және әзірлеуші жинағы берілген.
Орыс тіліндегі техникалық нұсқаулық, OpenAPI, Postman, 1С үлгісі және жасанды JSON мысалдары. Орнатқыш пен кілттер жоқ.
1.1.30.0 Universal R4 шығарылымының келісімшарты. Енгізер алдында бағдарлама нұсқасын, драйверді және құрылғыны тексеріңіз. Сақталған бастапқы код пен пакет сәйкестігі тексерілді; нақты құрылғы мен 1С конфигурациясы бөлек сынақтан өтеді.
Жұмыс орнын дайындаңыз
- A8PRO CR шығарылымын, Windows нұсқасын, драйверді, құрылғыны және құжат түрлерін келісіңіз.
- Орнатқышты A8PRO-дан алыңыз. Жаңарту алдында қолданбаны трей мәзірінен жабыңыз, сол Windows пайдаланушысын қолданыңыз; алдыңғы орнатуды алдын ала жоймаңыз.
- Лицензияны, CHIP/MRZ рұқсаттарын және 9010 портындағы жергілікті қызметті тексеріңіз.
- Қолданба ортасында A8PRO_API_TOKEN орнатыңыз: кемінде 32 таңбалық кездейсоқ құпия. Оны X-A8PRO-Token тақырыбында жіберіңіз. Қолданба мәнді іске қосылғанда оқиды.
Сұрау оқу құрылғысы бар компьютерде орындалады
Негізгі мекенжай: http://localhost:9010. Жаңа қосылымдарда /v2/ пайдаланыңыз. Орнатылған 1С клиенті осы мекенжайға жұмыс компьютерінде жүгінеді. 1С серверінен сұрау оператор компьютеріне емес, сервердің өзіне келеді. Браузердегі CRM және терминалдық орта үшін архитектураны бөлек келісеміз; кез келген сайттан тікелей қатынауға шектеу бар.
http://localhost:9010X-A8PRO-Token: <local-secret>
Төрт API командасы
GET /v2/status
CHIP бар-жоғын және функция рұқсаттарын тексеру. 200 жауабы MRZ құрылғысының дайындығын дәлелдемейді.
GET /v2/getInfo
Жаңа оқу. 200 жауабында өрістер немесе status=waiting болады. Тақырыптағы scanId мәнін сақтаңыз.
GET /v2/getInfo/last
Соңғы нәтиже: scanId / scannedAt / source / data. 204 — нәтиже жоқ.
POST /v2/getInfo/ack?scanId=…
Қабылданған нәтижені жергілікті кэштен жою. Сәтті жауап — денесіз 204; қайталау 404 қайтаруы мүмкін.
Алыңыз, тексеріңіз, сақтаңыз — содан кейін растаңыз
- Оператор әрекетімен бір оқуды бастаңыз. CHIP басым; карта жоқ және функция рұқсат етілген кезде MRZ қолданылады.
- Өрістерді тексеруге көрсетіңіз. HTTP 200 және status=waiting — дайын нәтиже емес, күту күйі.
- Бір scanId бойынша қайталанған жазбаны болдырмай, деректерді бағдарламаңызда сақтаңыз.
- Сақтау расталғаннан кейін ғана сол scanId үшін ACK жіберіңіз. Нәтижені экранда көрсету сақтау болып саналмайды.
Жергілікті серверде тек бір соңғы нәтиже бар. Жаңа оқу оны ауыстырады. /last қолжетімділігі — 2 минут, мерзім сұрау кезінде тексеріледі; бұл жадты дәл уақытында өшіру таймері емес. Белгілі scanId сәйкестігін тексермей, /last нәтижесін жаңа клиентке қоймаңыз. /getInfo қайталау жаңа оқуды бастайды.
Өрістер мен пішімдер
Аты-жөні: lname, fname, sname; құжат: docType, docnum; ЖСН: iin; берген орган: issuer; күндер: bdate, valid_from, valid_to; азаматтық: citizen; берген ел: issuecountry; жынысы: sex; туған жері: bplace; ұлты: nation; MRZ есімдері: mrzln, mrzfn. Мәндер жол түрінде беріледі, бос болуы мүмкін. Күндер әдетте КК.АА.ЖЖЖЖ пішімінде, тексеру қажет. Тексерілген шығарылымда photo және sig_photo бос. Өріс атаулары QRScan атауларынан өзгеше.
Күту мен қателерді өңдеңіз
JSON алдында HTTP кодын тексеріңіз: 204 денесіз болады. 401 — токен; 403 — лицензия немесе жергілікті қатынау; 429 — бос емес; 503 — уақыт шегі, құрылғы немесе тоқтау; 500 — ішкі қате. Қате денесі бос болуы мүмкін. Оқу шегі 10 секунд; клиентке, мысалы, 15 секунд беріңіз. Қатарлас қайталауларды іске қоспаңыз.
Әзірлеуші материалдары
1С үлгісі Windows-та орнатылған клиентке арналған және конфигурацияңызға бейімдеуді қажет етеді. Ол анықтамалықтарға жазбайды және ACK-ті автоматты жібермейді. Нақты 1С базасында және құрылғымен іске қосылмаған.
Жұмыс орындарына енгізер алдында
- CHIP пен MRZ үшін құжаттарды, өрістерді, күндерді және кодтауды бөлек тексеріңіз.
- Күтуді, жауаптың жоғалуын, бос емес күйді, құрылғының ажырауын және лицензия шектеулерін тексеріңіз.
- ACK-ке дейін сақтауды, ACK қайталауын және алдыңғы клиенттің деректерін қолданудан қорғауды тексеріңіз.
- Нұсқаны, құрылғыны, қабылдаушы жүйені және пилот нәтижелерін тіркеңіз.
Бағдарламаңызды, клиенттің орындалу орнын, Windows нұсқасын және құрылғы моделін көрсетіңіз. Таңдалған шығарылымның интерфейсі мен шешім құрамын келісеміз.