Integrazione con GetCourse
Generazione e invio automatico di diplomi e certificati da GetCourse al termine di un corso o webinar. Il link del diploma generato verrà salvato nei dati dell'utente sul profilo GetCourse.
Creazione del processo
Per inviare richieste di creazione file a DiMaker, è necessario configurare un processo su GetCourse. Per farlo, vai su "Attività" - "Processi". Successivamente, clicca su "Crea processo". Riempi il nome e seleziona "Tipo di oggetto" - "Utenti".
Finestra di creazione del processo
Nel processo appena creato, seleziona la scheda "Processo" e, nell'angolo destro, fai clic su "Aggiungi blocco" - "Operazione".
Finestra di creazione del processo - aggiunta di chiamata URL
Nella finestra che appare, seleziona "Chiamare URL" (ultima opzione nell'elenco) e premi "Salva".
Finestra di creazione del processo - finestra delle attività
Questa è la finestra principale. Devi scegliere il metodo POST e compilare il campo URL con una stringa di richiesta contenente:
- Indirizzo della richiesta - https://dimaker.app/api/v1/create/?
- API Token - secure (disponibile nelle impostazioni di DiMaker)
- ID del documento - doc_id del documento che verrà utilizzato per emettere il certificato o diploma
- ID della cartella - folder_id della cartella del Disco dove il file deve essere salvato
- ID del template email - mail_id modello di email che verrà utilizzato per l'invio del file
- Dati da sostituire, ogni variabile deve iniziare con il prefisso mask_
Vediamo nel dettaglio ciascuno di questi punti, quindi comporremo la stringa di richiesta finale.
Variabili
La richiesta deve includere alcune variabili per accedere all'account DiMaker, specificare quale documento utilizzare, in quale cartella Disco salvare il file e così via.
Le variabili obbligatorie sono contrassegnate con un asterisco.
-
secure*
Token (stringa di 36 caratteri) disponibile nella scheda "Token API" in DiMaker.
-
doc_id*
ID del documento (stringa di 36 caratteri), che verrà utilizzato per generare il file. L'ID può essere trovato nella barra degli indirizzi quando il documento è aperto. Il documento non deve essere nel cestino, ma può essere salvato in qualsiasi cartella di Documenti.
-
mail_id
ID del modello di email (stringa di 36 caratteri) per l'invio via email. L'ID si trova nella barra degli indirizzi quando il modello è aperto. Se la variabile non è specificata, l'email non verrà inviata.
-
email_send
Momento dell'invio dell'email con il file. Può avere i seguenti valori:
onfinish - Invia tutte le email una volta completata la creazione dei file (default)
oncreate - Invia le email non appena il file è stato generato. Per un singolo file, onfinish e oncreate sono equivalenti.
timeout - Invia l'email dopo un intervallo di tempo specifico. In questo caso, è necessario fornire anche due parametri:
email_timeout_value - valore numerico dell'intervallo in cui inviare le email
email_timeout_unit - unità di tempo dell'intervallo. Può essere "m" (minuti), "h" (ore), "d" (giorni).
Oppure, per specificare un orario esatto, fornire un timestamp in formato Unix nel campo email_timeout_timestamp. Se vengono forniti sia timeout sia email_timeout_timestamp, il timestamp avrà priorità. -
folder_id
ID della cartella nel Disco (stringa di 36 caratteri) per il salvataggio dei file. Se la cartella non esiste, verrà creata automaticamente al momento della creazione del primo file.
-
page_id
Numero progressivo del foglio (numero o stringa), se il documento contiene più fogli. Puoi specificare un singolo numero (es. 0 per il primo foglio) o più numeri separati da virgola.
-
result
Determina in quale formato deve essere restituito il risultato. Può avere i seguenti valori:
- Non specificato. Verrà restituita una stringa con il risultato della richiesta (vedi sotto).
- link. Se la richiesta ha esito positivo, verrà restituito un link al file generato. Per il file, bisogna accedere al link fornito. La creazione del file richiede 1-5 secondi. Se la richiesta non crea un file, verrà restituita una stringa con un errore.
- file. Se la richiesta ha esito positivo, verrà restituito direttamente il file creato. Se il numero di richieste è elevato, il tempo di creazione aumenterà. Se il file non è pronto entro 30 secondi, restituisce errore 404.