Métodos da API

Aqui estão todas as chamadas que o seu aplicativo pode fazer para a nossa plataforma. Basta cadastrar ele no Apontador, prefixar com o endereço-base http://api.apontador.com.br/v1/ e começar a usar

Busca Local

Disponibilize a busca do site Apontador para seus usuários.

• search/places/bypoint
• search/places/byaddress
• search/places/byzipcode
• search/places/bybox
• search/places (formato livre)
• suggestions (sugestões estilo "você quis dizer...?" para locais)
• places Locais recomendados pelos usuarios (possuem 3 ou mais estrelas e estão em volta de uma certa localidade)

Detalhes de um Local

Endereço, telefone, fotos e avaliações - tudo sobre qualquer local.

• places/PLACEID
• places/PLACEID/photos
• places/PLACEID/reviews

Categorias

Seu aplicativo pode descobrir dinamicamente como os locais são organizados.

• categories
• categories/CATEGORYID/subcategories
• categories/top

Usuários

Busque usuários e saiba o que eles publicaram no Apontador.

• search/users/byname
• search/users/byaddress
• search/users/byemail
• users/USERID
• users/USERID/places
• users/USERID/reviews

Social

Descubra quem segue quem e ajude seus usuários a gerenciar relações.

• /users/USERID/followers
• /users/USERID/following
• /users/self/following
• /users/self/following/FOLLOWEDUSERID

Armazenando Informações

Cadastre locais e avaliações aqui, simplificando seu back-end e enriquecendo o ecossistema.

• places/new
• places/PLACEID/reviews/new
• places/PLACEID/photos/new
• places/PLACEID/voteup
• places/PLACEID/votedown

Ofertas

O ApontaOfertas conecta locais e pessoas através de promoções/descontos vindos de um grande número de parceiros.

• search/deals
• places/PLACEID/deals
• deals/DEALID
• deals/categories
• deals/cities

Checkin

Locais e pessoas se conectam naturalmente. Essas chamadas deixam o usuário fazer um checkin (isto é, dizer onde está), saber onde qualquer usuário esteve e quem esteve num local.

• users/USERID/visits
• places/PLACEID/visitors
• places/PLACEID/nearbyusers
• search/users/bypoint

Informações por Categoria

Locais que possuem informações específicas de suas categorias retornam as mesmas no atributo extended se a busca for filtrada pela categoria (ou quando se pede detalhes do local). Veja os exemplos de retorno:

• Preços de Combustíveis - categoria "Postos de Combustível" (65).
• Informações de Radares - categoria "Radares" (85).

Em breve teremos informações para outras categorias, fique atento!