An open API service indexing awesome lists of open source software.

https://github.com/denisidoro/bandex

API em PHP para obtenção dos cardápios dos bandejões da USP e da ECP
https://github.com/denisidoro/bandex

Last synced: 7 months ago
JSON representation

API em PHP para obtenção dos cardápios dos bandejões da USP e da ECP

Awesome Lists containing this project

README

          

# Bandejão

API em PHP para obter os cardápios dos bandejões da USP de Butantã e da Ecole Centrale Paris.

### Uso básico

Para retornar o cardápio do restaurante da Química, por exemplo, basta escrever
```php
get('quimica'); // Bandejão da Química
get('fisica,prefeitura'); // Bandejões da Física e da Prefeitura
```

Os restaurantes podem ser `central`, `fisica`, `prefeitura`, `quimica` ou `clube`, para a USP e `ru` ou `cafeteria`, para a ECP.

### Opções

A função `get` assume um segundo parâmetro, opcional, de opções:
```php
get($restaurants, $options);
```

Onde `$options` é uma array com os possíveis parâmetros:

* `days`: array com os índices dos dias cujos cardápios serão retornados, variando de `0` (segunda-feira) até `6` (domingo). Caso seja um int de valor `-1`, retorna o índice do dia atual;
* `meals`: array com os índices das refeições cujos cardápios serão retornados, assumindo `0` ou `1` (ou `-1` para a ECP). Caso seja um int de valor `-1`, retorna o índice da refeição atual;
* `time_format`: formato de tempo, segundo as [convenções em PHP] [date], para os dias da semana;
* `meal_format`: formato utilizado para as identificar as refeições, podendo ser `numeric` ou `name`;
* `implode`: se `TRUE`, compacta os resultados em arrays de um elemento, apenas.

### Retornar saldo

Para visualizar o saldo disponível na carteirinha USP, basta escrever
```php
balance($nusp, $password);
```

Onde:

* `$nusp`: número USP do usuário
* `$password`: senha do usuário na página do [Rucard] [rucard]

### Servidor dedicado

Você pode utilizar diretamente a API através do [servidor dedicado] [api]. As funções são homônimas às da classe e os parâmetros são passados via GET (POST será implementada no futuro). Caso uma faculdade seja determinada (`usp` ou `ecp`), a função `get()` é automaticamente chamada. Exemplos:

```
http://api.denisidoro.info/bandejao/usp/?restaurants=quimica
http://api.denisidoro.info/bandejao/get?restaurants=quimica
http://api.denisidoro.info/bandejao/balance?nusp=123456789&pass=senha
```

Notificações no Android
----

* Instale o [Tasker] [tasker]
* Crie um time-based profile
* Faça uma task usando HTTP GET e o `bandex.js`

[date]: http://php.net/manual/en/function.date.php
[rucard]: https://uspdigital.usp.br/rucard
[api]: http://denisidoro.info/api/
[tasker]: https://play.google.com/store/apps/details?id=net.dinglisch.android.taskerm