events

Especificação de API

Base URI

https://events.com
Parameters
access_token
string required

Token de acesso para qualquer rota que transmita informações sensiveis

Responses
403 Forbidden

Acesso restrito

401 Unauthorized

Token nao autorizado

API Methods
POST /oauth/token
GET /oauth/session
GET /presentation
GET /terms
GET /user/{userId}/config
PUT /user/{userId}/config
POST /user/{userId}/delete
GET /user/perfil?access_token={token}
PUT /user/perfil?access_token={token}
GET /user/{userId}/events
GET /event/{eventId}/participants
GET /user/feed?access_token={TOKEN}
POST /user/like/{useriD}?access_token={token}
POST /user/dislike/{useriD}?access_token={token}
GET /user/block/{useriD}?access_token={token}
GET /user/{userId}/photos
GET /event/location?location={location}
GET /event/spotlight
GET /event/cities
GET /event/{eventId}/get
POST /event/{eventId}/confirm/{userId}
GET /user/{userId}/combinations
POST /user/{userId}/chat/{userChat}
GET /user/{userId}/chat/{userChat}/{page}
DELETE /user/{userId}/chat/{userChat}/{messageId}
GET /get/ads?access_token={token}
Get Token
POST /oauth/token

Gera e retorna um token unico para ser utilizado na sessao do usuario. Este token protege todos os dados do usuario, nao sendo possivel ter acesso a nenhum dado de algum usuario sem um token gerado por suas credenciais.

Ao criar um usuário, o usuário terá:

name e facebookID, que será enviado na rota e tb os seguintes atributos

is_premium - indica se o usuário é premium perfil_photo - foto do perfil do usuário. photos [] - é um array com 5 fotos need_tour - indica se o usuário precisa passar pelo tour

Todas essas informações serão passadas no put da rota Set Perfil

Request parameters

user_id
string required

Id do facebook do usuario

name
string required

Nome do Usuario

Responses

200 OK

Usuario ja existente

Body
Object
access_token
string
Example:
5119e8562f25d580f118a65f28a127283b1edbaf
expires_in
integer
Example:
604800
token_type
string
Example:
Bearer
scope
unknown
refresh_token
string
Example:
e9fc654517b8bf231d7059cf409f45b1ca7e9e9b
Get Session
GET /oauth/session

Cria sessao para o usuario

Responses

200 OK

Sessao criada

Body
Object
name
string
Example:
Talula Naiscimento
is_premium
boolean
Example:
true
date
string
Example:
2016-05-31
perfil_photo
string
Example:
link
need_tour
boolean

false

user_id
string

ID do usuario que foi criado no getToken (ou que já existe)

Get Presentation
GET /presentation

Retorna apresentacao inicial a ser mostrada quando o usuario instala o aplicativo. (conjunto de fotos)

Responses

200 OK

Existe apresentacao cadastrada

Body
Object
photo
string
Example:
imagem1
description
string
Example:
descricao
Get Terms
GET /terms

Retornar os termos de servico legais do aplicativo.

Responses

200 OK

Termos de servico do app

Body
string
Get User Config
GET /user/{userId}/config

Retornar as configuracoes do perfil do usuario.

Path variables

userId
string required

Responses

200 OK

Configuracoes do perfil do usuario

Set Config
PUT /user/{userId}/config

Atualiza perfil do usuario

Path variables

userId
string required

Responses

200 OK

Configuracoes atualizadas

Body
Object
Delete Account
POST /user/{userId}/delete

Deleta a conta do usuario (flag)

Path variables

userId
string required
Get Perfil
GET /user/perfil?access_token={token}

Retornar o perfil do usuario (nome, fotos e sobre)

Set Perfil
PUT /user/perfil?access_token={token}

Atualiza Perfil do usuario. (nao tem post pois ao criar o usuario no sistema ja associa a um perfil vazio)

Request body

Object
name
string

Nome

is_premium
string
perfil_photo
string
photos[]
string
about
string
location
string
Get Events
GET /user/{userId}/events

Retorna Eventos que o usuario participa

Path variables

userId
string required

Responses

200 OK
Get Event Participants
GET /event/{eventId}/participants

Retorna os usuarios que participam do evento

Path variables

eventId
string required
Get Feed
GET /user/feed?access_token={TOKEN}

Retorna cards para o feed do usuario.

Responses

200 OK
Body
Object
name
string
Example:
VINICIUS
id
string
Example:
123812
photoQty
integer
Example:
3
local
string
Example:
Sao Paulo, SP
age
integer
Example:
16
parties
Array of integer
Example:
1
isCombination
integer
Example:
1
image
string
Example:
image_address
Do Combination
POST /user/like/{useriD}?access_token={token}

Realiza combinacao entre dois usuarios

Path variables

useriD
string required

Responses

200 OK
Body
Object
comStatus
string

1

Undo Combination
POST /user/dislike/{useriD}?access_token={token}

Retira a combinacao de dois usuarios

Path variables

useriD
string required
Dislike
GET /user/block/{useriD}?access_token={token}

Retira o usuario do feed do usuario por um periodo de tempo (ou para sempre, ainda vai ver isso)

Path variables

useriD
string required
Get Photos
GET /user/{userId}/photos

Retorna as fotos do usuario

Path variables

userId
string required
Get Events In Locaton
GET /event/location?location={location}

Retorna eventos nao localizacao (nome de cidade ou Brasil) especificada

Get Events Spotlight
GET /event/spotlight

Retorna eventos em destaque para aparecerem como aconselhamento no topo.

Get Cities
GET /event/cities

Retorna cidades que possuem eventos

Get Event Information
GET /event/{eventId}/get

Retorna informacoes do evento

Path variables

eventId
string required
Confirm Event
POST /event/{eventId}/confirm/{userId}

Confirma presenca em um evento

Path variables

eventId
string required
userId
string required
Get Combinations
GET /user/{userId}/combinations

Retorna combinacoes do usuario

Path variables

userId
string required
Send Message
POST /user/{userId}/chat/{userChat}

Envia Conversa para outro usuario

Path variables

userId
string required
userChat
string required
Get chat
GET /user/{userId}/chat/{userChat}/{page}

Retorna conversa de chat com um usuario, no intervalo da semana indicada. Se n for indicada page sera da ultima semana. Se for indicada page 5, sera de 5 semanas atraz...

Path variables

userId
string required
userChat
string required
page
number optional

Numero da semana (indo para traz) que deve buscar a conversa.

Delete Message
DELETE /user/{userId}/chat/{userChat}/{messageId}

Deleta mensagem do chat, ou o chat inteiro caso no messageId seja passado ALL

Path variables

userId
string required
userChat
string required
messageId
string required
getAds
GET /get/ads?access_token={token}

Responses

200 OK
Body
Object
title
string
description
string

Descrição da campanha

media_type
number

1 - Imagem 2 - Vídeo

link
string
Data Reference
User Config object

Configuration of a user

Properties

woman
boolean
Example:
true
man
boolean
Example:
true
ageRangeStart
integer
Example:
20
ageRangeEnd
integer
Example:
30
newMessage
boolean
newCombination
boolean
notificationAlert
boolean
Example:
true