Search docs/

Prover notas acadêmicas

{...}

O Hub de APIs na Layers permite que apps troquem informações por meio de actions: protocolos especificando o formato de requisição e resposta aceitos para uma determinada informação. Apps que provém informações de notas acadêmicas por meio da action @layers:education:GradeBooks:getRelated receberão a requisição no formato abaixo e devem respondê-la com todos os campos obrigatórios.

POST https://api.provedor-registrado.com/v1/@layers:education:GradeBooks:getRelated
CopiarCopiado

Requisição

Especificação

  • contextObjectobrigatório

  • secretStringobrigatório

    Chave secreta específica do app

  • dataObject

Exemplo

{
  "context": {
    "issuedAt": "2024-04-05T18:25:02.732Z",
    "action": "@layers:identificador_da_action",
    "community": "idcomunidadeteste"
  },
  "secret": "exemplo1-e000-11xe-2m33-4444444plo",
  "data": {
    "user": {
      "id": "exemplo",
      "name": "João Pedro",
      "alias": "0001",
      "timezone": "America/Sao_Paulo",
      "language": "pt-BR",
      "accountId": "exemplo"
    }
  }
}
CopiarCopiado

Resposta

Especificação

  • resultObject[ ]obrigatório

Exemplo

{
  "result": [
    {
      "id": "0001",
      "season": "2019",
      "student": "Ivan Seidel Gomes",
      "course": "1º Ano - Ensino Fundamental",
      "status": "current",
      "terms": [
        {
          "label": "Primeiro Bimestre",
          "startsAt": "2024-04-05",
          "endsAt": "2024-04-05",
          "status": "current",
          "subjects": [
            {
              "label": "Português",
              "abbr": "PORT",
              "activities": [
                {
                  "category": "Provas",
                  "label": "Prova 1",
                  "description": "Verbos e substantivos",
                  "date": "2024-04-05",
                  "comment": "O aluno deve estudar mais o infinitivo",
                  "scoreGiven": 6.5,
                  "scoreMaximum": 10,
                  "scoreMood": "good",
                  "scoreDate": "2024-04-05"
                }
              ],
              "overall": [
                {
                  "type": "attendance",
                  "label": "Faltas",
                  "scoreGiven": "90%",
                  "scoreMaximum": "100%",
                  "scoreMood": "good",
                  "featured": true
                }
              ],
              "categories": [
                {
                  "name": "Provas",
                  "description": "Provas discussivas e/ou objetivas com intuito de avaliar o aprendizado",
                  "order": 1
                }
              ]
            }
          ]
        }
      ],
      "attachments": [
        {
          "title": "CalculoDeNotas.pdf",
          "type": "file`",
          "url": "https://calculo.pdf"
        }
      ]
    }
  ]
}
CopiarCopiado