Skip to content
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
66 changes: 58 additions & 8 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,7 @@
O **Cliente SUAP Javascript** implementa a integração com o SUAP, tendo 2 principais funcionalidades:

- Logar com SUAP via OAuth2

- Consumir API (via OAuth2) obtendo recursos em nome do usuário

## QuickStart
Expand All @@ -14,20 +15,69 @@ O **Cliente SUAP Javascript** implementa a integração com o SUAP, tendo 2 prin
Crie sua aplicação em https://suap.ifrn.edu.br/api/ com as seguintes informações:

- **Client Type:** Public

- **Authorization Grant Type:** Implicit
- **Redicert URIs**: http://localhost:8888/

### Instalando, Configurando e Rodando o Cliente SUAP Javascript
- **Redicert URIs**: http://localhost:5000/
> Usaremos a URI com a porta padrão do serviço que irá rodar o projeto. Caso haja necessidade, troque-a de acordo com o serviço a ser devidamente usado.

## Começando...

Essas instruções fornecerão uma cópia do projeto em execução na sua máquina local para fins de desenvolvimento e teste.

### Pré-requisitos

O que você precisa para instalar o software:

```
npm
git
```

### Instalando o projeto

Clonando o projeto:

```bash
git clone https://github.com/ifrn-oficial/cliente_suap_javascript.git
```

Considerando que você já tenha clonado o repositório **cliente_suap_javascript**. abra o terminal:
Navegando até a pasta do projeto:

cd cliente_suap_javascript
cp settings.sample.js settings.js
```bash
cd cliente_suap_javascript
```

Alterando o arquivo de exemplo de configurações para uso na aplicação:

```bash
cp settings.sample.js settings.js
```

Faça os ajustes necessários, definindo a variável **CLIENT_ID**.

É necessário rodar a aplicação cliente num servidor local (usamos o Python SimpleHTTPServer):
```js
var CLIENT_ID = "SEU_CLIENT_ID_AQUI";
var REDIRECT_URI = "http://localhost:5000/";
var SUAP_URL = "https://suap.ifrn.edu.br";
```

É necessário rodar a aplicação cliente num servidor local (usamos o npx serve):

```bash
npx serve
```

Abra seu browser em http://localhost:5000/ para ver o resultado.

## Como contribuir

- Faça um fork desse repositório;

- Crie uma branch com a sua feature: `git checkout -b minha-feature`;

- Faça commit das suas alterações: `git commit -m 'feat: Minha nova feature'`;

python -m SimpleHTTPServer 8888
- Faça push para a sua branch: `git push origin minha-feature`.

Abra seu browser em http://localhost:8888/
Depois que o merge da sua pull request for feito, você pode deletar a sua branch.