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.