Vai al contenuto

API operativaVai al sito web ↗

Achadu/Developers/Riferimento API

RIFERIMENTO API

L'intera operazione pubblica, endpoint per endpoint.

Contratto REST v1 con JSON, impaginazione uniforme, filtri prevedibili e OpenAPI pronti per generare client.

Base e formato

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

FormatoJSON UTF-8

AutenticazioneBearer token

Versionev1 na URL

Limite predefinito30 itens

Limite massimo100 itens

ContrattoOpenAPI 3.1.2

Tutti gli endpoint

Le 70 operazioni seguenti sono disponibili in produzione e utilizzano lo stesso audit contabile.

Operazione di ricerca

70 operazioni trovate

GET/meContoVisualizza contoRestituisce l'operazione e l'attore collegati alla chiave.account:read→GET/offersOfferteElenco offerteElenca le offerte con filtri di stato, marketplace e testo.offers:read→POST/offersOfferteCrea offertaCrea un'offerta in sospeso senza pubblicarla.offers:write→GET/offers/{id}OfferteVisualizza l'offertaRestituisce i dettagli editoriali e commerciali di un'offerta.offers:read→PATCH/offers/{id}OfferteOfferta di aggiornamentoAggiorna solo i campi inviati.offers:write→DELETE/offers/{id}OfferteOfferta di archivioRimuove l'offerta dal flusso attivo senza eliminare la cronologia.offers:write→POST/offers/{id}/previewOfferteAnteprima del messaggioAssembla il messaggio finale senza inviarlo a nessun canale.offers:read→POST/offers/{id}/publishOffertePubblica offertaAccoda la pubblicazione dell'offerta a un gruppo o thread autorizzato.publications:write→GET/groupsGruppiElenca i gruppiElenca i gruppi senza esporre JID, sessioni o credenziali.groups:read→GET/groups/{id}GruppiVisualizza gruppoRestituisce la configurazione operativa protetta del gruppo.groups:read→PATCH/groups/{id}GruppiAggiorna gruppoAggiorna nome, segmento, capacità e automazione.groups:write→GET/segmentsSegmentiElenca segmentiElenca le nicchie e le configurazioni del negozio.segments:read→POST/segmentsSegmentiCrea segmentoCrea una nicchia con la configurazione della tua vetrina.segments:write→GET/segments/{id}SegmentiVisualizza segmentoRestituisce un segmento dell'operazione.segments:read→PATCH/segments/{id}SegmentiAggiorna segmentoAggiorna l'identità, la distribuzione e la vetrina del segmento.segments:write→DELETE/segments/{id}SegmentiElimina segmentoElimina solo quando non sono presenti gruppi o calendari collegati.segments:write→GET/couponsBuoniElenco couponElenca i coupon attivi e verificati per l'operazione.coupons:read→POST/couponsBuoniCrea buonoRegistra un coupon da utilizzare nelle offerte.coupons:write→GET/coupons/{id}BuoniVisualizza couponRegole di restituzione e validità di un coupon.coupons:read→PATCH/coupons/{id}BuoniAggiorna couponAggiorna validità, sconto e ammissibilità.coupons:write→DELETE/coupons/{id}BuoniCoupon d'archivioDisattiva il coupon preservandone la cronologia.coupons:write→GET/commissionsCommissioniElenco commissioniElenca le commissioni assegnate al conto.commissions:read→GET/commissions/summaryCommissioniRiepilogare le commissioniRaggruppa gli importi per valuta e stato del pagamento.commissions:read→GET/commissions/{id}CommissioniVedi commissioneRestituisce l'assegnazione e la riconciliazione di una commissione.commissions:read→GET/publicationsPubblicazioniElenco pubblicazioniElenca le spedizioni con filtri per stato, gruppo e offerta.publications:read→GET/publications/{id}PubblicazioniVisualizza la pubblicazioneRestituisce il risultato di una pubblicazione senza esporre la sessione del canale.publications:read→GET/templatesModelliElenco modelliElenca i modelli editoriali per l'account.templates:read→POST/templatesModelliCrea modelloCrea un modello di pubblicazione riutilizzabile.templates:write→GET/templates/{id}ModelliVisualizza modelloRestituisce il corpo e la configurazione di un modello.templates:read→PATCH/templates/{id}ModelliAggiorna modelloAggiorna i campi inviati dal modello.templates:write→DELETE/templates/{id}ModelliElimina modelloElimina un modello non utilizzato dalle pianificazioni.templates:write→GET/schedulesOrariElenca gli appuntamentiElenca le pubblicazioni future e ricorrenti.schedules:read→POST/schedulesOrariCrea pianificazioneOfferta di programma o testo per una data ISO.schedules:write→GET/schedules/{id}OrariVisualizza il programmaRestituisce destinazione, contenuto e ricorrenza.schedules:read→PATCH/schedules/{id}OrariAggiorna il programmaModifica l'ora, la destinazione, la ricorrenza o lo stato.schedules:write→DELETE/schedules/{id}OrariElimina pianificazioneAnnulla e rimuove una pianificazione futura.schedules:write→POST/schedules/{id}/runOrariEsegui pianificazioneOra esegue la stessa routine sicura dello scheduler.publications:write→GET/monitorsMonitoraElenca i radarElenca le regole di rilevamento automatico delle offerte.monitors:read→POST/monitorsMonitoraCrea un radarCrea una ricerca ricorrente con criteri commerciali.monitors:write→GET/monitors/{id}MonitoraVisualizza il radarRestituisce i criteri e l'ultimo risultato di una regola.monitors:read→PATCH/monitors/{id}MonitoraAggiorna il radarCriteri di aggiornamento, frequenza e automazione.monitors:write→DELETE/monitors/{id}MonitoraElimina il radarRimuove una regola di monitoraggio.monitors:write→GET/storeNegozioVisualizza il negozioRestituisce solo la configurazione pubblica del negozio.store:read→PATCH/storeNegozioAggiorna negozioGli aggiornamenti memorizzano identità, temi, reti e privacy.store:write→GET/journeysViaggiElenca i viaggiElenca i flussi DU e le prestazioni aggregate.journeys:read→POST/journeysViaggiCrea viaggioCrea un'automazione visiva inizialmente sicura.journeys:write→GET/journeys/{id}ViaggiVedi viaggioRestituisce blocchi di percorso, canali e metriche.journeys:read→PATCH/journeys/{id}ViaggiAggiorna il viaggioAggiorna il grafico e le regole di viaggio.journeys:write→DELETE/journeys/{id}ViaggiElimina viaggioSono esclusi solo i viaggi mai effettuati.journeys:write→POST/journeys/{id}/activateViaggiAttiva il viaggioAttiva o metti in pausa un viaggio esistente.journeys:write→GET/inbox/conversationsPosta in arrivoElenca le conversazioniElenca i metadati operativi della posta in arrivo DU.inbox:read→GET/inbox/conversations/{id}Posta in arrivoVisualizza conversazioneRestituisce il contesto della conversazione senza dati di contatto diretto.inbox:read→PATCH/inbox/conversations/{id}Posta in arrivoAggiorna conversazioneAssegna, dà priorità o modifica la modalità DU.inbox:write→POST/inbox/conversations/{id}/closePosta in arrivoTermina la conversazioneTermina la conversazione e registra l'evento.inbox:write→GET/inbox/conversations/{id}/messagesPosta in arrivoElenca i messaggiElenca la cronologia impaginata di una conversazione.inbox:read→POST/inbox/conversations/{id}/replyPosta in arrivoPreparare la rispostaRegistra una risposta in uscita per la consegna da parte del connettore del canale.inbox:write→GET/inbox/contactsPosta in arrivoElenca i contattiElenca il tuo profilo, stage e interessi senza rivelare il tuo numero di telefono o e-mail.inbox:read→GET/analytics/summaryAnaliticaRiepilogo dell'analisiConsolida offerte, pubblicazioni, clic e commissioni.analytics:read→GET/analytics/timeseriesAnaliticaSerie temporaliRaggruppa post, errori e clic per giorno.analytics:read→GET/analytics/groupsAnaliticaEsibizione per gruppoConfronta volume, consegna ed errore tra i gruppi.analytics:read→GET/analytics/offersAnaliticaPrestazioni per offertaOrdina le offerte per pubblicazione, clic e commissione.analytics:read→GET/analytics/sourcesAnaliticaPrestazioni per fonteCatalogo dei gruppi, clic e ricavi per marketplace.analytics:read→GET/analytics/heatmapAnaliticaMappa termica dell'interazioneAggrega i clic per pagina, elemento, giorno e ora.analytics:read→POST/links/convertCollegamentiConverti collegamentoConverte un URL utilizzando solo le integrazioni di questo account.links:write→GET/webhooksWebhookElenca webhookElenca destinazioni ed eventi, mai il segreto.webhooks:read→POST/webhooksWebhookCrea webhookCrea una destinazione HTTPS e rivela il segreto una volta.webhooks:write→GET/webhooks/{id}WebhookVisualizza webhookRestituisce la configurazione sicura della destinazione.webhooks:read→PATCH/webhooks/{id}WebhookAggiorna webhookAggiorna URL, eventi o stato senza modificare il segreto.webhooks:write→DELETE/webhooks/{id}WebhookElimina webhookRimuove la destinazione e la cronologia delle consegne.webhooks:write→GET/webhooks/{id}/deliveriesWebhookElencare le consegneElenca i tentativi, lo stato HTTP e gli errori di consegna.webhooks:read→

Filtri e impaginazione

Le raccolte accettano limite e offset. Offerte, pubblicazioni, conversazioni e analisi hanno filtri aggiuntivi descritti in OpenAPI.

offersstatus, marketplace, query

publicationsstatus, group_id, offer_id

inbox/conversationsstatus, channel

analytics/*days: 1–365

Crea un'offerta in sospeso

La creazione è idempotente tramite URL. Un URL esistente restituisce l'elemento corrente; nulla viene pubblicato automaticamente.

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