Download the PHP package ivmelo/suapclient without Composer
On this page you can find all versions of the php package ivmelo/suapclient. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package suapclient
SUAP API PHP
Um wrapper PHP para a API do SUAP (Sistema Unificado de Administração Publica) do IFRN. Este pacote permite que você tenha acesso aos dados do SUAP na sua aplicação PHP.
É o componente principal do SUAP Bot.
Atualmente fornece informações de boletim (notas, frequência), cursos, horários, locais de aula e dados do aluno.
Este pacote foi atualizado para acessar os dados através da API oficial do SUAP, e não mais fazendo web scraping. Caso deseje utilizar a versão que faz web scraping, veja a tag 0.2.0.
Instalação
Para instalar, recomenda-se o uso do Composer.
Adicione a dependência abaixo no seu composer.json e execute .
Alternativamente, você pode instalar diretamente pela linha de comando:
Uso
Você pode instanciar um cliente usando um token de acesso, ou usar o construtor vazio.
Autenticação
Para autenticar, basta usar chamar o método autenticar($usuario, $chave).
O método retornará um array com um token de acesso ($data['token']).
O token será salvo no objeto para que seja reutilizado nos requests subsequentes. Caso não deseje salvar o token, basta setar o quarto parâmetro do construtor como false: autenticar($matricula, $senha, true, false).
Você também pode utilizar a chave de acesso de responsável para efetuar o login. Para isso, basta passar true como terceiro parâmetro do método autenticar($matricula, $chave, true).
Para obter a chave de acesso, faça login no SUAP, e vá em "Meus Dados" > "Dados pessoais" > "Dados Gerais" e procure por "Chave de Acesso. Ela deve ter 5 dígitos e ser algo parecido com .
Dados do Aluno
Para receber dados do aluno, basta chamar o método getMeusDados().
A saída será um array com informações básicas do estudante e do curso.
Períodos Letivos
Para receber os períodos letivos do aluno use o método getMeusPeriodosLetivos().
A saída será um array com a listagem de períodos letivos do aluno.
Boletim
Para receber dados do boletim do aluno, basta instanciar um cliente e chamar o método getMeuBoletim($anoLetivo, $periodoLetivo).
A saída será um array com informações sobre a disciplina encontradas no boletim do aluno.
Alunos do ensino superior só terão as notas da etapa 1 e 2.
Listagem de Turmas Virtuais
Para visualizar a listagem das turmas virtuais, incluindo ids, horários e locais de aula, use o método getTurmasVirtuais($anoLetivo, $periodoLetivo).
O método retornará um array com a lista de disciplinas do semestre atual junto com outras informações sobre as mesmas.
Detalhes de Turma Virtual
Para visualizar os detalhes de uma turma virtual, basta usar o método getTurmaVirtual($idDaTurma).
O retorno será um array com os detalhes da turma incluindo participantes, aulas, materiais de aula, professores e etc...
Horários de Aula
Para recuperar horários de aula no formato de array, use o método getHorarios($anoLetivo, $periodoLetivo).
Isso retornará um array associativo usando dias da semana como chave (1: dom, 2: seg, 3: ter...), o turno como subchave (M: matutino, V: vespertino, N: noturno) e o slot da aula como segunda subchave(1-6).
I.E. Para pegar a quarta aula da terça feira a tarde:
O retorno do método pode ser visto a seguir (Algumas partes foram omitidas usando ...).
E se ocorrer algum erro durante o request?
Caso algum erro ocorra durante o request, o cliente HTTP lançará exceções. Isto inclui falha no login, 404, 500, etc...
Você deve usar try-catch blocks para tratar os possíveis erros dentro da sua aplicação sempre que usar algum método da API.
Desenvolvimento (Como contribuir)
Para ajudar no Desenvolvimento, clone o repositório, instale as dependências e use o arquivo test.php que encontra-se na pasta tests.
Altere o arquivo test.php de acordo com a sua preferência, mas evite comitar mudanças a menos que tenha adicionado alguma funcionalidade nova a biblioteca.
O código em desenvolvimento mais recente está na branch master.
Coisas a Fazer:
Veja a sessão de Issues para ver o que falta fazer ou se tem algum bug precisando de atenção.
Versões Anteriores
Para ver as versões anteriores da biblioteca (Incluindo as que fazem web scraping), veja as tags do projeto.
Licença
The MIT License (MIT)
Copyright (c) 2016 Ivanilson Melo
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
