Saltar al contenido

API operativaIr al sitio web ↗

Panel de control →

Achadu/Developers/Referencia API

REFERENCIA API

Toda la operación pública, punto por punto.

Contrato REST v1 con JSON, paginación uniforme, filtros predecibles y OpenAPI listo para generar clientes.

Base y formato

BASE URLhttps://achadu.com/api/v1OpenAPI ↗

FormatoJSON UTF-8

AutenticaciónBearer token

Versiónv1 na URL

Límite predeterminado30 itens

Límite máximo100 itens

ContratoOpenAPI 3.1.2

Todos los puntos finales

Las 121 operaciones siguientes están disponibles en producción y utilizan la misma auditoría de cuentas.

Operación de búsqueda

121 operaciones encontradas

GET/mecuentaVer cuentaDevuelve la operación y el actor vinculado a la clave.account:read→GET/offersOfertasListar ofertasEnumere ofertas con filtros de estado, mercado y texto.offers:read→POST/offersOfertasCrear ofertaCrea una oferta pendiente sin publicarla.offers:write→GET/offers/{id}OfertasVer ofertaDevuelve los detalles editoriales y comerciales de una oferta.offers:read→PATCH/offers/{id}OfertasOferta de actualizaciónActualiza solo los campos enviados.offers:write→DELETE/offers/{id}OfertasOferta de archivoElimina la oferta del flujo activo sin borrar el historial.offers:write→POST/offers/{id}/previewOfertasVista previa de publicaciónArmar el mensaje final sin enviarlo a ningún canal.offers:read→POST/offers/{id}/publishOfertasPublicar ofertaPone en cola la publicación de la oferta en un grupo o hilo autorizado.publications:write→GET/groupsGruposListar gruposEnumera grupos sin exponer JID, sesiones o credenciales.groups:read→GET/groups/{id}GruposVer grupoDevuelve la configuración operativa segura del grupo.groups:read→PATCH/groups/{id}GruposGrupo de actualizaciónActualiza nombre, segmento, capacidad y automatización.groups:write→GET/segmentsSegmentosSegmentos de listaEnumere nichos y configuraciones de escaparates.segments:read→POST/segmentsSegmentosCrear segmentoCree un nicho con la configuración de su escaparate.segments:write→GET/segments/{id}SegmentosVer segmentoDevuelve un segmento de la operación.segments:read→PATCH/segments/{id}SegmentosActualizar segmentoActualiza la identidad, distribución y escaparate del segmento.segments:write→DELETE/segments/{id}SegmentosEliminar segmentoSe elimina solo cuando no hay grupos o calendarios vinculados.segments:write→GET/couponsCuponesListar cuponesLista cupones activos y verificados para la operación.coupons:read→POST/couponsCuponesCrear cupónRegistre un cupón para usarlo en ofertas.coupons:write→GET/coupons/{id}CuponesVer cupónReglas de devoluciones y validez de un cupón.coupons:read→PATCH/coupons/{id}CuponesActualizar cupónActualizaciones de validez, descuento y elegibilidad.coupons:write→DELETE/coupons/{id}CuponesArchivar cupónDesactiva el cupón conservando su historial.coupons:write→GET/commissionsComisionesLista de comisionesEnumera las comisiones asignadas a la cuenta.commissions:read→GET/commissions/summaryComisionesResumir comisionesAgrupa importes por moneda y estado de pago.commissions:read→GET/commissions/{id}ComisionesVer comisiónAsignación de devoluciones y conciliación de una comisión.commissions:read→GET/publicationsPublicacionesLista de publicacionesLista de envíos con filtros por estado, grupo y oferta.publications:read→GET/publications/{id}PublicacionesVer publicaciónDevuelve el resultado de una publicación sin exponer la sesión del canal.publications:read→GET/templatesPlantillasPlantillas de listaEnumere las plantillas editoriales para la cuenta.templates:read→POST/templatesPlantillasCrear plantillaCrea una plantilla de publicación reutilizable.templates:write→GET/templates/{id}PlantillasVer plantillaDevuelve el cuerpo y la configuración de una plantilla.templates:read→PATCH/templates/{id}PlantillasActualizar plantillaActualiza los campos enviados desde la plantilla.templates:write→DELETE/templates/{id}PlantillasEliminar plantillaElimina una plantilla no utilizada por los horarios.templates:write→GET/schedulesHorariosListar citasEnumera publicaciones futuras y recurrentes.schedules:read→POST/schedulesHorariosCrear horarioOferta del programa o mensaje de texto para una fecha ISO.schedules:write→GET/schedules/{id}HorariosVer horarioDevuelve destino, contenido y recurrencia.schedules:read→PATCH/schedules/{id}HorariosCalendario de actualizaciónCambiar hora, destino, recurrencia o estado.schedules:write→DELETE/schedules/{id}HorariosEliminar horarioCancela y elimina una programación futura.schedules:write→POST/schedules/{id}/runHorariosprograma de ejecuciónAhora ejecuta la misma rutina segura que el programador.publications:write→GET/monitorsMonitoresLista de radaresEnumera las reglas de descubrimiento automático de ofertas.monitors:read→POST/monitorsMonitoresCrear radarCrear una búsqueda recurrente con criterios comerciales.monitors:write→GET/monitors/{id}MonitoresVer radaresDevuelve criterios y último resultado de una regla.monitors:read→PATCH/monitors/{id}MonitoresActualizar radarCriterios de actualización, frecuencia y automatización.monitors:write→DELETE/monitors/{id}MonitoresEliminar radarElimina una regla de supervisión.monitors:write→GET/storeTiendaVer tiendaDevuelve sólo la configuración pública de la tienda.store:read→PATCH/storeTiendaActualizar tiendaActualizaciones de la tienda de identidad, tema, redes y privacidad.store:write→GET/journeysViajesListar viajesEnumera los flujos de DU y el rendimiento agregado.journeys:read→POST/journeysViajesCrear viajeCrea una automatización visual inicialmente segura.journeys:write→GET/journeys/{id}Viajesver recorridoDevuelve bloques de viaje, canales y métricas.journeys:read→PATCH/journeys/{id}ViajesViaje de actualizaciónActualiza el gráfico y las reglas de viaje.journeys:write→DELETE/journeys/{id}ViajesEliminar viajeExcluye únicamente los viajes que nunca se han realizado.journeys:write→POST/journeys/{id}/activateViajesActivar viajeActivar o pausar un viaje existente.journeys:write→GET/inbox/conversationsBandeja de entradaListar conversacionesEnumera los metadatos operativos de DU Inbox.inbox:read→GET/inbox/conversations/{id}Bandeja de entradaVer conversaciónDevuelve el contexto de la conversación sin datos de contacto directo.inbox:read→PATCH/inbox/conversations/{id}Bandeja de entradaActualizar conversaciónAsigna, prioriza o cambia el modo DU.inbox:write→POST/inbox/conversations/{id}/closeBandeja de entradaFinalizar conversaciónFinalice la conversación y registre el evento.inbox:write→GET/inbox/conversations/{id}/messagesBandeja de entradaListar mensajesMuestra el historial paginado de una conversación.inbox:read→POST/inbox/conversations/{id}/replyBandeja de entradaPreparar respuestaRegistra una respuesta de salida para su entrega por el conector de canal.inbox:write→GET/inbox/contactsBandeja de entradaLista de contactosEnumere su perfil, pasantías e intereses sin revelar su número de teléfono o correo electrónico.inbox:read→GET/analytics/summaryAnalíticaResumen de análisisConsolida ofertas, publicaciones, clics y comisiones.analytics:read→GET/analytics/timeseriesAnalíticaSerie de tiempoAgrupa publicaciones, fallos y clics por día.analytics:read→GET/analytics/groupsAnalíticaActuación por grupoCompara volumen, entrega y error entre grupos.analytics:read→GET/analytics/offersAnalíticaRendimiento por ofertaOrdena ofertas por publicación, clic y comisión.analytics:read→GET/analytics/sourcesAnalíticaRendimiento por fuenteCatálogo de grupos, clics e ingresos por mercado.analytics:read→GET/analytics/heatmapAnalíticaMapa de calor de interacciónAgrega clics por página, elemento, día y hora.analytics:read→POST/links/convertEnlacesConvertir enlaceConvierte una URL usando solo las integraciones de esta cuenta.links:write→GET/webhooksGanchos webListar webhooksLista de destinos y eventos, nunca el secreto.webhooks:read→POST/webhooksGanchos webCrear webhookCrea un destino HTTPS y revela el secreto una vez.webhooks:write→GET/webhooks/{id}Ganchos webVer webhookDevuelve la configuración segura del objetivo.webhooks:read→PATCH/webhooks/{id}Ganchos webActualizar webhookActualice la URL, los eventos o el estado sin cambiar el secreto.webhooks:write→DELETE/webhooks/{id}Ganchos webEliminar webhookElimina el destino y el historial de entrega.webhooks:write→GET/webhooks/{id}/deliveriesGanchos webListar entregasEnumera intentos, estado HTTP y errores de entrega.webhooks:read→POST/groupsGruposCrear destino de grupoRegistra un grupo ya autorizado por el conector de cuenta.groups:write→DELETE/groups/{id}Gruposgrupo de archivoDesactiva el destino sin borrar el historial de publicaciones.groups:write→GET/groups/{id}/activityGruposConsultar actividad del grupoResumir entradas, salidas y publicaciones sin revelar participantes.groups:read→POST/publications/{id}/retryPublicacionesReintentar publicaciónCrea un reintento para una publicación fallida.publications:write→POST/publications/{id}/cancelPublicacionesDespublicarCancela una publicación pendiente sin eliminar el historial.publications:write→GET/publications/{id}/attemptsPublicacionesListar intentos de publicaciónEnumera el cronograma seguro de creación, error, reintento y cancelación.publications:read→POST/commissions/importsComisionesComisiones de importación en CSVNormaliza un CSV, elimina transacciones duplicadas y genera un recibo auditable.commissions:write→GET/commissions/importsComisionesListar importaciones de comisionesListar recibos de importación sin incluir credenciales.commissions:read→GET/commissions/imports/{id}ComisionesVer importación de comisionesRecuento de devoluciones, errores normalizados y origen de una importación.commissions:read→POST/commissions/syncComisionesComisiones de sincronizaciónConsulta solo conectores autorizados y registra un recibo por fuente.commissions:write→GET/commissions/receiptsComisionesListar recibosEnumera los créditos financieros y el estado de conciliación.commissions:read→POST/commissions/receiptsComisionesrecibo de registroRegistra un crédito recibido sin tratarlo automáticamente como una comisión.commissions:write→GET/commissions/receipts/{id}ComisionesVer reciboDevuelve el recibo y las comisiones conciliadas.commissions:read→POST/commissions/receipts/{id}/reconcileComisionesConciliar reciboSelecciona o recibe automáticamente las comisiones que forman el crédito.commissions:write→POST/monitors/{id}/runMonitoresEjecute el radar ahoraEjecuta una ronda del radar y el resultado observado persiste.monitors:write→GET/monitors/{id}/resultsMonitoresConsultar resultados de radarDevuelve la última ronda y ofertas originadas por este radar.monitors:read→GET/store/collectionsTiendaListar colecciones de tiendasEnumera las colecciones editoriales y su orden público.store:read→POST/store/collectionsTiendaCrear colección de tiendaCrea una colección publicable de ofertas.store:write→GET/store/collections/{id}TiendaVer colección de la tiendaDevuelve el contenido y la configuración de una colección.store:read→PATCH/store/collections/{id}TiendaActualizar colección de la tiendaLas actualizaciones solo enviaron campos de la colección.store:write→DELETE/store/collections/{id}TiendaEliminar colección de la tiendaEliminar la colección sin borrar las ofertas.store:write→GET/store/pagesTiendaListar páginas de tiendaEnumere las páginas de destino y el contenido editorial de la tienda.store:read→POST/store/pagesTiendaCrear página de tiendaCrea una página en Markdown con su propio SEO.store:write→GET/store/pages/{id}TiendaVer página de la tiendaDevuelve contenido, SEO y estado de publicación.store:read→PATCH/store/pages/{id}TiendaActualizar la página de la tiendaActualiza contenido, slug, SEO o publicación.store:write→DELETE/store/pages/{id}TiendaEliminar página de la tiendaElimina una página separada de la tienda.store:write→GET/inbox/contacts/{id}Bandeja de entradaVer contactoDevuelve perfil, etiquetas y actividad sin identificadores directos.inbox:read→PATCH/inbox/contacts/{id}Bandeja de entradaActualizar contactoActualiza el nombre, la etapa, las etiquetas y las preferencias autorizadas.inbox:write→GET/inbox/contacts/{id}/notesBandeja de entradaListar notas de contactoEnumera notas internas con autor y fecha.inbox:read→POST/inbox/contacts/{id}/notesBandeja de entradaCrear nota en contactoGraba una nota interna que nunca se envía al contacto.inbox:write→POST/inbox/conversations/{id}/assignBandeja de entradaAsignar conversaciónAsigna o elimina al responsable de la conversación.inbox:write→POST/inbox/conversations/{id}/reopenBandeja de entradaReabrir conversaciónVuelve a abrir una conversación cerrada y registra el evento.inbox:write→GET/inbox/messages/{id}Bandeja de entradaVer mensajeDevuelve el contenido y el estado operativo de un mensaje.inbox:read→GET/inbox/messages/{id}/statusBandeja de entradacomprobar la entrega de mensajesDistinga preparado, en cola, enviado, entregado y fallido.inbox:read→POST/journeys/{id}/validateViajesValidar viajeComprueba disparadores, bloques, canales y referencias sin ejecutar el flujo.journeys:read→POST/journeys/{id}/executeViajescorrer viajeInicia una ejecución explícita para un contacto o conversación autorizados.journeys:write→GET/journeys/{id}/executionsViajesListar ejecuciones de viajeListar estado, paso y tiempos de ejecuciones.journeys:read→GET/journey-executions/{id}ViajesVer ejecución del viajeDevuelve la ejecución y su contexto operativo seguro.journeys:read→GET/webhook-eventsGanchos webListar eventos de webhookDevuelve el catálogo versionado de eventos y descripciones.webhooks:read→GET/webhook-events/{event}/schemaGanchos webVer esquema de eventosDevuelve el esquema JSON y un ejemplo del evento en la versión actual.webhooks:read→POST/webhooks/{id}/rotate-secretGanchos webGirar el secreto del webhookInvalida el secreto anterior y revela el nuevo una sola vez.webhooks:write→POST/webhooks/{id}/testGanchos webWebhook de pruebaPone en cola un evento de prueba firmado hasta el destino.webhooks:write→POST/webhook-deliveries/{id}/redeliverGanchos webReenviar la entrega del webhookCrea un reintento auditable para un entregable existente.webhooks:write→GET/integrationsIntegracionesListar integracionesEnumera los conectores y el estado seguro, sin devolver credenciales.integrations:read→GET/integrations/{provider}IntegracionesVer integraciónDevuelve la capacidad, el estado y la última validación de un conector.integrations:read→GET/integrations-healthIntegracionesComprobar el estado de la integraciónResume los conectores que están configurados, en buen estado y que necesitan atención.integrations:read→POST/integrations/{provider}/testIntegracionesValidar integraciónValida la configuración disponible y registra el diagnóstico.integrations:write→DELETE/integrations/{provider}IntegracionesDesconectar la integraciónElimina las credenciales del conector para el actor clave.integrations:write→GET/analytics/funnelAnalíticaAnalizar embudoAgrupa impresiones, clics, intenciones, compras y comisiones por período.analytics:read→GET/analytics/revenueAnalíticaAnalizar recetaConsolida comisiones registradas y recibos conciliados por moneda.analytics:read→GET/analytics/attributionAnalíticaAnalizar la atribuciónCompara fuente, grupo, segmento y ventana de conversión.analytics:read→

Filtros y paginación.

Las colecciones aceptan límite y compensación. Las ofertas, publicaciones, conversaciones y análisis tienen filtros adicionales descritos en OpenAPI.

offersstatus, marketplace, query

publicationsstatus, group_id, offer_id

inbox/conversationsstatus, channel

analytics/*days: 1–365

Crear una oferta pendiente

La creación es idempotente en URL. Una URL existente devuelve el elemento actual; nada se publica automáticamente.

bash

curl -X POST https://achadu.com/api/v1/offers \
  -H "Authorization: Bearer ach_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.amazon.com.br/dp/...",
    "title": "Air fryer 5L",
    "price": 329.90,
    "currency": "BRL",
    "coupon": "CASA10"
  }'