Invocando Funciones Lambda

HolaCloud Lambda soporta llamadas administrativas directas, llamadas públicas, rutas mux por propietario y un pequeño conjunto de endpoints de inspección del servicio.

Invocación Administrativa

Usa /api/v0/run/{lambda_id} cuando el cliente pueda enviar X-Glue-Authentication. El endpoint acepta cualquier método HTTP.

1curl -X POST "https://api.hola.cloud/api/v0/run/TU_LAMBDA_ID" \
2  -H "X-Glue-Authentication: TU_TOKEN" \
3  -H "Content-Type: application/json" \
4  -d '{
5    "key": "value"
6  }'

Invocación Pública

Usa /run/{lambda_id} para webhooks, llamadas desde navegador y otros clientes que no deben enviar credenciales administrativas. El endpoint acepta cualquier método HTTP.

1curl -X POST "https://api.hola.cloud/run/TU_LAMBDA_ID" \
2  -H "Content-Type: application/json" \
3  -d '{
4    "key": "value"
5  }'

La lambda recibe los datos de solicitud mediante req, incluyendo método, path, headers, valores de query y body.

Uso como Webhook

Configura un servicio externo para enviar eventos a:

1https://api.hola.cloud/run/TU_LAMBDA_ID

Ejemplo de manejador de webhook:

1export default (req) => {
2  return {
3    body: {
4      received: true,
5      event: req.headers["x-github-event"],
6      payload: req.body
7    }
8  };
9};

Mux Router

El mux router reenvía rutas por propietario mediante /mux/{owner_id}/*. Acepta cualquier método HTTP.

1curl -X GET "https://api.hola.cloud/mux/OWNER_ID/cualquier/ruta/aqui"

El owner_id identifica al propietario de HolaCloud. El resto del path se reenvía a la lógica de rutas de la lambda.

Invocaciones en Curso

Consulta las invocaciones que se están ejecutando:

1curl "https://api.hola.cloud/ongoing"

Usuario Actual

El endpoint /me devuelve información del usuario autenticado:

1curl "https://api.hola.cloud/me" \
2  -H "X-Glue-Authentication: TU_TOKEN"

Especificación OpenAPI

HolaCloud expone el documento OpenAPI de Lambda en:

1GET https://api.hola.cloud/openapi