 Yandex Forms

Yandex Forms (бұрынғы Яндекабрьс Формы) интеграциясы арқылы Yandex Forms формасын толтырғаннан кейін алынған мәліметтер негізінде DiMaker-де автоматты түрде сертификаттар, дипломдар және басқа да түрлі файлдарды жасауға мүмкіндік береді.

Бұл интеграция файлды жасау және оны электрондық пошта арқылы жіберу ғана емес, сонымен қатар пайдаланушыларға дайын файлды бірден жүктеп алуға да мүмкіндік береді.

Интеграцияны жасау

Yandex Forms-пен интеграциялар бетінде жаңа интеграция жасап, оны қосыңыз.

Әр жаңа формаға жеке интеграция жасауға болады, алайда интеграция параметрлері бірдей болса, бірнеше Yandex Forms формалары үшін бір интеграцияны қолдануға болады.

Yandex Forms-ті баптау

Yandex Forms-те "Интеграция" бөліміне өтіп, әрекеттер тобына тағы бір жаңа әрекет - API сұранысын қосыңыз. Бұл ретте пошта арқылы хат жіберу әрекеті қосулы немесе өшірулі күйінде қала алады.

Yandex Forms-де "Интеграция" бөлімі

API арқылы мәліметтерді жіберу әдісін таңдау мәзірінде "Әдіс арқылы сұраныс жіберу" опциясын таңдаңыз.

Yandex Forms-та мәліметтерді жіберу әдісін таңдау мәзірі

Сұраныс параметрлері терезесінде келесілерді көрсетіңіз:

• URL - https://gramotadel.express/api/v1/yandex-forms/
• Сұраныс әдісі - POST

  Yandex Forms-тағы URL және сұраныс әдісі

• Сұраныс денесі - файл жасау үшін қажетті мәліметтерді көрсетіңіз. Формат: параметр_аты=параметр_мәні. Әрбір параметрді жаңа жолдан жазыңыз.
• doc_id* - Файл жасау үшін қолданылатын құжаттың ID-і (36 таңбалық жол). Бұл ID құжат ашылған кезде браузердің мекенжай жолынан алынады. Құжат "Қоқыс себетінде" болмауы керек, бірақ "Құжаттар" қалтасындағы кез келген орында болуы мүмкін.
• mask_* - Анкета нәтижелерінен алынған мәліметтер, файл жасауда пайдаланылады. Әр параметр "mask_" префиксінен басталып, одан әрі DiMaker-дегі айнымалы атына сәйкес жазылады.

  Мысалы, mask_name дерегі %name айнымалысына сәйкес келеді, ал mask_score - %score дегенге. Электрондық пошта мекенжайын ескеру үшін mask_email параметрін, файл аты үшін mask_filename параметрін қолданыңыз. Құжаттағы барлық айнымалылар тек латын әріптерімен жазылуы керек.

  Параметрге тағайындалатын деректердің таңдау мәзірі.

  Мысалы, сұрақтың жауабын беру үшін "Сұрақ жауабы" опциясын таңдаңыз. Содан кейін терезеде қажет сұрақтың жауабын параметрге бекіту үшін таңдаңыз.

• mail_id - Электрондық пошта арқылы жіберілетін хаттың ID-і (36 таңбалық жол). Бұл ID шаблон ашылған кезде браузердің мекенжай жолынан алынады. Егер бұл параметр берілмесе, хат жіберілмейді.
• email_send - Файлды бар электрондық пошта арқылы қашан жіберу керектігін анықтайды. API интеграциясына қараңыз.
• folder_id - Дискідегі файлдарды сақтау қалтасының ID-і (36 таңбалық жол). Егер қалта болмаса, алғашқы файл жасалған кезде автоматты түрде құрылады.
• page_id - Егер құжатта бірнеше бет болса, пайдаланылатын беттің реттік нөмірі (сан немесе жол). Бір бетті (алғашқы бет - 0) немесе бірнеше бетті (үтір арқылы бөлінген) көрсетуге болады.

Сұраныс денесінде қажетті барлық параметрлер болуы керек. DiMaker-дегі құжатты немесе интеграцияны тек бір рет баптап, барлық мәліметті басқаруға мүмкіндік аласыз.

• Тақырып жолдары - авторизация токены және клиенттің UUID-ін көрсету қажет. Егер пайдаланушы файлды өздігінен жүктемесе, тек авторизация токены беріледі.
  • Тақырып атауы: Authorization, мәні: Bearer {токен} (DiMaker токены)

    DiMaker-ден алынған авторизация токены

  • Тақырып атауы: X-Client-Uuid, мәні: GET параметр uuid.

    GET параметрін таңдаңыз.

    GET параметрін Yandex Forms-қа енгізу

Барлық баптауларды дұрыс енгізіп, жүктеу процесі аяқталғаннан кейін, дайын файлды пайдаланушы жүктеп ала алады.

Басқа интеграциялар