Saltar al contenido
AchaduDevelopers
Achadu/Developers/Conceptos

Un modelo predecible para toda la operación.

Antes de llamar a los puntos finales, comprenda cómo se relacionan entre sí la cuenta, los recursos, los estados y los eventos. El mismo modelo se aplica a REST, MCP y CLI.

Recursos e identidad

Cada clave pertenece a una única cuenta. Las identificaciones son opacas, estables y sólo tienen sentido dentro de esa cuenta; nunca derive significado del prefijo o tamaño.

Cuenta

La raíz de las ofertas, audiencia, tienda, integraciones e ingresos.

oferta

El producto encontrado o creado antes de cualquier publicación.

Publicación

Un intento rastreable de distribuir una oferta a un destino.

Contacto y conversación

El historial de personas y servicios en DU Inbox.

viaje

El flujo versionable que reacciona a eventos y realiza acciones.

recibiendo

Comprobantes conciliables de comisión y pago.

Estados y transiciones

Las operaciones asincrónicas devuelven el estado actual, no una promesa de finalización inmediata. Sigue la cronología o suscríbete al evento correspondiente.

1
Creado

La apelación ha sido aceptada y se le ha dado una identificación.

2
En procesamiento

La cola dedicada realiza la tarea fuera de la solicitud HTTP.

3
Completado o fallido

El resultado, pruebas y errores están disponibles para auditoría.

Faltan fechas, valores y campos

identificacionesCadenas opacas como off_..., pub_... y conv_...
FechasISO 8601 en UTC, por ejemplo 2026-08-31T18:20:00.000Z
dineroNúmero decimal acompañado de moneda en ISO 4217
Campos opcionalesSe pueden omitir; nulo representa ausencia conocida
booleanosUtilice verdadero o falso, nunca 0, 1 o texto

Consistencia y efectos secundarios.

Lecturas inmediatas

CRUD y la configuración reflejan la grabación comprometida con la misma cuenta.

Procesamiento asincrónico

La publicación, importación, sincronización y ejecución pueden continuar después de la respuesta.

Eventos después del compromiso

El webhook se pone en cola solo después de que el cambio persiste.

Eliminación explícita

Los puntos finales destructivos están marcados en la referencia y nunca se infieren mediante una actualización.