Carregar Questões da Avaliação
Descrição
Este endpoint retorna as questões de uma avaliação específica baseada no step (etapa) e language_id (idioma) fornecidos. É um endpoint público que não requer autenticação.
Verbo
GET
URL Base
https://api.soargi.com
Endpoint
/assessment/questions
Parâmetros de Consulta
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| step | string | Sim | Etapa da avaliação (ex: "p1", "p2", "diagnostico"). |
| language_id | integer | Sim | ID do idioma (1: Inglês, 2: Português, 3: Espanhol). |
Exemplo de URL
/assessment/questions?step=p1&language_id=2
Sucesso - 200
{
"status": "success",
"questions": [
{
"id": 1,
"step": "p1",
"language_id": 2,
"word_sequence": 1,
"word": "palavra",
"translation": "word",
"category": "substantivo",
"difficulty": "easy"
},
{
"id": 2,
"step": "p1",
"language_id": 2,
"word_sequence": 2,
"word": "tempo",
"translation": "time",
"category": "substantivo",
"difficulty": "medium"
}
]
}Erro - 400 (Parâmetros obrigatórios)
{
"status": 400,
"error": 400,
"messages": "step e language_id são obrigatórios."
}Códigos de Resposta
- 200 - Questões retornadas com sucesso
- 400 - Parâmetros obrigatórios não fornecidos
Detalhes dos Campos
- step: Identifica a etapa da avaliação
- language_id: Define o idioma das questões
- word_sequence: Ordem sequencial das palavras
- word: Palavra no idioma selecionado
- translation: Tradução da palavra
- category: Categoria gramatical da palavra
- difficulty: Nível de dificuldade da questão
Observações
- Este endpoint NÃO requer autenticação.
- As questões são ordenadas por word_sequence.
- Suporta múltiplos idiomas (Inglês, Português, Espanhol).
- Ideal para carregar questões antes de iniciar uma avaliação.