# Aula

> Rota da API para listar as aulas de um curso, na ordem em que aparecem para o aluno.

Esta rota devolve as aulas de um curso, na sequência dos módulos e das aulas. Na API, as aulas aparecem como **itens**.

Base: `https://<sua-plataforma>/api/v1` · Autenticação: cabeçalho `Authorization` com sua chave (veja [API](/configuracoes/api)).

## Listar as aulas de um produto

```
GET /item/lista_por_produto/{id}
```

| Parâmetro | Onde | Obrigatório | Descrição |
|---|---|---|---|
| `id` | caminho | Sim | ID do curso (veja [Produto](/configuracoes/api-produto)) |

```bash
curl https://escola.asalahub.com/api/v1/item/lista_por_produto/12 \
  -H "Authorization: ash_sua_chave_aqui"
```

```json
{
  "success": true,
  "code": 200,
  "data": {
    "paginator": { "perPage": 3, "next_page_url": null, "prev_page_url": null },
    "item": [
      { "id": 501, "ordem": 1, "nome": "Boas-vindas" },
      { "id": 502, "ordem": 2, "nome": "O cliente no centro" },
      { "id": 503, "ordem": 3, "nome": "Exercício prático" }
    ]
  },
  "profiler": { "start": 1789737057.12, "finish": 1789737057.13, "process": 0.01 }
}
```

| Campo | Descrição |
|---|---|
| `item[].id` | ID da aula |
| `item[].ordem` | Posição da aula no curso, contando todos os módulos em sequência |
| `item[].nome` | Título da aula |

Todas as aulas vêm numa única resposta (o `paginator` informa o total em `perPage` e não há próxima página). Se o curso não existir, a resposta é `409` com a mensagem "Produto não encontrado.".

:::info
Esta lista inclui também as aulas ainda não publicadas. Já o progresso do aluno (`GET /usuario/progresso_por_produto`, em [Usuário](/configuracoes/api-usuario#ver-o-progresso-de-um-aluno-em-um-curso)) considera só as publicadas, por isso a `ordem` de uma aula pode ser diferente entre as duas rotas.
:::