Usa este webservice para solicitar un access token.
Expiración del token y flujo recomendado
Los access tokens expiran cada 14 días por defecto (la duración puede variar según el cliente — verificá expires_in en la respuesta). Cuando un token expira o tu app lo pierde, cualquier llamada devolverá un error HTTP 403. En ese caso tu app debe llamar nuevamente a este método /authorize para obtener un nuevo token y continuar con la operación original. También podés generar un token manualmente en https://mapaprop.github.io.
URL del recurso
https://mapaprop.app/api/action/oauth2-v1/authorize
Parámetros
| Key | Tipo | Requerido | Descripción |
|---|---|---|---|
| client_id | string | sí | El CLIENT ID proporcionado por Mapaprop |
| client_secret | string | sí | El CLIENT SECRET proporcionado por Mapaprop |
| grant_type | string | sí | Usar el texto constante client_credentials |
Código de ejemplo
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
Respuesta
Debes parsear la respuesta JSON para obtener tu access token.
| Objeto | Campo | Tipo | Requerido | Descripción |
|---|---|---|---|---|
| Response | accessToken | string | sí | El access token necesario para la autenticación |
| access_token | string | sí | Mismo valor que accessToken (alias en snake_case) | |
| tokenType | string | sí | Siempre Bearer | |
| expires_in | int | sí | Segundos hasta que el token expira (por defecto 1209600 = 14 días; puede variar según el cliente) |
Código de ejemplo
{
"accessToken": "7147c222b5989488fd14d28d20e099b0",
"access_token": "7147c222b5989488fd14d28d20e099b0",
"tokenType": "Bearer",
"expires_in": 1209600
}