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 121 operazioni seguenti sono disponibili in produzione e utilizzano lo stesso audit contabile.

Operazione di ricerca

121 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→POST/groupsGruppiCrea destinazione di gruppoRegistra un gruppo già autorizzato dal connettore dell'account.groups:write→DELETE/groups/{id}GruppiGruppo archivioDisattiva la destinazione senza eliminare la cronologia delle pubblicazioni.groups:write→GET/groups/{id}/activityGruppiControlla l'attività del gruppoRiepilogare entrate, uscite e pubblicazioni senza rivelare i partecipanti.groups:read→POST/publications/{id}/retryPubblicazioniRiprova a pubblicareCrea un nuovo tentativo per un post non riuscito.publications:write→POST/publications/{id}/cancelPubblicazioniAnnulla pubblicazioneAnnulla una pubblicazione in sospeso senza rimuovere la cronologia.publications:write→GET/publications/{id}/attemptsPubblicazioniElenca i tentativi di pubblicazioneElenca la sequenza temporale sicura di creazione, errore, nuovo tentativo e annullamento.publications:read→POST/commissions/importsCommissioniCommissioni di importazione in CSVNormalizza un CSV, deduplica le transazioni e produce una ricevuta verificabile.commissions:write→GET/commissions/importsCommissioniElenca le importazioni su commissioneElenca le ricevute di importazione senza includere le credenziali.commissions:read→GET/commissions/imports/{id}CommissioniVedi l'importazione delle commissioniRestituisce conteggi, errori normalizzati e origine di un'importazione.commissions:read→POST/commissions/syncCommissioniSincronizza le commissioniInterroga solo i connettori autorizzati e registra una ricevuta per fonte.commissions:write→GET/commissions/receiptsCommissioniElencare le ricevuteElenca i crediti finanziari e lo stato di riconciliazione.commissions:read→POST/commissions/receiptsCommissioniRegistrare la ricevutaRegistra un accredito ricevuto senza trattarlo automaticamente come commissione.commissions:write→GET/commissions/receipts/{id}CommissioniVisualizza ricevutaRestituisce la ricevuta e le commissioni riconciliate.commissions:read→POST/commissions/receipts/{id}/reconcileCommissioniRiconciliare la ricevutaSeleziona o ricevi automaticamente le commissioni che formano il credito.commissions:write→POST/monitors/{id}/runMonitoraAvvia il radar adessoEsegue un giro del radar e il risultato osservato persiste.monitors:write→GET/monitors/{id}/resultsMonitoraConsulta i risultati del radarRestituisce l'ultimo round e le offerte originate da questo radar.monitors:read→GET/store/collectionsNegozioElenca le collezioni del negozioElenca le raccolte editoriali e il loro ordine pubblico.store:read→POST/store/collectionsNegozioCrea la collezione del negozioCrea una raccolta pubblicabile di offerte.store:write→GET/store/collections/{id}NegozioVisualizza la collezione del negozioRestituisce il contenuto e la configurazione di una raccolta.store:read→PATCH/store/collections/{id}NegozioAggiorna la collezione del negozioGli aggiornamenti hanno inviato solo i campi della raccolta.store:write→DELETE/store/collections/{id}NegozioElimina la raccolta del negozioRimuovi la raccolta senza eliminare le offerte.store:write→GET/store/pagesNegozioElenca le pagine del negozioElenca le pagine di destinazione e i contenuti editoriali per il negozio.store:read→POST/store/pagesNegozioCrea la pagina del negozioCrea una pagina in Markdown con il proprio SEO.store:write→GET/store/pages/{id}NegozioVisualizza la pagina del negozioRestituisce contenuto, SEO e stato di pubblicazione.store:read→PATCH/store/pages/{id}NegozioAggiorna la pagina del negozioAggiorna contenuti, slug, SEO o post.store:write→DELETE/store/pages/{id}NegozioElimina la pagina del negozioRimuove una pagina separata dal negozio.store:write→GET/inbox/contacts/{id}Posta in arrivoVedi contattoRestituisce profilo, tag e attività senza identificatori diretti.inbox:read→PATCH/inbox/contacts/{id}Posta in arrivoAggiorna contattoAggiorna nome, fase, tag e preferenze autorizzate.inbox:write→GET/inbox/contacts/{id}/notesPosta in arrivoElenca le note di contattoElenca le note interne con autore e data.inbox:read→POST/inbox/contacts/{id}/notesPosta in arrivoCrea nota nel contattoRegistra una nota interna che non viene mai inviata al contatto.inbox:write→POST/inbox/conversations/{id}/assignPosta in arrivoAssegna conversazioneAssegna o rimuove la persona responsabile della conversazione.inbox:write→POST/inbox/conversations/{id}/reopenPosta in arrivoRiapri la conversazioneRiapre una conversazione chiusa e registra l'evento.inbox:write→GET/inbox/messages/{id}Posta in arrivoVisualizza messaggioRestituisce il contenuto e lo stato operativo di un messaggio.inbox:read→GET/inbox/messages/{id}/statusPosta in arrivoControlla la consegna del messaggioDistinguere preparato, in coda, inviato, consegnato e fallito.inbox:read→POST/journeys/{id}/validateViaggiConvalidare il viaggioControlla trigger, blocchi, canali e riferimenti senza eseguire il flusso.journeys:read→POST/journeys/{id}/executeViaggiCorri il viaggioAvvia un'esecuzione esplicita per un contatto o una conversazione autorizzata.journeys:write→GET/journeys/{id}/executionsViaggiElenca le esecuzioni del viaggioElenca stato, fase e tempi di esecuzioni.journeys:read→GET/journey-executions/{id}ViaggiVisualizza l'esecuzione del viaggioRestituisce l'esecuzione e il relativo contesto operativo sicuro.journeys:read→GET/webhook-eventsWebhookElenca gli eventi webhookRestituisce il catalogo con versione di eventi e descrizioni.webhooks:read→GET/webhook-events/{event}/schemaWebhookVisualizza lo schema degli eventiRestituisce lo schema JSON e un esempio dell'evento nella versione corrente.webhooks:read→POST/webhooks/{id}/rotate-secretWebhookRuota il segreto del webhookInvalida il segreto precedente e rivela quello nuovo una sola volta.webhooks:write→POST/webhooks/{id}/testWebhookProva il webhookAccoda un evento di test firmato alla destinazione.webhooks:write→POST/webhook-deliveries/{id}/redeliverWebhookInvia nuovamente la consegna del webhookCrea un nuovo tentativo controllabile per un risultato finale esistente.webhooks:write→GET/integrationsIntegrazioniElenco integrazioniElenca i connettori e lo stato protetto, senza restituire le credenziali.integrations:read→GET/integrations/{provider}IntegrazioniVedi integrazioneRestituisce capacità, integrità e ultima convalida di un connettore.integrations:read→GET/integrations-healthIntegrazioniControlla lo stato dell'integrazioneRiepiloga i connettori configurati, integri e che richiedono attenzione.integrations:read→POST/integrations/{provider}/testIntegrazioniConvalidare l'integrazioneConvalida la configurazione disponibile e registra la diagnosi.integrations:write→DELETE/integrations/{provider}IntegrazioniScollegare l'integrazioneRimuove le credenziali del connettore per l'attore chiave.integrations:write→GET/analytics/funnelAnaliticaAnalizza l'imbutoRaggruppa impression, clic, intenzione, acquisto e commissione per periodo.analytics:read→GET/analytics/revenueAnaliticaAnalizzare la ricettaConsolida le commissioni e gli incassi registrati riconciliati per valuta.analytics:read→GET/analytics/attributionAnaliticaAnalizzare l'attribuzioneConfronta sorgente, gruppo, segmento e finestra di conversione.analytics: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"
  }'