Saltar al contenido principal

Developers

Developers, dentro de Settings, puede incluir tarjetas Plugins, Webhooks y API Keys. El acceso se limita al nivel 0 y también puede depender de una condición independiente del grupo.

Descripción general de Developers con tarjetas Plugins, Webhooks y API Keys

Tarjetas y estado de consulta​

La vista Developers usa tres tarjetas —Plugins, Webhooks y API Keys— y representa la seleccionada con ?category=developers&id=:id. Las pestañas disponibles pueden variar según la configuración del proyecto.

Al abrir Webhooks pueden cargarse los registros existentes. El formulario puede recoger una URL, activador y demora; Add webhook crea un registro y la eliminación confirmada quita uno. Las operaciones de actualización y despacho manual pueden estar disponibles mediante la API aunque no aparezcan en esta pantalla.

A diferencia de los webhooks propios de un negocio, los webhooks configurados aquí son globales: supervisan eventos de todo el proyecto en vez de un único negocio. Por eso pueden servir para sincronizar en tiempo real datos del proyecto con un CRM, ERP o base de datos externos. Configura un activador para enviar datos a una URL de destino cuando ocurra una acción específica, como crear un pedido o asignar un conductor. Consulta Configurar webhooks para conocer el procedimiento completo.

Tarjeta Webhooks con la lista de webhooks globales configurados
Límite de entrega de webhooks

Un registro de webhook contiene un destino y la selección de eventos que pueden generar envíos externos. Antes de guardarlo, revisa la URL receptora, el payload, la seguridad y los requisitos para compartir datos. La configuración sola no confirma que se entregue nada.

API keys​

El área API Keys puede estar disponible para cuentas de nivel 0 o 2 sin ampliar el acceso al resto de Developers. Puede mostrar valores de claves existentes y ofrecer acciones para copiar, crear y eliminar. Estos controles no confirman por sí solos el alcance, validez, creación, revocación o autorización de una clave.

Una API key conecta directamente una aplicación externa, con autenticación, a la API de Ordering.co sin solicitar un inicio de sesión manual del usuario en cada petición. Trátala como una contraseña: según su autorización, puede dar acceso a datos del proyecto. Consulta Crear una API key para ver cómo generarla. Si una clave queda comprometida, abre el menú Actions, elimínala y genera otra inmediatamente.

Tarjeta API Keys con una lista de claves generadas
Secretos

No incluyas nunca claves, tokens, encabezados, URL, identificadores de usuario ni respuestas de proveedores en capturas o materiales compartidos. Trata todos esos valores como secretos.

Plugins​

Plugins abre una barra lateral de gestión específica del proyecto respaldada por una lista de plugins. Los plugins devueltos, sus ajustes, credenciales, efectos de proveedores, instalación y comportamiento pueden variar según el proyecto y la configuración del proveedor.

Los plugins amplían la API de Ordering.co con funciones personalizadas, pasarelas de pago específicas o comportamientos automáticos. Se puede explorar e instalar un plugin del sistema —por ejemplo, uno que acepte pedidos automáticamente o un plugin de pasarela como MercadoPago, Credomatic o Computop— o seleccionar Add new plugin para cargar o enlazar código propio desarrollado.

Tarjeta Plugins con opciones de plugins del sistema y personalizados Lista de plugins instalados con la opción Add new plugin

Recomendaciones para desarrolladores​

Prueba cualquier plugin o webhook nuevo en un entorno de staging antes de habilitarlo en un proyecto activo. La instalación de plugins y la generación de claves pueden tener efecto inmediato, así que revisa el procedimiento relacionado y la política del proyecto antes de usarlos. Para consultar el detalle de solicitudes y respuestas por endpoint, ve a Usar la API de Ordering.co y API Reference.

Límites operativos​

  • /all-settings está limitado al nivel 0 y tiene una condición de grupo independiente; API Keys puede tener una condición de acceso propia para niveles 0 y 2, sin ampliar el acceso a la ruta.
  • Los endpoints y etiquetas de la interfaz no confirman por sí solos autorización, entrega, validez o revocación de claves, comportamiento del proveedor ni éxito.
  • Antes de habilitar un plugin, webhook o clave, usa un entorno no productivo aprobado, evita exponer credenciales o datos de producción y confirma el resultado esperado.

Guías relacionadas: Integrations (analytics y chat en vivo) · Registros de Settings · Descripción general de Settings

Procedimientos relacionados​