{"openapi":"3.1.2","info":{"title":"Achadu Developer API","version":"1.1.0","summary":"Automação, publicação, loja, DU Inbox e analytics em uma única API.","description":"A API pública do Achadu expõe 70 operações tenant-scoped. O mesmo contrato alimenta REST, MCP e CLI. Use uma chave criada em Desenvolvedores, conceda apenas os escopos necessários e mantenha o segredo fora do navegador.","contact":{"name":"Achadu Developers","email":"dev@achadu.com","url":"https://achadu.com/developers"}},"servers":[{"url":"https://achadu.com/api/v1","description":"Produção"}],"security":[{"ApiKey":[]}],"tags":[{"name":"Account","description":"Identidade da operação vinculada à chave."},{"name":"Offers","description":"Catálogo, curadoria, prévia e publicação."},{"name":"Groups","description":"Destinos de distribuição seguros."},{"name":"Segments","description":"Nichos, vitrines e regras de distribuição."},{"name":"Coupons","description":"Cupons e elegibilidade."},{"name":"Commissions","description":"Atribuição, moeda e conciliação."},{"name":"Publications","description":"Histórico operacional de envios."},{"name":"Templates","description":"Modelos editoriais reutilizáveis."},{"name":"Schedules","description":"Agenda, recorrências e execução controlada."},{"name":"Monitors","description":"Radar recorrente de oportunidades."},{"name":"Store","description":"Identidade pública e tema da loja."},{"name":"Journeys","description":"Automações do DU em grafo."},{"name":"Inbox","description":"Conversas, mensagens e CRM sem dados diretos do contato."},{"name":"Analytics","description":"Métricas por tempo, grupo, oferta, fonte e posição."},{"name":"Links","description":"Conversão com as credenciais de afiliado da conta."},{"name":"Webhooks","description":"Eventos assinados e histórico de entregas."}],"paths":{"/me":{"get":{"tags":["Account"],"summary":"Ver conta","description":"Retorna a operação e o ator vinculados à chave.","operationId":"account_get","x-achadu-scope":"account:read","responses":{"200":{"description":"Operação concluída.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountResponse"}}}},"400":{"description":"Parâmetros inválidos.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Chave ausente ou inválida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Plano incompatível.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Escopo insuficiente.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Recurso não encontrado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflito com o estado atual.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Limite de requisições excedido.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/offers":{"get":{"tags":["Offers"],"summary":"Listar ofertas","description":"Lista ofertas com filtros de status, marketplace e texto.","operationId":"offers_list","x-achadu-scope":"offers:read","parameters":[{"name":"limit","in":"query","description":"Quantidade por página.","schema":{"type":"integer","minimum":1,"maximum":100,"default":30}},{"name":"offset","in":"query","description":"Deslocamento da paginação.","schema":{"type":"integer","minimum":0,"default":0}},{"name":"status","in":"query","description":"Estado de curadoria.","schema":{"type":"string"}},{"name":"marketplace","in":"query","description":"Marketplace.","schema":{"type":"string"}},{"name":"query","in":"query","description":"Busca por título ou loja.","schema":{"type":"string"}}],"responses":{"200":{"description":"Operação concluída.","content":{"application/json":{"schema":{"type":"object","required":["data","pagination","request_id"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Offer"}},"pagination":{"$ref":"#/components/schemas/Pagination"},"request_id":{"type":"string"}}}}}},"400":{"description":"Parâmetros inválidos.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Chave ausente ou inválida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Plano incompatível.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Escopo insuficiente.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Recurso não encontrado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflito com o estado atual.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Limite de requisições excedido.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"tags":["Offers"],"summary":"Criar oferta","description":"Cria uma oferta pendente sem publicá-la.","operationId":"offer_create","x-achadu-scope":"offers:write","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"URL HTTPS original do produto.","format":"uri","maxLength":2000},"title":{"type":"string","description":"Título público da oferta.","minLength":3,"maxLength":240},"marketplace":{"type":"string","description":"Marketplace de origem.","maxLength":40},"price":{"type":"number","description":"Preço atual."},"original_price":{"type":"number","description":"Preço anterior."},"currency":{"type":"string","description":"Moeda ISO 4217.","minLength":3,"maxLength":8,"default":"BRL"},"image":{"type":"string","description":"URL HTTPS da imagem.","format":"uri"},"store":{"type":"string","description":"Nome da loja."},"category":{"type":"string","description":"Categoria."},"coupon":{"type":"string","description":"Código do cupom."},"copy":{"type":"string","description":"Texto editorial da oferta.","maxLength":6000},"status":{"type":"string","description":"Estado de curadoria."}},"required":["url","title"],"additionalProperties":false}}}},"responses":{"201":{"description":"Recurso criado.","content":{"application/json":{"schema":{"type":"object","required":["data","request_id"],"properties":{"data":{"$ref":"#/components/schemas/Offer"},"request_id":{"type":"string"},"created":{"type":"boolean"}}}}}},"400":{"description":"Parâmetros inválidos.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Chave ausente ou inválida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Plano incompatível.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Escopo insuficiente.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Recurso não encontrado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflito com o estado atual.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Limite de requisições excedido.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/offers/{id}":{"get":{"tags":["Offers"],"summary":"Ver oferta","description":"Retorna os detalhes editoriais e comerciais de uma oferta.","operationId":"offer_get","x-achadu-scope":"offers:read","parameters":[{"name":"id","in":"path","required":true,"description":"Identificador do recurso.","schema":{"type":"string"}}],"responses":{"200":{"description":"Operação concluída.","content":{"application/json":{"schema":{"type":"object","required":["data","request_id"],"properties":{"data":{"$ref":"#/components/schemas/Offer"},"request_id":{"type":"string"}}}}}},"400":{"description":"Parâmetros inválidos.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Chave ausente ou inválida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Plano incompatível.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Escopo insuficiente.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Recurso não encontrado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflito com o estado atual.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Limite de requisições excedido.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"patch":{"tags":["Offers"],"summary":"Atualizar oferta","description":"Atualiza somente os campos enviados.","operationId":"offer_update","x-achadu-scope":"offers:write","parameters":[{"name":"id","in":"path","required":true,"description":"Identificador do recurso.","schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"URL HTTPS original do produto.","format":"uri","maxLength":2000},"title":{"type":"string","description":"Título público da oferta.","minLength":3,"maxLength":240},"marketplace":{"type":"string","description":"Marketplace de origem.","maxLength":40},"price":{"type":"number","description":"Preço atual."},"original_price":{"type":"number","description":"Preço anterior."},"currency":{"type":"string","description":"Moeda ISO 4217.","minLength":3,"maxLength":8,"default":"BRL"},"image":{"type":"string","description":"URL HTTPS da imagem.","format":"uri"},"store":{"type":"string","description":"Nome da loja."},"category":{"type":"string","description":"Categoria."},"coupon":{"type":"string","description":"Código do cupom."},"copy":{"type":"string","description":"Texto editorial da oferta.","maxLength":6000},"status":{"type":"string","description":"Estado de curadoria."}},"additionalProperties":false}}}},"responses":{"200":{"description":"Operação concluída.","content":{"application/json":{"schema":{"type":"object","required":["data","request_id"],"properties":{"data":{"$ref":"#/components/schemas/Offer"},"request_id":{"type":"string"}}}}}},"400":{"description":"Parâmetros inválidos.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Chave ausente ou inválida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Plano incompatível.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Escopo insuficiente.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Recurso não encontrado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflito com o estado atual.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Limite de requisições excedido.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"delete":{"tags":["Offers"],"summary":"Arquivar oferta","description":"Retira a oferta do fluxo ativo sem apagar o histórico.","operationId":"offer_archive","x-achadu-scope":"offers:write","parameters":[{"name":"id","in":"path","required":true,"description":"Identificador do recurso.","schema":{"type":"string"}}],"responses":{"200":{"description":"Operação concluída.","content":{"application/json":{"schema":{"type":"object","required":["deleted","id","request_id"],"properties":{"deleted":{"type":"boolean"},"archived":{"type":"boolean"},"id":{"type":"string"},"request_id":{"type":"string"}}}}}},"400":{"description":"Parâmetros inválidos.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Chave ausente ou inválida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Plano incompatível.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Escopo insuficiente.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Recurso não encontrado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflito com o estado atual.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Limite de requisições excedido.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/offers/{id}/preview":{"post":{"tags":["Offers"],"summary":"Pré-visualizar publicação","description":"Monta a mensagem final sem enviar para nenhum canal.","operationId":"offer_preview","x-achadu-scope":"offers:read","parameters":[{"name":"id","in":"path","required":true,"description":"Identificador do recurso.","schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"segment_id":{"type":"string","description":"Segmento usado na prévia."}},"additionalProperties":false}}}},"responses":{"200":{"description":"Operação concluída.","content":{"application/json":{"schema":{"type":"object","required":["data","request_id"],"properties":{"data":{"type":"object","additionalProperties":true},"event_id":{"type":"string"},"request_id":{"type":"string"}}}}}},"400":{"description":"Parâmetros inválidos.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Chave ausente ou inválida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Plano incompatível.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Escopo insuficiente.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Recurso não encontrado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflito com o estado atual.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Limite de requisições excedido.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/offers/{id}/publish":{"post":{"tags":["Offers"],"summary":"Publicar oferta","description":"Enfileira a publicação da oferta em um grupo ou segmento autorizado.","operationId":"offer_publish","x-achadu-scope":"publications:write","parameters":[{"name":"id","in":"path","required":true,"description":"Identificador do recurso.","schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"segment_id":{"type":"string","description":"Segmento de destino."},"group_id":{"type":"string","description":"Grupo de destino."},"with_image":{"type":"boolean","description":"Publica com imagem."}},"additionalProperties":false}}}},"responses":{"200":{"description":"Operação concluída.","content":{"application/json":{"schema":{"type":"object","required":["data","request_id"],"properties":{"data":{"type":"object","additionalProperties":true},"event_id":{"type":"string"},"request_id":{"type":"string"}}}}}},"400":{"description":"Parâmetros inválidos.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Chave ausente ou inválida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Plano incompatível.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Escopo insuficiente.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Recurso não encontrado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflito com o estado atual.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Limite de requisições excedido.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/groups":{"get":{"tags":["Groups"],"summary":"Listar grupos","description":"Lista grupos sem expor JIDs, sessões ou credenciais.","operationId":"groups_list","x-achadu-scope":"groups:read","parameters":[{"name":"limit","in":"query","description":"Quantidade por página.","schema":{"type":"integer","minimum":1,"maximum":100,"default":30}},{"name":"offset","in":"query","description":"Deslocamento da paginação.","schema":{"type":"integer","minimum":0,"default":0}}],"responses":{"200":{"description":"Operação concluída.","content":{"application/json":{"schema":{"type":"object","required":["data","pagination","request_id"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Group"}},"pagination":{"$ref":"#/components/schemas/Pagination"},"request_id":{"type":"string"}}}}}},"400":{"description":"Parâmetros inválidos.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Chave ausente ou inválida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Plano incompatível.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Escopo insuficiente.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Recurso não encontrado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflito com o estado atual.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Limite de requisições excedido.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/groups/{id}":{"get":{"tags":["Groups"],"summary":"Ver grupo","description":"Retorna configuração operacional segura do grupo.","operationId":"group_get","x-achadu-scope":"groups:read","parameters":[{"name":"id","in":"path","required":true,"description":"Identificador do recurso.","schema":{"type":"string"}}],"responses":{"200":{"description":"Operação concluída.","content":{"application/json":{"schema":{"type":"object","required":["data","request_id"],"properties":{"data":{"$ref":"#/components/schemas/Group"},"request_id":{"type":"string"}}}}}},"400":{"description":"Parâmetros inválidos.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Chave ausente ou inválida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Plano incompatível.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Escopo insuficiente.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Recurso não encontrado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflito com o estado atual.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Limite de requisições excedido.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"patch":{"tags":["Groups"],"summary":"Atualizar grupo","description":"Atualiza nome, segmento, capacidade e automação.","operationId":"group_update","x-achadu-scope":"groups:write","parameters":[{"name":"id","in":"path","required":true,"description":"Identificador do recurso.","schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","description":"Nome do grupo."},"role":{"type":"string","description":"Papel do grupo."},"segment_id":{"type":"string","description":"Segmento."},"capacity":{"type":"integer","description":"Capacidade."},"automation":{"type":"boolean","description":"Ativa automação."},"active":{"type":"boolean","description":"Ativa o grupo."}},"additionalProperties":false}}}},"responses":{"200":{"description":"Operação concluída.","content":{"application/json":{"schema":{"type":"object","required":["data","request_id"],"properties":{"data":{"$ref":"#/components/schemas/Group"},"request_id":{"type":"string"}}}}}},"400":{"description":"Parâmetros inválidos.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Chave ausente ou inválida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Plano incompatível.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Escopo insuficiente.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Recurso não encontrado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflito com o estado atual.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Limite de requisições excedido.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/segments":{"get":{"tags":["Segments"],"summary":"Listar segmentos","description":"Lista nichos e configurações de vitrine.","operationId":"segments_list","x-achadu-scope":"segments:read","parameters":[{"name":"limit","in":"query","description":"Quantidade por página.","schema":{"type":"integer","minimum":1,"maximum":100,"default":30}},{"name":"offset","in":"query","description":"Deslocamento da paginação.","schema":{"type":"integer","minimum":0,"default":0}}],"responses":{"200":{"description":"Operação concluída.","content":{"application/json":{"schema":{"type":"object","required":["data","pagination","request_id"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Segment"}},"pagination":{"$ref":"#/components/schemas/Pagination"},"request_id":{"type":"string"}}}}}},"400":{"description":"Parâmetros inválidos.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Chave ausente ou inválida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Plano incompatível.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Escopo insuficiente.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Recurso não encontrado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflito com o estado atual.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Limite de requisições excedido.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"tags":["Segments"],"summary":"Criar segmento","description":"Cria um nicho com sua configuração de vitrine.","operationId":"segment_create","x-achadu-scope":"segments:write","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","description":"Nome do segmento."},"slug":{"type":"string","description":"Slug público."},"description":{"type":"string","description":"Descrição."},"store_name":{"type":"string","description":"Nome da vitrine."},"store_tagline":{"type":"string","description":"Frase da vitrine."},"store_color":{"type":"string","description":"Cor principal."},"auto_expand":{"type":"boolean","description":"Ativa expansão automática."},"distribution":{"type":"string","description":"Estratégia de distribuição."},"waitlist":{"type":"boolean","description":"Ativa fila de espera."}},"required":["name"],"additionalProperties":false}}}},"responses":{"201":{"description":"Recurso criado.","content":{"application/json":{"schema":{"type":"object","required":["data","request_id"],"properties":{"data":{"$ref":"#/components/schemas/Segment"},"request_id":{"type":"string"},"created":{"type":"boolean"}}}}}},"400":{"description":"Parâmetros inválidos.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Chave ausente ou inválida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Plano incompatível.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Escopo insuficiente.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Recurso não encontrado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflito com o estado atual.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Limite de requisições excedido.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/segments/{id}":{"get":{"tags":["Segments"],"summary":"Ver segmento","description":"Retorna um segmento da operação.","operationId":"segment_get","x-achadu-scope":"segments:read","parameters":[{"name":"id","in":"path","required":true,"description":"Identificador do recurso.","schema":{"type":"string"}}],"responses":{"200":{"description":"Operação concluída.","content":{"application/json":{"schema":{"type":"object","required":["data","request_id"],"properties":{"data":{"$ref":"#/components/schemas/Segment"},"request_id":{"type":"string"}}}}}},"400":{"description":"Parâmetros inválidos.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Chave ausente ou inválida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Plano incompatível.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Escopo insuficiente.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Recurso não encontrado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflito com o estado atual.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Limite de requisições excedido.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"patch":{"tags":["Segments"],"summary":"Atualizar segmento","description":"Atualiza identidade, distribuição e vitrine do segmento.","operationId":"segment_update","x-achadu-scope":"segments:write","parameters":[{"name":"id","in":"path","required":true,"description":"Identificador do recurso.","schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","description":"Nome do segmento."},"slug":{"type":"string","description":"Slug público."},"description":{"type":"string","description":"Descrição."},"store_name":{"type":"string","description":"Nome da vitrine."},"store_tagline":{"type":"string","description":"Frase da vitrine."},"store_color":{"type":"string","description":"Cor principal."},"auto_expand":{"type":"boolean","description":"Ativa expansão automática."},"distribution":{"type":"string","description":"Estratégia de distribuição."},"waitlist":{"type":"boolean","description":"Ativa fila de espera."}},"additionalProperties":false}}}},"responses":{"200":{"description":"Operação concluída.","content":{"application/json":{"schema":{"type":"object","required":["data","request_id"],"properties":{"data":{"$ref":"#/components/schemas/Segment"},"request_id":{"type":"string"}}}}}},"400":{"description":"Parâmetros inválidos.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Chave ausente ou inválida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Plano incompatível.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Escopo insuficiente.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Recurso não encontrado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflito com o estado atual.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Limite de requisições excedido.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"delete":{"tags":["Segments"],"summary":"Excluir segmento","description":"Exclui somente quando não existem grupos ou agendas vinculados.","operationId":"segment_delete","x-achadu-scope":"segments:write","parameters":[{"name":"id","in":"path","required":true,"description":"Identificador do recurso.","schema":{"type":"string"}}],"responses":{"200":{"description":"Operação concluída.","content":{"application/json":{"schema":{"type":"object","required":["deleted","id","request_id"],"properties":{"deleted":{"type":"boolean"},"archived":{"type":"boolean"},"id":{"type":"string"},"request_id":{"type":"string"}}}}}},"400":{"description":"Parâmetros inválidos.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Chave ausente ou inválida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Plano incompatível.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Escopo insuficiente.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Recurso não encontrado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflito com o estado atual.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Limite de requisições excedido.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/coupons":{"get":{"tags":["Coupons"],"summary":"Listar cupons","description":"Lista cupons ativos e verificados da operação.","operationId":"coupons_list","x-achadu-scope":"coupons:read","parameters":[{"name":"limit","in":"query","description":"Quantidade por página.","schema":{"type":"integer","minimum":1,"maximum":100,"default":30}},{"name":"offset","in":"query","description":"Deslocamento da paginação.","schema":{"type":"integer","minimum":0,"default":0}}],"responses":{"200":{"description":"Operação concluída.","content":{"application/json":{"schema":{"type":"object","required":["data","pagination","request_id"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Coupon"}},"pagination":{"$ref":"#/components/schemas/Pagination"},"request_id":{"type":"string"}}}}}},"400":{"description":"Parâmetros inválidos.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Chave ausente ou inválida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Plano incompatível.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Escopo insuficiente.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Recurso não encontrado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflito com o estado atual.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Limite de requisições excedido.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"tags":["Coupons"],"summary":"Criar cupom","description":"Registra um cupom para uso nas ofertas.","operationId":"coupon_create","x-achadu-scope":"coupons:write","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"marketplace":{"type":"string","description":"Marketplace."},"code":{"type":"string","description":"Código do cupom."},"description":{"type":"string","description":"Descrição."},"value":{"type":"string","description":"Valor apresentado."},"minimum":{"type":"number","description":"Pedido mínimo."},"valid_until":{"type":"string","description":"Validade ISO."},"type":{"type":"string","description":"Tipo do cupom."},"discount":{"type":"number","description":"Percentual ou valor de desconto."},"cap":{"type":"number","description":"Teto de desconto."},"categories":{"type":"array","description":"Categorias elegíveis.","items":{"type":"string"}},"verified":{"type":"boolean","description":"Marca o cupom como verificado."},"active":{"type":"boolean","description":"Ativa ou arquiva o cupom."}},"required":["marketplace","code"],"additionalProperties":false}}}},"responses":{"201":{"description":"Recurso criado.","content":{"application/json":{"schema":{"type":"object","required":["data","request_id"],"properties":{"data":{"$ref":"#/components/schemas/Coupon"},"request_id":{"type":"string"},"created":{"type":"boolean"}}}}}},"400":{"description":"Parâmetros inválidos.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Chave ausente ou inválida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Plano incompatível.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Escopo insuficiente.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Recurso não encontrado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflito com o estado atual.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Limite de requisições excedido.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/coupons/{id}":{"get":{"tags":["Coupons"],"summary":"Ver cupom","description":"Retorna regras e validade de um cupom.","operationId":"coupon_get","x-achadu-scope":"coupons:read","parameters":[{"name":"id","in":"path","required":true,"description":"Identificador do recurso.","schema":{"type":"string"}}],"responses":{"200":{"description":"Operação concluída.","content":{"application/json":{"schema":{"type":"object","required":["data","request_id"],"properties":{"data":{"$ref":"#/components/schemas/Coupon"},"request_id":{"type":"string"}}}}}},"400":{"description":"Parâmetros inválidos.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Chave ausente ou inválida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Plano incompatível.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Escopo insuficiente.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Recurso não encontrado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflito com o estado atual.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Limite de requisições excedido.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"patch":{"tags":["Coupons"],"summary":"Atualizar cupom","description":"Atualiza validade, desconto e elegibilidade.","operationId":"coupon_update","x-achadu-scope":"coupons:write","parameters":[{"name":"id","in":"path","required":true,"description":"Identificador do recurso.","schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"marketplace":{"type":"string","description":"Marketplace."},"code":{"type":"string","description":"Código do cupom."},"description":{"type":"string","description":"Descrição."},"value":{"type":"string","description":"Valor apresentado."},"minimum":{"type":"number","description":"Pedido mínimo."},"valid_until":{"type":"string","description":"Validade ISO."},"type":{"type":"string","description":"Tipo do cupom."},"discount":{"type":"number","description":"Percentual ou valor de desconto."},"cap":{"type":"number","description":"Teto de desconto."},"categories":{"type":"array","description":"Categorias elegíveis.","items":{"type":"string"}},"verified":{"type":"boolean","description":"Marca o cupom como verificado."},"active":{"type":"boolean","description":"Ativa ou arquiva o cupom."}},"additionalProperties":false}}}},"responses":{"200":{"description":"Operação concluída.","content":{"application/json":{"schema":{"type":"object","required":["data","request_id"],"properties":{"data":{"$ref":"#/components/schemas/Coupon"},"request_id":{"type":"string"}}}}}},"400":{"description":"Parâmetros inválidos.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Chave ausente ou inválida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Plano incompatível.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Escopo insuficiente.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Recurso não encontrado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflito com o estado atual.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Limite de requisições excedido.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"delete":{"tags":["Coupons"],"summary":"Arquivar cupom","description":"Desativa o cupom preservando seu histórico.","operationId":"coupon_archive","x-achadu-scope":"coupons:write","parameters":[{"name":"id","in":"path","required":true,"description":"Identificador do recurso.","schema":{"type":"string"}}],"responses":{"200":{"description":"Operação concluída.","content":{"application/json":{"schema":{"type":"object","required":["deleted","id","request_id"],"properties":{"deleted":{"type":"boolean"},"archived":{"type":"boolean"},"id":{"type":"string"},"request_id":{"type":"string"}}}}}},"400":{"description":"Parâmetros inválidos.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Chave ausente ou inválida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Plano incompatível.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Escopo insuficiente.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Recurso não encontrado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflito com o estado atual.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Limite de requisições excedido.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/commissions":{"get":{"tags":["Commissions"],"summary":"Listar comissões","description":"Lista comissões atribuídas à conta.","operationId":"commissions_list","x-achadu-scope":"commissions:read","parameters":[{"name":"limit","in":"query","description":"Quantidade por página.","schema":{"type":"integer","minimum":1,"maximum":100,"default":30}},{"name":"offset","in":"query","description":"Deslocamento da paginação.","schema":{"type":"integer","minimum":0,"default":0}}],"responses":{"200":{"description":"Operação concluída.","content":{"application/json":{"schema":{"type":"object","required":["data","pagination","request_id"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Commission"}},"pagination":{"$ref":"#/components/schemas/Pagination"},"request_id":{"type":"string"}}}}}},"400":{"description":"Parâmetros inválidos.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Chave ausente ou inválida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Plano incompatível.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Escopo insuficiente.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Recurso não encontrado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflito com o estado atual.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Limite de requisições excedido.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/commissions/summary":{"get":{"tags":["Commissions"],"summary":"Resumir comissões","description":"Agrupa valores por moeda e estado de pagamento.","operationId":"commissions_summary","x-achadu-scope":"commissions:read","parameters":[{"name":"days","in":"query","description":"Janela de análise em dias.","schema":{"type":"integer","minimum":1,"maximum":365,"default":30}}],"responses":{"200":{"description":"Operação concluída.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommissionSummaryResponse"}}}},"400":{"description":"Parâmetros inválidos.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Chave ausente ou inválida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Plano incompatível.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Escopo insuficiente.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Recurso não encontrado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflito com o estado atual.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Limite de requisições excedido.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/commissions/{id}":{"get":{"tags":["Commissions"],"summary":"Ver comissão","description":"Retorna atribuição e conciliação de uma comissão.","operationId":"commission_get","x-achadu-scope":"commissions:read","parameters":[{"name":"id","in":"path","required":true,"description":"Identificador do recurso.","schema":{"type":"string"}}],"responses":{"200":{"description":"Operação concluída.","content":{"application/json":{"schema":{"type":"object","required":["data","request_id"],"properties":{"data":{"$ref":"#/components/schemas/Commission"},"request_id":{"type":"string"}}}}}},"400":{"description":"Parâmetros inválidos.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Chave ausente ou inválida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Plano incompatível.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Escopo insuficiente.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Recurso não encontrado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflito com o estado atual.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Limite de requisições excedido.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/publications":{"get":{"tags":["Publications"],"summary":"Listar publicações","description":"Lista envios com filtros por estado, grupo e oferta.","operationId":"publications_list","x-achadu-scope":"publications:read","parameters":[{"name":"limit","in":"query","description":"Quantidade por página.","schema":{"type":"integer","minimum":1,"maximum":100,"default":30}},{"name":"offset","in":"query","description":"Deslocamento da paginação.","schema":{"type":"integer","minimum":0,"default":0}},{"name":"status","in":"query","description":"Estado do envio.","schema":{"type":"string"}},{"name":"group_id","in":"query","description":"Grupo.","schema":{"type":"string"}},{"name":"offer_id","in":"query","description":"Oferta.","schema":{"type":"string"}}],"responses":{"200":{"description":"Operação concluída.","content":{"application/json":{"schema":{"type":"object","required":["data","pagination","request_id"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Publication"}},"pagination":{"$ref":"#/components/schemas/Pagination"},"request_id":{"type":"string"}}}}}},"400":{"description":"Parâmetros inválidos.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Chave ausente ou inválida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Plano incompatível.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Escopo insuficiente.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Recurso não encontrado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflito com o estado atual.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Limite de requisições excedido.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/publications/{id}":{"get":{"tags":["Publications"],"summary":"Ver publicação","description":"Retorna o resultado de uma publicação sem expor sessão do canal.","operationId":"publication_get","x-achadu-scope":"publications:read","parameters":[{"name":"id","in":"path","required":true,"description":"Identificador do recurso.","schema":{"type":"string"}}],"responses":{"200":{"description":"Operação concluída.","content":{"application/json":{"schema":{"type":"object","required":["data","request_id"],"properties":{"data":{"$ref":"#/components/schemas/Publication"},"request_id":{"type":"string"}}}}}},"400":{"description":"Parâmetros inválidos.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Chave ausente ou inválida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Plano incompatível.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Escopo insuficiente.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Recurso não encontrado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflito com o estado atual.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Limite de requisições excedido.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/templates":{"get":{"tags":["Templates"],"summary":"Listar templates","description":"Lista modelos editoriais da conta.","operationId":"templates_list","x-achadu-scope":"templates:read","parameters":[{"name":"limit","in":"query","description":"Quantidade por página.","schema":{"type":"integer","minimum":1,"maximum":100,"default":30}},{"name":"offset","in":"query","description":"Deslocamento da paginação.","schema":{"type":"integer","minimum":0,"default":0}}],"responses":{"200":{"description":"Operação concluída.","content":{"application/json":{"schema":{"type":"object","required":["data","pagination","request_id"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Template"}},"pagination":{"$ref":"#/components/schemas/Pagination"},"request_id":{"type":"string"}}}}}},"400":{"description":"Parâmetros inválidos.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Chave ausente ou inválida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Plano incompatível.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Escopo insuficiente.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Recurso não encontrado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflito com o estado atual.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Limite de requisições excedido.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"tags":["Templates"],"summary":"Criar template","description":"Cria um modelo reutilizável de publicação.","operationId":"template_create","x-achadu-scope":"templates:write","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","description":"Nome do template."},"body":{"type":"string","description":"Corpo com variáveis do Achadu.","maxLength":12000},"marketplace":{"type":"string","description":"Marketplace opcional."},"with_preview":{"type":"boolean","description":"Inclui prévia do produto."}},"required":["name","body"],"additionalProperties":false}}}},"responses":{"201":{"description":"Recurso criado.","content":{"application/json":{"schema":{"type":"object","required":["data","request_id"],"properties":{"data":{"$ref":"#/components/schemas/Template"},"request_id":{"type":"string"},"created":{"type":"boolean"}}}}}},"400":{"description":"Parâmetros inválidos.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Chave ausente ou inválida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Plano incompatível.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Escopo insuficiente.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Recurso não encontrado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflito com o estado atual.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Limite de requisições excedido.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/templates/{id}":{"get":{"tags":["Templates"],"summary":"Ver template","description":"Retorna o corpo e a configuração de um template.","operationId":"template_get","x-achadu-scope":"templates:read","parameters":[{"name":"id","in":"path","required":true,"description":"Identificador do recurso.","schema":{"type":"string"}}],"responses":{"200":{"description":"Operação concluída.","content":{"application/json":{"schema":{"type":"object","required":["data","request_id"],"properties":{"data":{"$ref":"#/components/schemas/Template"},"request_id":{"type":"string"}}}}}},"400":{"description":"Parâmetros inválidos.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Chave ausente ou inválida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Plano incompatível.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Escopo insuficiente.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Recurso não encontrado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflito com o estado atual.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Limite de requisições excedido.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"patch":{"tags":["Templates"],"summary":"Atualizar template","description":"Atualiza os campos enviados do template.","operationId":"template_update","x-achadu-scope":"templates:write","parameters":[{"name":"id","in":"path","required":true,"description":"Identificador do recurso.","schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","description":"Nome do template."},"body":{"type":"string","description":"Corpo com variáveis do Achadu.","maxLength":12000},"marketplace":{"type":"string","description":"Marketplace opcional."},"with_preview":{"type":"boolean","description":"Inclui prévia do produto."}},"additionalProperties":false}}}},"responses":{"200":{"description":"Operação concluída.","content":{"application/json":{"schema":{"type":"object","required":["data","request_id"],"properties":{"data":{"$ref":"#/components/schemas/Template"},"request_id":{"type":"string"}}}}}},"400":{"description":"Parâmetros inválidos.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Chave ausente ou inválida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Plano incompatível.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Escopo insuficiente.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Recurso não encontrado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflito com o estado atual.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Limite de requisições excedido.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"delete":{"tags":["Templates"],"summary":"Excluir template","description":"Exclui um template sem uso por agendamentos.","operationId":"template_delete","x-achadu-scope":"templates:write","parameters":[{"name":"id","in":"path","required":true,"description":"Identificador do recurso.","schema":{"type":"string"}}],"responses":{"200":{"description":"Operação concluída.","content":{"application/json":{"schema":{"type":"object","required":["deleted","id","request_id"],"properties":{"deleted":{"type":"boolean"},"archived":{"type":"boolean"},"id":{"type":"string"},"request_id":{"type":"string"}}}}}},"400":{"description":"Parâmetros inválidos.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Chave ausente ou inválida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Plano incompatível.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Escopo insuficiente.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Recurso não encontrado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflito com o estado atual.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Limite de requisições excedido.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/schedules":{"get":{"tags":["Schedules"],"summary":"Listar agendamentos","description":"Lista publicações futuras e recorrentes.","operationId":"schedules_list","x-achadu-scope":"schedules:read","parameters":[{"name":"limit","in":"query","description":"Quantidade por página.","schema":{"type":"integer","minimum":1,"maximum":100,"default":30}},{"name":"offset","in":"query","description":"Deslocamento da paginação.","schema":{"type":"integer","minimum":0,"default":0}}],"responses":{"200":{"description":"Operação concluída.","content":{"application/json":{"schema":{"type":"object","required":["data","pagination","request_id"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Schedule"}},"pagination":{"$ref":"#/components/schemas/Pagination"},"request_id":{"type":"string"}}}}}},"400":{"description":"Parâmetros inválidos.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Chave ausente ou inválida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Plano incompatível.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Escopo insuficiente.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Recurso não encontrado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflito com o estado atual.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Limite de requisições excedido.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"tags":["Schedules"],"summary":"Criar agendamento","description":"Programa oferta ou texto para uma data ISO.","operationId":"schedule_create","x-achadu-scope":"schedules:write","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","description":"Tipo: offer ou text."},"at":{"type":"string","description":"Data e hora ISO 8601.","format":"date-time"},"segment_id":{"type":"string","description":"Segmento de destino."},"group_id":{"type":"string","description":"Grupo específico."},"offer_id":{"type":"string","description":"Oferta programada."},"text":{"type":"string","description":"Texto para agendamento textual."},"image":{"type":"string","description":"Imagem opcional.","format":"uri"},"recurrence":{"type":"string","description":"Regra de recorrência."},"active":{"type":"boolean","description":"Ativa o agendamento."}},"required":["at"],"additionalProperties":false}}}},"responses":{"201":{"description":"Recurso criado.","content":{"application/json":{"schema":{"type":"object","required":["data","request_id"],"properties":{"data":{"$ref":"#/components/schemas/Schedule"},"request_id":{"type":"string"},"created":{"type":"boolean"}}}}}},"400":{"description":"Parâmetros inválidos.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Chave ausente ou inválida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Plano incompatível.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Escopo insuficiente.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Recurso não encontrado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflito com o estado atual.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Limite de requisições excedido.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/schedules/{id}":{"get":{"tags":["Schedules"],"summary":"Ver agendamento","description":"Retorna destino, conteúdo e recorrência.","operationId":"schedule_get","x-achadu-scope":"schedules:read","parameters":[{"name":"id","in":"path","required":true,"description":"Identificador do recurso.","schema":{"type":"string"}}],"responses":{"200":{"description":"Operação concluída.","content":{"application/json":{"schema":{"type":"object","required":["data","request_id"],"properties":{"data":{"$ref":"#/components/schemas/Schedule"},"request_id":{"type":"string"}}}}}},"400":{"description":"Parâmetros inválidos.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Chave ausente ou inválida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Plano incompatível.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Escopo insuficiente.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Recurso não encontrado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflito com o estado atual.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Limite de requisições excedido.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"patch":{"tags":["Schedules"],"summary":"Atualizar agendamento","description":"Altera horário, destino, recorrência ou estado.","operationId":"schedule_update","x-achadu-scope":"schedules:write","parameters":[{"name":"id","in":"path","required":true,"description":"Identificador do recurso.","schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","description":"Tipo: offer ou text."},"at":{"type":"string","description":"Data e hora ISO 8601.","format":"date-time"},"segment_id":{"type":"string","description":"Segmento de destino."},"group_id":{"type":"string","description":"Grupo específico."},"offer_id":{"type":"string","description":"Oferta programada."},"text":{"type":"string","description":"Texto para agendamento textual."},"image":{"type":"string","description":"Imagem opcional.","format":"uri"},"recurrence":{"type":"string","description":"Regra de recorrência."},"active":{"type":"boolean","description":"Ativa o agendamento."}},"additionalProperties":false}}}},"responses":{"200":{"description":"Operação concluída.","content":{"application/json":{"schema":{"type":"object","required":["data","request_id"],"properties":{"data":{"$ref":"#/components/schemas/Schedule"},"request_id":{"type":"string"}}}}}},"400":{"description":"Parâmetros inválidos.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Chave ausente ou inválida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Plano incompatível.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Escopo insuficiente.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Recurso não encontrado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflito com o estado atual.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Limite de requisições excedido.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"delete":{"tags":["Schedules"],"summary":"Excluir agendamento","description":"Cancela e remove um agendamento futuro.","operationId":"schedule_delete","x-achadu-scope":"schedules:write","parameters":[{"name":"id","in":"path","required":true,"description":"Identificador do recurso.","schema":{"type":"string"}}],"responses":{"200":{"description":"Operação concluída.","content":{"application/json":{"schema":{"type":"object","required":["deleted","id","request_id"],"properties":{"deleted":{"type":"boolean"},"archived":{"type":"boolean"},"id":{"type":"string"},"request_id":{"type":"string"}}}}}},"400":{"description":"Parâmetros inválidos.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Chave ausente ou inválida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Plano incompatível.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Escopo insuficiente.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Recurso não encontrado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflito com o estado atual.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Limite de requisições excedido.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/schedules/{id}/run":{"post":{"tags":["Schedules"],"summary":"Executar agendamento","description":"Executa agora a mesma rotina segura do agendador.","operationId":"schedule_run","x-achadu-scope":"publications:write","parameters":[{"name":"id","in":"path","required":true,"description":"Identificador do recurso.","schema":{"type":"string"}}],"responses":{"200":{"description":"Operação concluída.","content":{"application/json":{"schema":{"type":"object","required":["data","request_id"],"properties":{"data":{"type":"object","additionalProperties":true},"event_id":{"type":"string"},"request_id":{"type":"string"}}}}}},"400":{"description":"Parâmetros inválidos.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Chave ausente ou inválida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Plano incompatível.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Escopo insuficiente.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Recurso não encontrado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflito com o estado atual.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Limite de requisições excedido.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/monitors":{"get":{"tags":["Monitors"],"summary":"Listar radares","description":"Lista regras automáticas de descoberta de ofertas.","operationId":"monitors_list","x-achadu-scope":"monitors:read","parameters":[{"name":"limit","in":"query","description":"Quantidade por página.","schema":{"type":"integer","minimum":1,"maximum":100,"default":30}},{"name":"offset","in":"query","description":"Deslocamento da paginação.","schema":{"type":"integer","minimum":0,"default":0}}],"responses":{"200":{"description":"Operação concluída.","content":{"application/json":{"schema":{"type":"object","required":["data","pagination","request_id"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Monitor"}},"pagination":{"$ref":"#/components/schemas/Pagination"},"request_id":{"type":"string"}}}}}},"400":{"description":"Parâmetros inválidos.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Chave ausente ou inválida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Plano incompatível.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Escopo insuficiente.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Recurso não encontrado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflito com o estado atual.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Limite de requisições excedido.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"tags":["Monitors"],"summary":"Criar radar","description":"Cria uma busca recorrente com critérios comerciais.","operationId":"monitor_create","x-achadu-scope":"monitors:write","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","description":"Nome da regra."},"query":{"type":"string","description":"Palavras monitoradas."},"source":{"type":"string","description":"Fonte ou marketplace."},"segment_id":{"type":"string","description":"Segmento de destino."},"min_price":{"type":"number","description":"Preço mínimo."},"max_price":{"type":"number","description":"Preço máximo."},"min_commission":{"type":"number","description":"Comissão mínima."},"min_discount":{"type":"number","description":"Desconto mínimo."},"order":{"type":"string","description":"Ordenação dos resultados."},"limit":{"type":"integer","description":"Máximo por rodada.","minimum":1,"maximum":100},"interval_minutes":{"type":"integer","description":"Intervalo entre buscas.","minimum":5,"maximum":10080},"auto_approve":{"type":"boolean","description":"Aprova resultados automaticamente."},"active":{"type":"boolean","description":"Ativa o monitoramento."}},"required":["name","query"],"additionalProperties":false}}}},"responses":{"201":{"description":"Recurso criado.","content":{"application/json":{"schema":{"type":"object","required":["data","request_id"],"properties":{"data":{"$ref":"#/components/schemas/Monitor"},"request_id":{"type":"string"},"created":{"type":"boolean"}}}}}},"400":{"description":"Parâmetros inválidos.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Chave ausente ou inválida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Plano incompatível.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Escopo insuficiente.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Recurso não encontrado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflito com o estado atual.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Limite de requisições excedido.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/monitors/{id}":{"get":{"tags":["Monitors"],"summary":"Ver radar","description":"Retorna critérios e último resultado de uma regra.","operationId":"monitor_get","x-achadu-scope":"monitors:read","parameters":[{"name":"id","in":"path","required":true,"description":"Identificador do recurso.","schema":{"type":"string"}}],"responses":{"200":{"description":"Operação concluída.","content":{"application/json":{"schema":{"type":"object","required":["data","request_id"],"properties":{"data":{"$ref":"#/components/schemas/Monitor"},"request_id":{"type":"string"}}}}}},"400":{"description":"Parâmetros inválidos.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Chave ausente ou inválida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Plano incompatível.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Escopo insuficiente.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Recurso não encontrado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflito com o estado atual.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Limite de requisições excedido.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"patch":{"tags":["Monitors"],"summary":"Atualizar radar","description":"Atualiza critérios, frequência e automação.","operationId":"monitor_update","x-achadu-scope":"monitors:write","parameters":[{"name":"id","in":"path","required":true,"description":"Identificador do recurso.","schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","description":"Nome da regra."},"query":{"type":"string","description":"Palavras monitoradas."},"source":{"type":"string","description":"Fonte ou marketplace."},"segment_id":{"type":"string","description":"Segmento de destino."},"min_price":{"type":"number","description":"Preço mínimo."},"max_price":{"type":"number","description":"Preço máximo."},"min_commission":{"type":"number","description":"Comissão mínima."},"min_discount":{"type":"number","description":"Desconto mínimo."},"order":{"type":"string","description":"Ordenação dos resultados."},"limit":{"type":"integer","description":"Máximo por rodada.","minimum":1,"maximum":100},"interval_minutes":{"type":"integer","description":"Intervalo entre buscas.","minimum":5,"maximum":10080},"auto_approve":{"type":"boolean","description":"Aprova resultados automaticamente."},"active":{"type":"boolean","description":"Ativa o monitoramento."}},"additionalProperties":false}}}},"responses":{"200":{"description":"Operação concluída.","content":{"application/json":{"schema":{"type":"object","required":["data","request_id"],"properties":{"data":{"$ref":"#/components/schemas/Monitor"},"request_id":{"type":"string"}}}}}},"400":{"description":"Parâmetros inválidos.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Chave ausente ou inválida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Plano incompatível.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Escopo insuficiente.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Recurso não encontrado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflito com o estado atual.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Limite de requisições excedido.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"delete":{"tags":["Monitors"],"summary":"Excluir radar","description":"Remove uma regra de monitoramento.","operationId":"monitor_delete","x-achadu-scope":"monitors:write","parameters":[{"name":"id","in":"path","required":true,"description":"Identificador do recurso.","schema":{"type":"string"}}],"responses":{"200":{"description":"Operação concluída.","content":{"application/json":{"schema":{"type":"object","required":["deleted","id","request_id"],"properties":{"deleted":{"type":"boolean"},"archived":{"type":"boolean"},"id":{"type":"string"},"request_id":{"type":"string"}}}}}},"400":{"description":"Parâmetros inválidos.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Chave ausente ou inválida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Plano incompatível.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Escopo insuficiente.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Recurso não encontrado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflito com o estado atual.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Limite de requisições excedido.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/store":{"get":{"tags":["Store"],"summary":"Ver loja","description":"Retorna somente a configuração pública da loja.","operationId":"store_get","x-achadu-scope":"store:read","responses":{"200":{"description":"Operação concluída.","content":{"application/json":{"schema":{"type":"object","required":["data","request_id"],"properties":{"data":{"$ref":"#/components/schemas/Store"},"request_id":{"type":"string"}}}}}},"400":{"description":"Parâmetros inválidos.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Chave ausente ou inválida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Plano incompatível.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Escopo insuficiente.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Recurso não encontrado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflito com o estado atual.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Limite de requisições excedido.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"patch":{"tags":["Store"],"summary":"Atualizar loja","description":"Atualiza identidade, tema, redes e privacidade da loja.","operationId":"store_update","x-achadu-scope":"store:write","requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","description":"Nome da loja."},"tagline":{"type":"string","description":"Frase principal."},"logo":{"type":"string","description":"URL do logo.","format":"uri"},"cover":{"type":"string","description":"URL da capa.","format":"uri"},"favicon":{"type":"string","description":"URL do ícone.","format":"uri"},"about":{"type":"string","description":"Descrição da loja."},"theme":{"type":"object","description":"Tokens visuais.","additionalProperties":true},"social":{"type":"object","description":"Links sociais.","additionalProperties":true},"privacy":{"type":"object","description":"Preferências públicas.","additionalProperties":true},"badge":{"type":"boolean","description":"Exibe selo."},"active":{"type":"boolean","description":"Publica a loja."}},"additionalProperties":false}}}},"responses":{"200":{"description":"Operação concluída.","content":{"application/json":{"schema":{"type":"object","required":["data","request_id"],"properties":{"data":{"$ref":"#/components/schemas/Store"},"request_id":{"type":"string"}}}}}},"400":{"description":"Parâmetros inválidos.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Chave ausente ou inválida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Plano incompatível.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Escopo insuficiente.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Recurso não encontrado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflito com o estado atual.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Limite de requisições excedido.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/journeys":{"get":{"tags":["Journeys"],"summary":"Listar jornadas","description":"Lista fluxos do DU e desempenho agregado.","operationId":"journeys_list","x-achadu-scope":"journeys:read","parameters":[{"name":"limit","in":"query","description":"Quantidade por página.","schema":{"type":"integer","minimum":1,"maximum":100,"default":30}},{"name":"offset","in":"query","description":"Deslocamento da paginação.","schema":{"type":"integer","minimum":0,"default":0}}],"responses":{"200":{"description":"Operação concluída.","content":{"application/json":{"schema":{"type":"object","required":["data","pagination","request_id"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Journey"}},"pagination":{"$ref":"#/components/schemas/Pagination"},"request_id":{"type":"string"}}}}}},"400":{"description":"Parâmetros inválidos.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Chave ausente ou inválida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Plano incompatível.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Escopo insuficiente.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Recurso não encontrado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflito com o estado atual.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Limite de requisições excedido.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"tags":["Journeys"],"summary":"Criar jornada","description":"Cria uma automação visual inicialmente segura.","operationId":"journey_create","x-achadu-scope":"journeys:write","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","description":"Nome da jornada."},"description":{"type":"string","description":"Objetivo da jornada."},"trigger":{"type":"string","description":"Gatilho inicial."},"blocks":{"type":"array","description":"Blocos do fluxo.","items":{"type":"object","additionalProperties":true}},"channels":{"type":"array","description":"Canais permitidos.","items":{"type":"string"}},"segment_id":{"type":"string","description":"Segmento elegível."},"active":{"type":"boolean","description":"Ativa a jornada."}},"required":["name","trigger"],"additionalProperties":false}}}},"responses":{"201":{"description":"Recurso criado.","content":{"application/json":{"schema":{"type":"object","required":["data","request_id"],"properties":{"data":{"$ref":"#/components/schemas/Journey"},"request_id":{"type":"string"},"created":{"type":"boolean"}}}}}},"400":{"description":"Parâmetros inválidos.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Chave ausente ou inválida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Plano incompatível.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Escopo insuficiente.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Recurso não encontrado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflito com o estado atual.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Limite de requisições excedido.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/journeys/{id}":{"get":{"tags":["Journeys"],"summary":"Ver jornada","description":"Retorna blocos, canais e métricas da jornada.","operationId":"journey_get","x-achadu-scope":"journeys:read","parameters":[{"name":"id","in":"path","required":true,"description":"Identificador do recurso.","schema":{"type":"string"}}],"responses":{"200":{"description":"Operação concluída.","content":{"application/json":{"schema":{"type":"object","required":["data","request_id"],"properties":{"data":{"$ref":"#/components/schemas/Journey"},"request_id":{"type":"string"}}}}}},"400":{"description":"Parâmetros inválidos.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Chave ausente ou inválida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Plano incompatível.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Escopo insuficiente.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Recurso não encontrado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflito com o estado atual.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Limite de requisições excedido.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"patch":{"tags":["Journeys"],"summary":"Atualizar jornada","description":"Atualiza o grafo e as regras da jornada.","operationId":"journey_update","x-achadu-scope":"journeys:write","parameters":[{"name":"id","in":"path","required":true,"description":"Identificador do recurso.","schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","description":"Nome da jornada."},"description":{"type":"string","description":"Objetivo da jornada."},"trigger":{"type":"string","description":"Gatilho inicial."},"blocks":{"type":"array","description":"Blocos do fluxo.","items":{"type":"object","additionalProperties":true}},"channels":{"type":"array","description":"Canais permitidos.","items":{"type":"string"}},"segment_id":{"type":"string","description":"Segmento elegível."},"active":{"type":"boolean","description":"Ativa a jornada."}},"additionalProperties":false}}}},"responses":{"200":{"description":"Operação concluída.","content":{"application/json":{"schema":{"type":"object","required":["data","request_id"],"properties":{"data":{"$ref":"#/components/schemas/Journey"},"request_id":{"type":"string"}}}}}},"400":{"description":"Parâmetros inválidos.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Chave ausente ou inválida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Plano incompatível.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Escopo insuficiente.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Recurso não encontrado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflito com o estado atual.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Limite de requisições excedido.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"delete":{"tags":["Journeys"],"summary":"Excluir jornada","description":"Exclui apenas jornadas que nunca foram executadas.","operationId":"journey_delete","x-achadu-scope":"journeys:write","parameters":[{"name":"id","in":"path","required":true,"description":"Identificador do recurso.","schema":{"type":"string"}}],"responses":{"200":{"description":"Operação concluída.","content":{"application/json":{"schema":{"type":"object","required":["deleted","id","request_id"],"properties":{"deleted":{"type":"boolean"},"archived":{"type":"boolean"},"id":{"type":"string"},"request_id":{"type":"string"}}}}}},"400":{"description":"Parâmetros inválidos.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Chave ausente ou inválida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Plano incompatível.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Escopo insuficiente.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Recurso não encontrado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflito com o estado atual.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Limite de requisições excedido.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/journeys/{id}/activate":{"post":{"tags":["Journeys"],"summary":"Ativar jornada","description":"Ativa ou pausa uma jornada existente.","operationId":"journey_activate","x-achadu-scope":"journeys:write","parameters":[{"name":"id","in":"path","required":true,"description":"Identificador do recurso.","schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"active":{"type":"boolean","description":"Estado desejado; padrão true."}},"additionalProperties":false}}}},"responses":{"200":{"description":"Operação concluída.","content":{"application/json":{"schema":{"type":"object","required":["data","request_id"],"properties":{"data":{"$ref":"#/components/schemas/Journey"},"request_id":{"type":"string"}}}}}},"400":{"description":"Parâmetros inválidos.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Chave ausente ou inválida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Plano incompatível.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Escopo insuficiente.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Recurso não encontrado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflito com o estado atual.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Limite de requisições excedido.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/inbox/conversations":{"get":{"tags":["Inbox"],"summary":"Listar conversas","description":"Lista metadados operacionais do DU Inbox.","operationId":"conversations_list","x-achadu-scope":"inbox:read","parameters":[{"name":"limit","in":"query","description":"Quantidade por página.","schema":{"type":"integer","minimum":1,"maximum":100,"default":30}},{"name":"offset","in":"query","description":"Deslocamento da paginação.","schema":{"type":"integer","minimum":0,"default":0}},{"name":"status","in":"query","description":"Estado da conversa.","schema":{"type":"string"}},{"name":"channel","in":"query","description":"Canal de origem.","schema":{"type":"string"}}],"responses":{"200":{"description":"Operação concluída.","content":{"application/json":{"schema":{"type":"object","required":["data","pagination","request_id"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Conversation"}},"pagination":{"$ref":"#/components/schemas/Pagination"},"request_id":{"type":"string"}}}}}},"400":{"description":"Parâmetros inválidos.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Chave ausente ou inválida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Plano incompatível.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Escopo insuficiente.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Recurso não encontrado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflito com o estado atual.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Limite de requisições excedido.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/inbox/conversations/{id}":{"get":{"tags":["Inbox"],"summary":"Ver conversa","description":"Retorna contexto da conversa sem dados diretos do contato.","operationId":"conversation_get","x-achadu-scope":"inbox:read","parameters":[{"name":"id","in":"path","required":true,"description":"Identificador do recurso.","schema":{"type":"string"}}],"responses":{"200":{"description":"Operação concluída.","content":{"application/json":{"schema":{"type":"object","required":["data","request_id"],"properties":{"data":{"$ref":"#/components/schemas/Conversation"},"request_id":{"type":"string"}}}}}},"400":{"description":"Parâmetros inválidos.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Chave ausente ou inválida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Plano incompatível.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Escopo insuficiente.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Recurso não encontrado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflito com o estado atual.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Limite de requisições excedido.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"patch":{"tags":["Inbox"],"summary":"Atualizar conversa","description":"Atribui, prioriza ou altera o modo do DU.","operationId":"conversation_update","x-achadu-scope":"inbox:write","parameters":[{"name":"id","in":"path","required":true,"description":"Identificador do recurso.","schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","description":"Estado."},"priority":{"type":"string","description":"Prioridade."},"assignee_id":{"type":"string","description":"Responsável."},"ai_mode":{"type":"string","description":"Modo de IA."},"unread":{"type":"integer","description":"Contador não lido."},"action":{"type":"string","description":"Ação operacional opcional."}},"additionalProperties":false}}}},"responses":{"200":{"description":"Operação concluída.","content":{"application/json":{"schema":{"type":"object","required":["data","request_id"],"properties":{"data":{"$ref":"#/components/schemas/Conversation"},"request_id":{"type":"string"}}}}}},"400":{"description":"Parâmetros inválidos.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Chave ausente ou inválida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Plano incompatível.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Escopo insuficiente.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Recurso não encontrado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflito com o estado atual.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Limite de requisições excedido.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/inbox/conversations/{id}/close":{"post":{"tags":["Inbox"],"summary":"Encerrar conversa","description":"Encerra a conversa e registra o evento.","operationId":"conversation_close","x-achadu-scope":"inbox:write","parameters":[{"name":"id","in":"path","required":true,"description":"Identificador do recurso.","schema":{"type":"string"}}],"responses":{"200":{"description":"Operação concluída.","content":{"application/json":{"schema":{"type":"object","required":["data","request_id"],"properties":{"data":{"$ref":"#/components/schemas/Conversation"},"request_id":{"type":"string"}}}}}},"400":{"description":"Parâmetros inválidos.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Chave ausente ou inválida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Plano incompatível.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Escopo insuficiente.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Recurso não encontrado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflito com o estado atual.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Limite de requisições excedido.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/inbox/conversations/{id}/messages":{"get":{"tags":["Inbox"],"summary":"Listar mensagens","description":"Lista o histórico paginado de uma conversa.","operationId":"messages_list","x-achadu-scope":"inbox:read","parameters":[{"name":"id","in":"path","required":true,"description":"Identificador do recurso.","schema":{"type":"string"}},{"name":"limit","in":"query","description":"Quantidade por página.","schema":{"type":"integer","minimum":1,"maximum":100,"default":30}},{"name":"offset","in":"query","description":"Deslocamento da paginação.","schema":{"type":"integer","minimum":0,"default":0}}],"responses":{"200":{"description":"Operação concluída.","content":{"application/json":{"schema":{"type":"object","required":["data","pagination","request_id"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Message"}},"pagination":{"$ref":"#/components/schemas/Pagination"},"request_id":{"type":"string"}}}}}},"400":{"description":"Parâmetros inválidos.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Chave ausente ou inválida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Plano incompatível.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Escopo insuficiente.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Recurso não encontrado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflito com o estado atual.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Limite de requisições excedido.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/inbox/conversations/{id}/reply":{"post":{"tags":["Inbox"],"summary":"Preparar resposta","description":"Registra uma resposta de saída para entrega pelo conector do canal.","operationId":"message_reply","x-achadu-scope":"inbox:write","parameters":[{"name":"id","in":"path","required":true,"description":"Identificador do recurso.","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"content":{"type":"string","description":"Conteúdo da resposta.","maxLength":6000},"type":{"type":"string","description":"Tipo da mensagem."},"media_url":{"type":"string","description":"Mídia opcional.","format":"uri"},"offer_id":{"type":"string","description":"Oferta contextual."},"use_du":{"type":"boolean","description":"Marca o DU como autor."}},"required":["content"],"additionalProperties":false}}}},"responses":{"200":{"description":"Operação concluída.","content":{"application/json":{"schema":{"type":"object","required":["data","request_id"],"properties":{"data":{"$ref":"#/components/schemas/Message"},"request_id":{"type":"string"},"delivery_pending":{"type":"boolean"}}}}}},"400":{"description":"Parâmetros inválidos.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Chave ausente ou inválida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Plano incompatível.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Escopo insuficiente.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Recurso não encontrado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflito com o estado atual.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Limite de requisições excedido.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/inbox/contacts":{"get":{"tags":["Inbox"],"summary":"Listar contatos","description":"Lista perfil, estágio e interesse sem expor telefone ou e-mail.","operationId":"contacts_list","x-achadu-scope":"inbox:read","parameters":[{"name":"limit","in":"query","description":"Quantidade por página.","schema":{"type":"integer","minimum":1,"maximum":100,"default":30}},{"name":"offset","in":"query","description":"Deslocamento da paginação.","schema":{"type":"integer","minimum":0,"default":0}},{"name":"query","in":"query","description":"Busca textual.","schema":{"type":"string"}},{"name":"stage","in":"query","description":"Estágio do CRM.","schema":{"type":"string"}}],"responses":{"200":{"description":"Operação concluída.","content":{"application/json":{"schema":{"type":"object","required":["data","pagination","request_id"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Contact"}},"pagination":{"$ref":"#/components/schemas/Pagination"},"request_id":{"type":"string"}}}}}},"400":{"description":"Parâmetros inválidos.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Chave ausente ou inválida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Plano incompatível.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Escopo insuficiente.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Recurso não encontrado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflito com o estado atual.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Limite de requisições excedido.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/analytics/summary":{"get":{"tags":["Analytics"],"summary":"Resumo de analytics","description":"Consolida ofertas, publicações, cliques e comissões.","operationId":"analytics_summary","x-achadu-scope":"analytics:read","parameters":[{"name":"days","in":"query","description":"Janela de análise em dias.","schema":{"type":"integer","minimum":1,"maximum":365,"default":30}}],"responses":{"200":{"description":"Operação concluída.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalyticsSummaryResponse"}}}},"400":{"description":"Parâmetros inválidos.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Chave ausente ou inválida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Plano incompatível.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Escopo insuficiente.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Recurso não encontrado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflito com o estado atual.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Limite de requisições excedido.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/analytics/timeseries":{"get":{"tags":["Analytics"],"summary":"Série temporal","description":"Agrupa publicações, falhas e cliques por dia.","operationId":"analytics_timeseries","x-achadu-scope":"analytics:read","parameters":[{"name":"days","in":"query","description":"Janela de análise em dias.","schema":{"type":"integer","minimum":1,"maximum":365,"default":30}}],"responses":{"200":{"description":"Operação concluída.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalyticsBreakdownResponse"}}}},"400":{"description":"Parâmetros inválidos.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Chave ausente ou inválida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Plano incompatível.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Escopo insuficiente.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Recurso não encontrado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflito com o estado atual.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Limite de requisições excedido.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/analytics/groups":{"get":{"tags":["Analytics"],"summary":"Desempenho por grupo","description":"Compara volume, entrega e erro entre grupos.","operationId":"analytics_groups","x-achadu-scope":"analytics:read","parameters":[{"name":"days","in":"query","description":"Janela de análise em dias.","schema":{"type":"integer","minimum":1,"maximum":365,"default":30}}],"responses":{"200":{"description":"Operação concluída.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalyticsBreakdownResponse"}}}},"400":{"description":"Parâmetros inválidos.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Chave ausente ou inválida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Plano incompatível.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Escopo insuficiente.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Recurso não encontrado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflito com o estado atual.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Limite de requisições excedido.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/analytics/offers":{"get":{"tags":["Analytics"],"summary":"Desempenho por oferta","description":"Ordena ofertas por publicação, clique e comissão.","operationId":"analytics_offers","x-achadu-scope":"analytics:read","parameters":[{"name":"days","in":"query","description":"Janela de análise em dias.","schema":{"type":"integer","minimum":1,"maximum":365,"default":30}},{"name":"limit","in":"query","description":"Quantidade por página.","schema":{"type":"integer","minimum":1,"maximum":100,"default":30}}],"responses":{"200":{"description":"Operação concluída.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalyticsBreakdownResponse"}}}},"400":{"description":"Parâmetros inválidos.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Chave ausente ou inválida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Plano incompatível.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Escopo insuficiente.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Recurso não encontrado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflito com o estado atual.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Limite de requisições excedido.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/analytics/sources":{"get":{"tags":["Analytics"],"summary":"Desempenho por fonte","description":"Agrupa catálogo, clique e receita por marketplace.","operationId":"analytics_sources","x-achadu-scope":"analytics:read","parameters":[{"name":"days","in":"query","description":"Janela de análise em dias.","schema":{"type":"integer","minimum":1,"maximum":365,"default":30}}],"responses":{"200":{"description":"Operação concluída.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalyticsBreakdownResponse"}}}},"400":{"description":"Parâmetros inválidos.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Chave ausente ou inválida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Plano incompatível.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Escopo insuficiente.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Recurso não encontrado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflito com o estado atual.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Limite de requisições excedido.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/analytics/heatmap":{"get":{"tags":["Analytics"],"summary":"Heatmap de interação","description":"Agrega cliques por página, elemento, dia e hora.","operationId":"analytics_heatmap","x-achadu-scope":"analytics:read","parameters":[{"name":"days","in":"query","description":"Janela de análise em dias.","schema":{"type":"integer","minimum":1,"maximum":365,"default":30}}],"responses":{"200":{"description":"Operação concluída.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalyticsBreakdownResponse"}}}},"400":{"description":"Parâmetros inválidos.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Chave ausente ou inválida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Plano incompatível.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Escopo insuficiente.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Recurso não encontrado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflito com o estado atual.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Limite de requisições excedido.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/links/convert":{"post":{"tags":["Links"],"summary":"Converter link","description":"Converte uma URL usando apenas as integrações desta conta.","operationId":"link_convert","x-achadu-scope":"links:write","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"URL HTTPS do produto.","format":"uri","maxLength":2000}},"required":["url"],"additionalProperties":false}}}},"responses":{"200":{"description":"Operação concluída.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LinkResponse"}}}},"400":{"description":"Parâmetros inválidos.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Chave ausente ou inválida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Plano incompatível.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Escopo insuficiente.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Recurso não encontrado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflito com o estado atual.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Limite de requisições excedido.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/webhooks":{"get":{"tags":["Webhooks"],"summary":"Listar webhooks","description":"Lista destinos e eventos, nunca o segredo.","operationId":"webhooks_list","x-achadu-scope":"webhooks:read","parameters":[{"name":"limit","in":"query","description":"Quantidade por página.","schema":{"type":"integer","minimum":1,"maximum":100,"default":30}},{"name":"offset","in":"query","description":"Deslocamento da paginação.","schema":{"type":"integer","minimum":0,"default":0}}],"responses":{"200":{"description":"Operação concluída.","content":{"application/json":{"schema":{"type":"object","required":["data","pagination","request_id"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Webhook"}},"pagination":{"$ref":"#/components/schemas/Pagination"},"request_id":{"type":"string"}}}}}},"400":{"description":"Parâmetros inválidos.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Chave ausente ou inválida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Plano incompatível.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Escopo insuficiente.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Recurso não encontrado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflito com o estado atual.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Limite de requisições excedido.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"tags":["Webhooks"],"summary":"Criar webhook","description":"Cria um destino HTTPS e revela o segredo uma única vez.","operationId":"webhook_create","x-achadu-scope":"webhooks:write","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","description":"Nome do destino."},"url":{"type":"string","description":"URL HTTPS pública.","format":"uri"},"events":{"type":"array","description":"Eventos ou *.","items":{"type":"string"}},"active":{"type":"boolean","description":"Ativa o destino."}},"required":["name","url","events"],"additionalProperties":false}}}},"responses":{"201":{"description":"Recurso criado.","content":{"application/json":{"schema":{"type":"object","required":["data","secret","request_id"],"properties":{"data":{"$ref":"#/components/schemas/Webhook"},"secret":{"type":"string","description":"Revelado somente nesta resposta.","examples":["whsec_…"]},"created":{"type":"boolean"},"request_id":{"type":"string"}}}}}},"400":{"description":"Parâmetros inválidos.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Chave ausente ou inválida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Plano incompatível.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Escopo insuficiente.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Recurso não encontrado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflito com o estado atual.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Limite de requisições excedido.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/webhooks/{id}":{"get":{"tags":["Webhooks"],"summary":"Ver webhook","description":"Retorna configuração segura do destino.","operationId":"webhook_get","x-achadu-scope":"webhooks:read","parameters":[{"name":"id","in":"path","required":true,"description":"Identificador do recurso.","schema":{"type":"string"}}],"responses":{"200":{"description":"Operação concluída.","content":{"application/json":{"schema":{"type":"object","required":["data","request_id"],"properties":{"data":{"$ref":"#/components/schemas/Webhook"},"request_id":{"type":"string"}}}}}},"400":{"description":"Parâmetros inválidos.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Chave ausente ou inválida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Plano incompatível.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Escopo insuficiente.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Recurso não encontrado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflito com o estado atual.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Limite de requisições excedido.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"patch":{"tags":["Webhooks"],"summary":"Atualizar webhook","description":"Atualiza URL, eventos ou estado sem trocar o segredo.","operationId":"webhook_update","x-achadu-scope":"webhooks:write","parameters":[{"name":"id","in":"path","required":true,"description":"Identificador do recurso.","schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","description":"Nome."},"url":{"type":"string","description":"URL HTTPS pública.","format":"uri"},"events":{"type":"array","description":"Eventos ou *.","items":{"type":"string"}},"active":{"type":"boolean","description":"Ativa o destino."}},"additionalProperties":false}}}},"responses":{"200":{"description":"Operação concluída.","content":{"application/json":{"schema":{"type":"object","required":["data","request_id"],"properties":{"data":{"$ref":"#/components/schemas/Webhook"},"request_id":{"type":"string"}}}}}},"400":{"description":"Parâmetros inválidos.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Chave ausente ou inválida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Plano incompatível.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Escopo insuficiente.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Recurso não encontrado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflito com o estado atual.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Limite de requisições excedido.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"delete":{"tags":["Webhooks"],"summary":"Excluir webhook","description":"Remove destino e histórico de entregas.","operationId":"webhook_delete","x-achadu-scope":"webhooks:write","parameters":[{"name":"id","in":"path","required":true,"description":"Identificador do recurso.","schema":{"type":"string"}}],"responses":{"200":{"description":"Operação concluída.","content":{"application/json":{"schema":{"type":"object","required":["deleted","id","request_id"],"properties":{"deleted":{"type":"boolean"},"archived":{"type":"boolean"},"id":{"type":"string"},"request_id":{"type":"string"}}}}}},"400":{"description":"Parâmetros inválidos.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Chave ausente ou inválida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Plano incompatível.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Escopo insuficiente.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Recurso não encontrado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflito com o estado atual.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Limite de requisições excedido.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/webhooks/{id}/deliveries":{"get":{"tags":["Webhooks"],"summary":"Listar entregas","description":"Lista tentativas, HTTP status e erros de entrega.","operationId":"webhook_deliveries","x-achadu-scope":"webhooks:read","parameters":[{"name":"id","in":"path","required":true,"description":"Identificador do recurso.","schema":{"type":"string"}},{"name":"limit","in":"query","description":"Quantidade por página.","schema":{"type":"integer","minimum":1,"maximum":100,"default":30}},{"name":"offset","in":"query","description":"Deslocamento da paginação.","schema":{"type":"integer","minimum":0,"default":0}}],"responses":{"200":{"description":"Operação concluída.","content":{"application/json":{"schema":{"type":"object","required":["data","pagination","request_id"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/WebhookDelivery"}},"pagination":{"$ref":"#/components/schemas/Pagination"},"request_id":{"type":"string"}}}}}},"400":{"description":"Parâmetros inválidos.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Chave ausente ou inválida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Plano incompatível.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Escopo insuficiente.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Recurso não encontrado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Conflito com o estado atual.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Limite de requisições excedido.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"securitySchemes":{"ApiKey":{"type":"http","scheme":"bearer","bearerFormat":"Achadu API key","description":"Use `Authorization: Bearer ach_live_...`."}},"schemas":{"Error":{"type":"object","required":["error","request_id"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","examples":["invalid_request"]},"message":{"type":"string"},"required_scope":{"type":"string"}}},"request_id":{"type":"string","examples":["req_01hzy8fx6cx2"]}}},"Pagination":{"type":"object","required":["total","limit","offset","has_more"],"properties":{"total":{"type":"integer"},"limit":{"type":"integer"},"offset":{"type":"integer"},"has_more":{"type":"boolean"}}},"Success":{"type":"object","description":"O formato de `data` varia conforme a operação. Listagens também incluem `pagination`.","properties":{"data":{},"pagination":{"$ref":"#/components/schemas/Pagination"},"created":{"type":"boolean"},"deleted":{"type":"boolean"},"request_id":{"type":"string"}},"required":["request_id"],"additionalProperties":true},"AccountResponse":{"type":"object","required":["account","request_id"],"properties":{"account":{"type":"object","required":["id","nome"],"properties":{"id":{"type":"string"},"nome":{"type":"string"},"criado_em":{"type":"string","format":"date-time"}}},"actor":{"type":["object","null"],"properties":{"id":{"type":"string"},"nome":{"type":["string","null"]},"email":{"type":"string","format":"email"},"papel":{"type":"string"}}},"request_id":{"type":"string"}}},"Offer":{"type":"object","required":["id","titulo","url"],"properties":{"id":{"type":"string"},"marketplace":{"type":["string","null"]},"titulo":{"type":"string"},"url":{"type":"string","format":"uri"},"link_afiliado":{"type":["string","null"],"format":"uri"},"preco":{"type":["number","null"]},"preco_de":{"type":["number","null"]},"moeda":{"type":"string"},"imagem":{"type":["string","null"]},"loja":{"type":["string","null"]},"categoria":{"type":["string","null"]},"cupom":{"type":["string","null"]},"comissao":{"type":["number","null"]},"curadoria":{"type":"string"},"publicada_em":{"type":["string","null"]},"criado_em":{"type":"string","format":"date-time"},"atualizado_em":{"type":["string","null"]}}},"Group":{"type":"object","required":["id"],"properties":{"id":{"type":"string"},"nome":{"type":["string","null"]},"papel":{"type":["string","null"]},"membros":{"type":["integer","null"]},"automacao":{"type":"integer"},"ativo":{"type":"integer"},"capacidade":{"type":["integer","null"]},"segmento_id":{"type":["string","null"]},"segmento":{"type":["string","null"]}}},"Segment":{"type":"object","required":["id","nome"],"properties":{"id":{"type":"string"},"nome":{"type":"string"},"slug":{"type":["string","null"]},"descricao":{"type":["string","null"]},"vitrine_nome":{"type":["string","null"]},"vitrine_frase":{"type":["string","null"]},"vitrine_cor":{"type":["string","null"]},"expansao_auto":{"type":"integer"},"distribuicao":{"type":["string","null"]},"espera":{"type":"integer"},"criado_em":{"type":"string","format":"date-time"}}},"Coupon":{"type":"object","required":["id","marketplace","codigo"],"properties":{"id":{"type":"string"},"marketplace":{"type":"string"},"codigo":{"type":"string"},"descricao":{"type":["string","null"]},"desconto":{"type":["number","null"]},"minimo":{"type":["number","null"]},"teto":{"type":["number","null"]},"valido_ate":{"type":["string","null"]},"verificado":{"type":"integer"},"ativo":{"type":"integer"}}},"Commission":{"type":"object","required":["id","marketplace","valor","moeda","status"],"properties":{"id":{"type":"string"},"marketplace":{"type":"string"},"valor":{"type":"number"},"moeda":{"type":"string"},"pedido":{"type":["string","null"]},"oferta_id":{"type":["string","null"]},"grupo_id":{"type":["string","null"]},"status":{"type":"string"},"atribuicao":{"type":["string","null"]},"pagamento_status":{"type":["string","null"]},"em":{"type":"string","format":"date-time"},"paga_em":{"type":["string","null"]}}},"Publication":{"type":"object","required":["id","estado"],"properties":{"id":{"type":"string"},"estado":{"type":"string"},"grupo_id":{"type":["string","null"]},"grupo":{"type":["string","null"]},"oferta_id":{"type":["string","null"]},"oferta":{"type":["string","null"]},"agendamento_id":{"type":["string","null"]},"erro":{"type":["string","null"]},"enviado_em":{"type":["string","null"],"format":"date-time"}}},"Template":{"type":"object","required":["id","nome","corpo"],"properties":{"id":{"type":"string"},"nome":{"type":"string"},"corpo":{"type":"string"},"com_preview":{"type":"integer"},"marketplace":{"type":["string","null"]},"criado_em":{"type":"string","format":"date-time"}}},"Schedule":{"type":"object","required":["id","tipo"],"properties":{"id":{"type":"string"},"tipo":{"type":"string"},"segmento_id":{"type":["string","null"]},"grupo_id":{"type":["string","null"]},"oferta_id":{"type":["string","null"]},"texto":{"type":["string","null"]},"imagem":{"type":["string","null"]},"quando":{"type":["string","null"]},"proximo_em":{"type":["string","null"]},"recorrencia":{"type":["string","null"]},"ativo":{"type":"integer"},"ultimo_em":{"type":["string","null"]}}},"Monitor":{"type":"object","required":["id","nome"],"properties":{"id":{"type":"string"},"nome":{"type":"string"},"fonte":{"type":"string"},"palavras":{"type":"string"},"segmento_id":{"type":["string","null"]},"preco_min":{"type":["number","null"]},"preco_max":{"type":["number","null"]},"comissao_min":{"type":["number","null"]},"desconto_min":{"type":["number","null"]},"intervalo_min":{"type":"integer"},"auto_aprovar":{"type":"integer"},"ativo":{"type":"integer"},"ultimo_resultado":{"type":["string","null"]}}},"Store":{"type":"object","required":["id"],"properties":{"id":{"type":"string"},"subdominio":{"type":["string","null"]},"dominio":{"type":["string","null"]},"nome":{"type":["string","null"]},"frase":{"type":["string","null"]},"logo":{"type":["string","null"]},"capa":{"type":["string","null"]},"favicon":{"type":["string","null"]},"tema":{"type":["string","null"]},"redes":{"type":["string","null"]},"privacidade":{"type":["string","null"]},"ativo":{"type":"integer"},"dominio_ok":{"type":"integer"}}},"Journey":{"type":"object","required":["id","nome","gatilho"],"properties":{"id":{"type":"string"},"nome":{"type":"string"},"descricao":{"type":["string","null"]},"gatilho":{"type":"string"},"blocos":{"type":["array","string"]},"canais":{"type":["array","string"]},"segmento_id":{"type":["string","null"]},"ativo":{"type":"integer"},"execucoes":{"type":"integer"},"conversoes":{"type":"integer"}}},"Conversation":{"type":"object","required":["id","canal","status"],"properties":{"id":{"type":"string"},"canal":{"type":"string"},"assunto":{"type":["string","null"]},"status":{"type":"string"},"prioridade":{"type":"string"},"intencao":{"type":["string","null"]},"sentimento":{"type":"string"},"responsavel_id":{"type":["string","null"]},"grupo_id":{"type":["string","null"]},"segmento_id":{"type":["string","null"]},"modo_ia":{"type":"string"},"nao_lidas":{"type":"integer"},"encerrado_em":{"type":["string","null"]}}},"Message":{"type":"object","required":["id","conversa_id","direcao","conteudo"],"properties":{"id":{"type":"string"},"conversa_id":{"type":"string"},"direcao":{"type":"string"},"autor_tipo":{"type":"string"},"autor_id":{"type":["string","null"]},"conteudo":{"type":"string"},"tipo":{"type":"string"},"midia_url":{"type":["string","null"]},"oferta_id":{"type":["string","null"]},"status":{"type":"string"},"criado_em":{"type":"string","format":"date-time"}}},"Contact":{"type":"object","description":"Perfil de CRM sem telefone, e-mail ou identificador direto do canal.","properties":{"id":{"type":"string"},"nome":{"type":["string","null"]},"estagio":{"type":["string","null"]},"interesses":{"type":["string","null"]},"valor_total":{"type":["number","null"]},"conversas":{"type":["integer","null"]},"ultima_interacao":{"type":["string","null"]}}},"Webhook":{"type":"object","required":["id","nome","url","eventos","ativo"],"properties":{"id":{"type":"string"},"nome":{"type":"string"},"url":{"type":"string","format":"uri"},"eventos":{"type":"array","items":{"type":"string"}},"ativo":{"type":"boolean"},"criado_em":{"type":"string","format":"date-time"},"atualizado_em":{"type":"string","format":"date-time"},"ultimo_envio_em":{"type":["string","null"]}}},"WebhookDelivery":{"type":"object","required":["id","evento","evento_id","status"],"properties":{"id":{"type":"string"},"webhook_id":{"type":"string"},"evento":{"type":"string"},"evento_id":{"type":"string"},"status":{"type":"string"},"http_status":{"type":["integer","null"]},"tentativas":{"type":"integer"},"erro":{"type":["string","null"]},"criado_em":{"type":"string","format":"date-time"},"enviado_em":{"type":["string","null"]}}},"CommissionSummaryResponse":{"type":"object","required":["data","request_id"],"properties":{"data":{"type":"object","properties":{"period_days":{"type":"integer"},"totals":{"type":"array","items":{"type":"object","properties":{"moeda":{"type":"string"},"status":{"type":"string"},"total":{"type":"number"},"count":{"type":"integer"}}}}}},"request_id":{"type":"string"}}},"AnalyticsSummaryResponse":{"type":"object","required":["data","request_id"],"properties":{"data":{"type":"object","properties":{"period_days":{"type":"integer"},"offers":{"type":"integer"},"publications":{"type":"integer"},"clicks":{"type":"integer"},"commissions":{"type":"array","items":{"type":"object","properties":{"moeda":{"type":"string"},"total":{"type":"number"},"count":{"type":"integer"}}}}}},"request_id":{"type":"string"}}},"AnalyticsBreakdownResponse":{"type":"object","required":["data","period_days","request_id"],"properties":{"data":{"type":"array","items":{"type":"object","additionalProperties":true}},"period_days":{"type":"integer"},"request_id":{"type":"string"}}},"LinkResponse":{"type":"object","required":["data","request_id"],"properties":{"data":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"marketplace":{"type":["string","null"]},"semComissao":{"type":"boolean"},"aviso":{"type":["string","null"]}}},"request_id":{"type":"string"}}},"WebhookEvent":{"type":"object","required":["id","type","created_at","data"],"properties":{"id":{"type":"string","examples":["evt_01hzy8fx6cx2"]},"type":{"type":"string","examples":["offer.created"]},"created_at":{"type":"string","format":"date-time"},"data":{"type":"object","additionalProperties":true}}}}},"webhooks":{"achaduEvent":{"post":{"summary":"Evento enviado para o destino cadastrado","description":"Valide `x-achadu-signature` calculando HMAC-SHA256 de `<timestamp>.<corpo bruto>` com o segredo revelado na criação.","parameters":[{"name":"x-achadu-event","in":"header","required":true,"schema":{"type":"string"}},{"name":"x-achadu-event-id","in":"header","required":true,"schema":{"type":"string"}},{"name":"x-achadu-timestamp","in":"header","required":true,"schema":{"type":"string"}},{"name":"x-achadu-signature","in":"header","required":true,"schema":{"type":"string","examples":["sha256=9c…"]}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookEvent"}}}},"responses":{"200":{"description":"Evento aceito."}}}}},"externalDocs":{"description":"Guias, exemplos e explorador interativo","url":"https://achadu.com/developers"}}