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 70 operaciones siguientes están disponibles en producción y utilizan la misma auditoría de cuentas.

Operación de búsqueda

70 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→

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"
  }'