Apontador developers
Sign in

Reviews


https://api.apontador.com.br/v2/places/{placeId}/reviews

Method: GET

Authorization: You can use your access_token from application or from user

Parameters:

  • wt: json(default) or xml, the API accepts this information in the request's header(i.e. "Accept: application/xml" or "Accept: application/json"). So you can use the parameter wt or use Accept header.
  • fl: (optional) specify the fields that will be returned for each result
  • {placeId}: is the place id information that you get from search result
  • rows: (optional) the default is 10 and maximum 50
  • start: (optional) the default is 0, it's used for pagination
curl -X GET -H "Accept: application/json" -H "Authorization: Bearer ACCESS_TOKEN" https://api.apontador.com.br/v2/places/X8UZ6EKY/reviews

If successful, this call will return:

	{
		"reviewResults":{
			"header":{
			"found":11,
			"rows":1,
			"start":0,
			"next":"https://api.apontador.com.br/v2/places/X8UZ6EKY/reviews/?rows=1&start=1"
			},
			"reviews":[
				{
					"id":"197627",
					"link":{"rel":"self","uri":"https://api.apontador.com.br/v2/reviews/197627"},
					"text":"É a melhor opção de passeio para o domingo pela manhã em Curitiba, está sempre lotada com muitos moradores e principalmente turistas. Já éum programa tradicional para fazer umas compras e depois tomar aquela cervejinha.",
					"statistics":{
						"rating":"5",
						"thumbsUp":"0",
						"reportAbuse":"0"
					},
					"creation":{
						"author":{
							"id":"2452498672",
							"link":{"rel":"self","uri":"https://api.apontador.com.br/v2/users/2452498672"},
							"name":"Luis Henrique Krauser",
							"photo":"http://aptuser.s3.amazonaws.com/2452498672_m.png"
						},
						"created":1279651697000
					},
				"place":{
					"id":"X8UZ6EKY",
					"name":"Feira do Largo da Ordem",
					"link":{"rel":"/linkrels/search/getByPlaceId","uri":"https://api.apontador.com.br/v2/places/X8UZ6EKY"}
				}
			}]
		}
	}
	
			
https://api.apontador.com.br/v2/places/{placeId}/reviews

Method: POST

Authorization: You can use your access_token from application or from user

Parameters:

  • xml or json in request body: 
  • {
  "review": {
    "text": "review text",
    "statistics": { "rating": "review rating" }
  }
}
curl -v -X POST -H "Accept: application/json" -H "Content-Type: application/json" -H "Authorization: Bearer ACCESS_TOKEN" -d "{"review": {"text": "review text","statistics": { "rating": "review rating" }}}" https://api.apontador.com.br/v2/places/C4037652224C3E4C3E/reviews

If successful, this call will just return a HTTP_STATUS_CODE: 201 that represents Created

https://api.apontador.com.br/v2/reviews/{reviewId}/thumbsUp

Method: POST

Authorization: You can use your access_token from user. The access_token from application is not allowed

Parameters:

  • {reviewId}: Review id

If successful, this call will just return a HTTP_STATUS_CODE: 204 Not Content