Use este webservice para solicitar um access token.
Expiração do token e fluxo recomendado
Os access tokens expiram a cada 14 dias por padrão (a duração pode variar por cliente — verifique expires_in na resposta). Quando um token expira ou seu app o perde, qualquer chamada retornará um erro HTTP 403. Nesse caso seu app deve chamar este método /authorize novamente para obter um novo token e continuar a operação original. Você também pode gerar um token manualmente em https://mapaprop.github.io.
URL do recurso
https://mapaprop.app/api/action/oauth2-v1/authorize
Parâmetros
| Key | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| client_id | string | sim | O CLIENT ID fornecido pelo Mapaprop |
| client_secret | string | sim | O CLIENT SECRET fornecido pelo Mapaprop |
| grant_type | string | sim | Use o texto constante client_credentials |
Código de exemplo
POST /api/action/oauth2-v1/authorize HTTP/1.1
Host: mapaprop.app
Content-Type: application/x-www-form-urlencoded
Content-Length: 0
client_id=jfioejweu8wu9fjsHUGldfja9ofwjf&client_secret=UHY&T&FOIHuihd8w2hg3kh8Y&grant_type=client_credentials
Resposta
Você deve fazer o parse da resposta JSON para obter seu access token.
| Objeto | Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|---|
| Response | accessToken | string | sim | O access token necessário para autenticação |
| access_token | string | sim | Mesmo valor que accessToken (alias em snake_case) | |
| tokenType | string | sim | Sempre Bearer | |
| expires_in | int | sim | Segundos até o token expirar (padrão 1209600 = 14 dias; pode variar por cliente) |
Código de exemplo
{
"accessToken": "7147c222b5989488fd14d28d20e099b0",
"access_token": "7147c222b5989488fd14d28d20e099b0",
"tokenType": "Bearer",
"expires_in": 1209600
}