Ir al contenido principal
Laravel, shipping fast.

Apéndice D

Glosario

Julian Beaujardin

Los términos que el código y la documentación de Laravel usan en inglés llevan ese nombre entre paréntesis.

Binding con ámbito (scoped binding). Un binding del contenedor que vive durante una petición o un job.

Binding de ruta con ámbito (scoped route binding). Un parámetro de una ruta anidada que debe pertenecer a su padre. No es una comprobación de autorización.

Borrado lógico (soft delete). Marcar una fila como borrada sin eliminarla, para que pueda restaurarse.

Clave de idempotencia (idempotency key). Un valor que un consumidor envía con una petición para que los reintentos de la misma operación se reconozcan.

Clave natural (natural key). Un valor del mundo real que identifica una cosa, como un nombre de dominio.

Consumidor (consumer). Un sistema que llama a la API. En este libro, también el modelo de Eloquent que representa a uno.

Contrato. O bien una interfaz en el código, o bien la promesa que una API les hace a sus consumidores sobre las peticiones y las respuestas.

Cortacircuitos (circuit breaker). Una guarda que deja de llamar a una dependencia tras fallos repetidos, durante un rato, y falla rápido.

Data transfer object. Véase objeto tipado.

Driver. Una implementación de un contrato para un proveedor.

Entrega «al menos una vez» (at-least-once delivery). La garantía que da una cola: un job se ejecuta una o más veces, nunca cero. La razón por la que todo job debe ser seguro de ejecutar dos veces.

Espera entre reintentos (backoff). El tiempo que se deja pasar entre un reintento y el siguiente. Suele crecer con cada intento.

Facade. Un punto de entrada de aspecto estático a un objeto del contenedor.

FormRequest. Una clase que valida y autoriza una petición antes de que se ejecute el controlador.

Gate. Una comprobación de autorización con nombre que no está ligada a un modelo.

Habilidad (ability). Un permiso con nombre asociado a un token, como licenses:write. Decide lo que un token puede hacer.

Hoja (leaf). Un servicio que es dueño de un proveedor externo y al que llama el hub.

Hub. El único servicio que orquesta el trabajo entre varios otros.

Huella (fingerprint). Un hash de una petición, que sirve para saber si dos peticiones con la misma clave de idempotencia son de verdad la misma.

ID de traza (trace ID). Un valor adjunto a cada línea de log de una operación, a través de peticiones, jobs y servicios.

Idempotente. Seguro de repetir. Hacerlo dos veces deja el mismo estado que hacerlo una.

Latido (heartbeat). Una señal que se envía después de que una tarea sale bien, para que su ausencia pueda dar la alarma.

Lote (batch). Un grupo de jobs encolados que se despachan juntos, con un progreso compartido.

Manager. La clase base de Laravel para elegir entre varios drivers. Esta API tiene un solo driver y no la usa.

Objetivo de nivel de servicio (service level objective). Una meta para una medida a lo largo de una ventana, acordada de antemano.

Objeto tipado (typed object). Una clase pequeña e inmutable que contiene datos que vinieron de fuera de tu base de datos. A menudo se la llama data transfer object.

Operador. Quien llama con un token que tiene la habilidad consumers:manage.

Policy. Una clase que decide sobre qué registros puede actuar quien llama.

Presupuesto de error (error budget). La cantidad de fallo que permite un objetivo a lo largo de su ventana.

Proveedor. Un servicio externo del que depende esta API. En este libro, Statamic.

Resource. Una clase que convierte un objeto en el JSON que ve un consumidor.

Retirada (sunset). La fecha a partir de la cual una versión obsoleta de la API deja de responder.

Sobre (envelope). La estructura exterior de una respuesta. En esta API, una clave data.

Webhook. Una petición que esta API envía a la URL de un consumidor cuando pasa algo.

No se pudo cargar el audio. Inténtalo de nuevo en un momento.