Incluir Aluno a uma Turma

Route (Rota)

Método	Rota	Descrição
POST	/webservice/student/classroom/join/{classroom_id}	Vincula aluno a uma turma

Headers (Cabeçalho)

Param	Tipo	Descrição	Obrigatório
Accept	String	application/json	Sim
Content-Type	String	application/json	Sim
secret	String	*Secret Key	Sim
token	String	**Webservice Token	Sim

*Para conseguir a Secret Key acesse sua Plataforma, abra o Menu, vá na área de Usuários e acesse Webservice, lá você terá a lista de usuários com suas respectivas Secret Key.

** Token gerado pela rota de autenticação.

Route Params (Parâmetros na Rota)

Param	Tipo	Descrição	Obrigatório
classroom_id	String	Id da turma	Sim

Query Params (Parâmetros)

Param	Tipo	Descrição	Obrigatório
student_id	String	Id do aluno	Não
document_type	String	*Tipo de documento - Ex.: CPF	Não
document	String	Documento do aluno - Ex.: XXX.XXX.XXX-XX	Não

* Os tipos de documentos padrões da plataforma são: CPF, RG e CNPJ

Vincular Aluno a uma Turma

Exemplos de Código

cURL


curl --location --request POST 'https://dev3.nochalks.com/student/classroom/join/1?student_id=1' \
--header 'Accept: application/json' \
--header 'secret: {{._webservice_secret}}' \
--header 'token: {{._webservice_token}}'

Node.js


const axios = require('axios');
let data = '';

let config = {
  method: 'post',
  maxBodyLength: Infinity,
  url: 'https://dev3.nochalks.com/student/classroom/join/1?student_id=1',
  headers: {
    'Accept': 'application/json',
    'secret': '{{._webservice_secret}}',
    'token': '{{._webservice_token}}'
  },
  data : data
};

axios.request(config)
.then((response) => {
  console.log(JSON.stringify(response.data));
})
.catch((error) => {
  console.log(error);
});

PHP


 'application/json',
  'secret' => '{{._webservice_secret}}',
  'token' => '{{._webservice_token}}'
];
$body = '';
$request = new Request('POST', 'https://dev3.nochalks.com/student/classroom/join/1?student_id=1', $headers, $body);
$res = $client->sendAsync($request)->wait();
echo $res->getBody();
?>

Request (Requisição)

- Request com ID do Aluno


{
	"student_id": 3
}

- Request com Documento do Aluno


{
	"document_type": "cpf",
	"document": "999.999.999-99"
}

Resposta

- Vinculado (Status: 200)

Mensagem: Vinculado
Status: 200
Resposta:


{
    "message": "Vinculado",
    "status": 200,
    "data": {
        "student": {
            "id": 1,
            "document_type": "CPF",
            "document": "999.999.999-99",
            "geographic_lock": 1,
            "profile": {
                "instagram": null,
                "facebook": null,
                "twitter": null,
                "linkedin": null,
                "website": null,
                "picture": null
            },
            "user": {
                "name": "Aluno",
                "email": "[email protected]",
                "expires_at": null
            }
        },
        "classrooms": [
            {
                "id": 1,
                "status": 1,
                "author": {
                    "id": 1,
                    "name": "admin",
                    "email": "[email protected]",
                    "status": 1
                },
                "translation": {
                    "name": "Turma",
                    "description": "Turma de Teste",
                    "language_id": 1
                }
            }
        ]
    }
}