Rutas públicas (ES-ES)

Descripción del uso de rutas públicas de la API de Lighthouse

---

Documentación de la API

URL base

https://api.piercloud.io

Autenticación del cliente HTTP

Todos los clientes HTTP deben estar registrados en la plataforma Pier Cloud para obtener las credenciales de acceso. Para más información, visite el enlace.

---

Autenticación

1. Generar token de acceso

Generar un token de acceso para el cliente HTTP.

• URL: /auth

• Método: POST

• Descripción: Retorna el token de acceso y otra información a partir de las credenciales proporcionadas.

Headers

Nombre	Tipo	Obligatorio	Descripción
Content-Type	string	Sí	Debe ser application/json

Body

{
  "client_id": "string",
  "client_secret": "string"
}

Ejemplo de Solicitud

curl -X POST https://api.piercloud.io/auth \
     -H "Content-Type: application/json" \
     -d '{
           "client_id": "client_id",
           "client_secret": "client_secret",
         }'

Respuesta Exitosa (201 Created)

{
  "code": "success",
  "data": {
    "access_token": "Token JWT",
    "expires_in": "Tiempo de expiración en segundos",
    "refresh_expires_in": 0,
    "token_type": "Bearer",
    "not-before-policy": 0,
    "session_state": "",
    "scope": "Lista de permisos de acceso del cliente HTTP"
  }
}

Respuesta de Error (400 Bad Request)

{
  "code": "bad-request/invalid-parameters",
  "message": "mensaje de error"
}

Respuesta de Error (401 Unauthorized)

{
  "code": "failed",
  "message": "token inválido o expirado"
}

---