> ## Documentation Index > Fetch the complete documentation index at: https://docs.useweve.com/llms.txt > Use this file to discover all available pages before exploring further. # Cursos do aluno > Publicados e visíveis para este aluno, com acesso e progresso. ## OpenAPI ````yaml GET /v1/clubs/{clubId}/classroom/courses openapi: 3.0.3 info: title: weve API description: > Contrato entre a API Go e o dashboard. **Este arquivo é a fonte de verdade**: os tipos e a interface de servidor em Go, e o client TypeScript, são todos gerados daqui (`make openapi`). Handler que divergir da interface não compila. A superfície interna (`/internal/*`) fica de fora de propósito: é acesso de máquina, protegido por segredo dedicado, e não é contrato de cliente. version: 0.2.0 servers: - url: https://api.useweve.com description: produção - url: http://localhost:8080 description: desenvolvimento security: [] tags: - name: health - name: session - name: account - name: clubs - name: members - name: webhooks - name: outgoing-webhooks - name: sales-platforms - name: catalog - name: content - name: classroom - name: community - name: mentorships - name: agents - name: lives - name: students - name: auth - name: campaigns - name: workflows - name: email - name: exports - name: certificates - name: terms - name: mcp - name: gamification - name: support - name: help paths: /v1/clubs/{clubId}/classroom/courses: parameters: - $ref: '#/components/parameters/OrgId' get: tags: - classroom summary: Os cursos como o aluno os vê description: | Publicados e visíveis para ESTE aluno: os que ele tem, mais os listados a todo membro. `has_access` distingue os dois — o card sem acesso é vitrine. Com o progresso de cada um. operationId: listClassroomCourses responses: '200': description: O catálogo do aluno content: application/json: schema: $ref: '#/components/schemas/ClassroomCourseList' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '500': $ref: '#/components/responses/InternalError' security: - studentSession: [] components: parameters: OrgId: name: clubId in: path required: true description: > Id público da organização — o mesmo que `GET /v1/me` devolve em `organization_id`. Na URL o recurso se chama **club**; no contrato e no domínio, organization. A divergência é deliberada: `clubs` é a palavra do produto, e a URL é o que as pessoas leem. É o identificador do provedor de autenticação, e é assim de propósito: o cliente precisa nomear a organização ao pedir o token, e o token é o que prova o escopo. Um id só nosso obrigaria a traduzir um no outro antes de ter um token — e a tradução exigiria uma chamada escopada, que é justamente a que ainda não dá para fazer. O uuid interno da organização não aparece no contrato: ele é o que as chaves estrangeiras do domínio referenciam, e continua sendo nosso. schema: type: string format: uuid schemas: ClassroomCourseList: type: object required: - data properties: data: type: array items: $ref: '#/components/schemas/ClassroomCourseCard' ClassroomCourseCard: type: object required: - public_id - title - slug - format - has_access - published_lessons - completed_lessons properties: public_id: type: string title: type: string slug: type: string format: $ref: '#/components/schemas/CourseFormat' instructor_name: description: Quem ensina. Ausente, a tela escreve o nome do club. type: string purchase_url: description: | A página de venda, para o "Saber mais" de quem ainda não tem o curso. Só vem para quem NÃO tem acesso: para quem tem, não há o que comprar. type: string description: type: string cover_url: type: string has_access: type: boolean access_until: type: string format: date-time description: | Até quando o aluno tem este curso. Ausente com `has_access` é vitalício, ou entrega aberta que ainda não virou matrícula. published_lessons: type: integer completed_lessons: type: integer ErrorEnvelope: type: object description: >- Envelope único de erro da API. O `code` é o contrato com o cliente — a `message` é diagnóstico, e pode mudar. required: - error properties: error: type: object required: - code properties: code: type: string message: type: string CourseFormat: type: string enum: - course - ebook - masterclass default: course description: | Como o conteúdo se APRESENTA — a aba em que ele aparece no catálogo e a palavra que a tela escreve. Não é um tipo de domínio: um ebook é um curso de uma aula, com a mesma árvore, os mesmos blocos, a mesma agenda e o mesmo entregável, e NENHUMA regra de acesso, de estrutura ou de liberação olha para este campo. `course` é o catálogo com módulos e aulas, `ebook` é a leitura (um PDF), `masterclass` é a aula única em vídeo — gravação de live inclusive, que só difere na procedência. Curso criado sem formato é `course`. responses: Unauthorized: description: Sessão ausente, expirada ou revogada content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' Forbidden: description: > A sessão é válida, mas não age nesta organização. É a mesma resposta para uma organização que não existe — distinguir as duas deixaria enumerar organizações alheias. content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' InternalError: description: >- Falha inesperada. O corpo nunca traz o erro real — ele fica no log e no rastreamento. content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' securitySchemes: studentSession: type: http scheme: bearer description: | Token OPACO de sessão de aluno, emitido por `/v1/auth/sign-in` e verificado contra a nossa tabela — não é JWT e não se lê nada dele. A ida ao banco não é custo novo: toda requisição autenticada já resolve o dono da sessão. Em troca, encerrar uma sessão vale no mesmo instante, sem lista de bloqueio nem janela de tolerância. O classroom o guarda em cookie **host-only**: um cookie de domínio o mandaria para os subdomínios dos outros clubs. ````