GetCourse-пен интеграция

GetCourse арқылы тренинг немесе вебинар аяқталғаннан кейін, дипломдар мен куәліктерді автоматты түрде жасау және жіберу. Дайын дипломға сілтеме GetCourse-тегі студент деректерінде сақталады.

Процесс жасау

DiMaker-ге файл жасау сұраныстарын жіберу үшін, GetCourse платформасында процесс құру қажет. Ол үшін "Тапсырмалар" - "Процестер" бөлімін ашыңыз. Содан кейін "Процесс жасау" батырмасын басыңыз. Процесс атауын толтырып, "Объект түрі" ретінде "Пайдаланушыларды" таңдаңыз.

Процесс құру терезесі

Келесі қадамда, процесте "Процесс" қойындысын таңдап, оң жақтан "Блок қосу" – "Операция" опциясын қосыңыз.

Процесс құру – URL шақыруды қосу

Ашылған терезеде "URL шақыру" (ең соңғы тармақ) опциясын таңдап, "Сақтау" батырмасын басыңыз.

Процесс құру терезесі - тапсырма терезесі

Бұл негізгі қадам. Мұнда POST әдісін таңдап, URL жолына сұраныс жолын қосыңыз. Ол келесі бөліктерді қамтуы керек:

• Сұраныс адресі - https://dimaker.app/api/v1/create/?
• API токені - secure (DiMaker параметрлерінен алынады)
• Құжат ID - doc_id. Диплом немесе куәлік негізінде құрылады
• Қалтаның ID - folder_id. Файл сақталатын бұлттағы қалта
• Хат шаблонының ID - mail_id. Файл жіберілетін хат үшін қолданылатын шаблон
• Айнымалы деректер, mask_ префиксімен басталатын әр айнымалы

Алдымен осы деректерді егжей-тегжейлі қарастырып, кейін сұраныс жолының қалай жинақталатынын көрсетеміз.

Айнымалылар

Сұраныста DiMaker жүйесіне кіруді қамтамасыз ететін, қандай құжатты пайдалану және файлдарды қай жерге сақтау керектігін көрсететін айнымалылар болуы керек.

* белгісімен белгіленген айнымалылар міндетті болып табылады.

• secure*

  DiMaker ішіндегі "API токендері" бетінен алынатын 36 таңбалық токен

• doc_id*

  Файл жасау үшін пайдаланылатын құжаттың 36 таңбалық ID-сі. Құжат ашылған кезде, оның ID-сін мекенжай жолынан алуға болады. Құжат себетте болмауы керек, бірақ ол Құжаттар папкасында орналасуы мүмкін.

• mail_id

  Электрондық пошта арқылы жіберу үшін қолданылатын хат шаблонының ID-сі. Егер бұл айнымалы берілмесе, файл жіберілмейді.

• email_send

  Файлмен хатты жіберу уақыты. Мына мәндерді қабылдайды:
  onfinish - Барлық файл жасалғаннан кейін хаттарды жіберу (әдепкі)
  oncreate - Әр файл жасалғаннан кейін бірден хат жіберу
  timeout - Белгіленген уақыт аралығынан кейін хат жіберу. Бұл жағдайда екі қосымша параметр қажет болады:
  email_timeout_value - уақыт аралығын анықтайтын сан
  email_timeout_unit - уақыт бірлігі ("m" – минут, "h" – сағат, "d" – күн).

• folder_id

  DiMaker жүйесіндегі файл сақталатын қалтаға арналған өзгеше 36 таңбалық ID. Егер қалта жоқ болса, процесс барысында автоматты түрде жасалады.

• page_id

  Егер құжатта бірнеше бет бар болса, қажет беттердің нөмірін көрсетуге болады.

• result

  Нәтижені қай формада қайтару керектігін көрсетеді:

  • жолы - сұраныстың нәтижесін қайтару
  • Сілтеме - Жасалған файлға сілтемені қайтарады
  • Файл - Жасалған файлды тікелей қайтарады

Айнымалылар туралы толығырақ

DiMaker құжатында кем дегенде бір айнымалы болуы қажет, мысалы %name немесе %city. Айнымалы тек латын әліпбиінде жазылуы керек. Кириллицаны (%фио немесе %класс) қолдануға болмайды.

Процесстердегі URL жасау кезінде айнымалы атауы mask_ сөзінен басталып, құжаттағы айнымалы атауымен жалғасады. Мысалы, егер құжаттағы айнымалы %name болса, URL-дегі айнымалы mask_name деп аталады.

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