Generar Token de Autenticación

POSThttps://{environment}.metrocuadrado.com/oauth2/tokens

Genera un token JWT para autenticar las demás peticiones a la API.

Ambientes Disponibles

Ambiente	URL
Desarrollo	https://ptec-core-dev-third-party-apis.metrocuadrado.com/v1/api/core/oauth2/tokens
Producción	https://third-party-apis.metrocuadrado.com/v1/api/core/oauth2/tokens

Parámetros

Headers

Header	Valor	Requerido	Descripción
Content-Type	application/json	Sí	Tipo de contenido
x-api-key	string	Sí	API key de autenticación

Body

{
  "username": "string", // Email de la inmobiliaria
  "password": "string", // Contraseña
  "identification": "string" // Número de identificación
}

Ejemplos

Request

curl -X POST \
  'https://ptec-core-dev-third-party-apis.metrocuadrado.com/v1/api/core/oauth2/tokens' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: YOUR_API_KEY' \
  -d '{
    "username": "inmobiliaria@ejemplo.com",
    "password": "contraseña123",
    "identification": "123456789"
  }'

200 OK

{
  "data": {
    "id_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
    "token_type": "Bearer",
    "expires_in": 3600
  }
}

406 Unauthorized

{
  "error": "Credenciales inválidas"
}

Notas Importantes

• El token generado tiene una validez de 1 hora
• Guarda el token de forma segura, lo necesitarás para el resto de endpoints
• No compartas tu API Key ni tu token con terceros
• En caso de error, verifica que las credenciales sean correctas
• Este endpoint NO requiere token JWT, solo API Key

Cómo Probar

Para probar este endpoint, sigue estos pasos:

1. Asegúrate de tener las credenciales correctas (username, password, identification)
2. Usa la API Key correcta según el ambiente
3. Envía la petición POST con los datos en el body
4. Guarda el token devuelto para usar en otros endpoints

Códigos de Respuesta

Código	Descripción
200	Token generado exitosamente
406	Credenciales inválidas

Probar Endpoint

API Tester

Prueba los endpoints de forma interactiva

Ambiente: DesarrolloProducción

Request Body (JSON):

{ "username": "", "password": "", "identification": "" }