Passar para o conteúdo principal

Documentação da API de envio de mensagens

🦉 API de mensagens POST ✓ Documentação ✓ Página de incorporação de provas

A API Postmessage é utilizada para enviar informações adicionais para a sua página de incorporação das nossas Provas.

Documentação da API de mensagens POST

A API Postmessage enviará uma mensagem para a página em que a prova está incorporada, que terá o seguinte aspeto

{ 
status: 'ranking',
ranking: {
score: 50, // Número, a nota da prova. 100 significa 100% correto, 0 significa 0% correto
answered: 2, // Número, A quantidade de perguntas respondidas para esta sessão
corret: 1, // Número, a quantidade de perguntas que foram respondidas (parcialmente) corretas
incorrect: 1, // Número, a quantidade de perguntas que foram respondidas incorretamente
points: 2, // Número, A quantidade de pontos marcados para esta sessão
máximo: 4, // Número, a quantidade máxima de pontos possíveis para esta sessão
category: {
title: 'Failed' // String,
}
}
}

Para sua conveniência, adicionámos um exemplo de JavaScript abaixo que pode utilizar na sua página de incorporação. Ele usa a biblioteca jQuery, mas esse requisito pode ser facilmente removido, se necessário.

 <script type="text/javascript> 
// Exemplo de implementação de eventos. Usando jQuery v1.7 ou superior
// Deve funcionar nos seguintes navegadores: [http://caniuse.com/#feat=x-doc-messaging](http://caniuse.com/#feat=x-doc-messaging)
jQuery(window).on("message onmessage", function(event) {
var origin = event.originalEvent.origin;
var allowedDomains = [
'[https://www.onlinequizcreator.com]([https://www.onlinequizcreator.com/](https://www.onlinequizcreator.com/))',
'[https://www.onlineassessmenttool.com]([https://www.onlineassessmenttool.com/](https://www.onlineassessmenttool.com/))',
'[https://www.onlineexambuilder.com]([https://www.onlineexambuilder.com/](https://www.onlineexambuilder.com/))',
'[https://www.easy-lms.com]([https://www.easy-lms.com/](https://www.easy-lms.com/))'
];
try {
var data = (typeof event.originalEvent.data === "string") ? JSON.parse(event.originalEvent.data) || event.originalEvent.data;
}
catch (e) {
return;
}

if (allowedDomains.indexOf(origin) !== -1 && data.status && data.ranking) {
// O seu script personalizado....
// As seguintes variáveis estão disponíveis
data.ranking.score; // A nota em (%) para esta prova. ex. 100 para tudo correto e 0 quando todas as respostas estavam erradas
data.ranking.answered; // A quantidade total de perguntas respondidas
data.ranking.corret; // Quantidade de perguntas respondidas corretamente
data.ranking.incorrect; // Quantidade de perguntas respondidas incorretamente
data.ranking.points; // A quantidade de pontos que o participante obteve nesta sessão
data.ranking.maximum; // O máximo de pontos possíveis para esta prova
data.ranking.category.title; // O nome da categoria em que o participante se insere. Provavelmente será 'Aprovado' ou 'Reprovado'
}
});
</script>
Respondeu à sua pergunta?