Wrapper Java para a API JSON do Eventick
Java
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.

README.md

eventick-api

Build Status

Wrapper Java para a API JSON do Eventick

Para mais informações sobre a API em si, visite sua página oficial http://developer.eventick.com.br/

  • Versão suportada da API: V1
  • Versão do wrapper: 0.1.1

Uso

Autenticação

A API do Eventick requer autenticação que é realizada através do HTTP por um token de acesso que o serviço lhe oferece, para obter um, basta ter uma conta no Eventick

Para resgatar seu token, rode o seguinte comando curl como documentado na API:

curl https://www.eventick.com.br/api/v1/tokens.json --user 'seuemail@gmail.com:senha'

Recuperando dados

String meuToken = "abcdefghijlmnopqrstu";
EventickAPI api = new EventickAPI(meuToken);

// Retorna uma lista de todos os seus eventos
List<Event> events = api.getMyEvents();

// Obtenha informações de um evento seu pelo id
int idEvento = 1000;
Event evento = api.getEventById(idEvento);

evento.getTitle();      // retorna título do evento
evento.getVenue();      // retorna local do evento
evento.getStartAt();   // data de início do evento
evento.getAPIURL());    // URL do evento na API

evento.getEventWebsiteURL() // URL do evento no site (URL para humanos)

// Obtenha a lista de participantes daquele evento
List<Attendee> = evento.getAttendees();

// Obtenha a lista de ingressos daquele evento
List<Ticket> = evento.getTickets();

Contribuindo

Você pode contribuir de várias formas para o projeto. Pode ser melhorando a documentação (Javadocs ou Wiki), reportando bugs, criando testes, aplicações de exemplo e qualquer outra coisa que possa melhorar o projeto ou a vida de quem o usa.

Você pode dar uma olhada nos Issues existentes :)

Build e Testes

Execute o seguinte comando para fazer o Maven realizar o build do projeto e em seguida rodar os testes:

$ mvn test

TO-DO

  • Adicionar suporte a testes com JUnit
  • Adicionar mais exemplos à Wiki

Problemas

Se você encontrou algum bug ou outro problema, crie um Issue detalhado dele! No caso de você achar que esse problema está na API em si, e não no wrapper, mande um email pra api@eventick.com.br

Licença

Esse projeto é liberado sob a licença do MIT, uma cópia (em inglês) está na raiz do projeto no arquivo LICENSE.txt

Copyright (c) 2013 Rodrigo Alves