Guia para desenvolvedores
Crie a sua própria ferramenta de automação de construção de links com a BlogDrip API
Ligue o seu software directamente ao BlogDrip e automatize a encomenda de artigos de convidado. Construa fluxos de trabalho SEO personalizados, integre as suas aplicações existentes e gere operações de construção de links de forma mais eficiente.
Por que automatizar
Por que criar a sua própria ferramenta de automação de construção de links
As agências de SEO e as equipas internas de marketing enfrentam o mesmo padrão operativo: procurar manualmente oportunidades de publicação, registar manualmente encomendas de artigos de convidado, conciliar várias campanhas de clientes, transferir informação entre sistemas internos, monitorizar o progresso das encomendas e tentar escalar tudo isto sem aumentar proporcionalmente o número de colaboradores.
Uma integração via API retira o trabalho mecânico repetitivo à sua equipa e converte‑no em código. O seu software existente — o CRM, a ferramenta de gestão de campanhas ou o painel personalizado onde a sua equipa já trabalha — comunica directamente com o marketplace. Os operadores mantêm‑se focados na estratégia, nos briefings e no controlo de qualidade em vez do registo de encomendas.
A automação traz eficiência de fluxo de trabalho, não posições nos resultados de SEO. Não fará com que uma campanha fraca resulte, nem substituirá o julgamento humano na selecção de publicadores. O que faz bem é remover a camada de entrada de dados, de modo que, quando decidir o que comprar, possa executar em qualquer volume.
O que pode construir
O que pode criar com a BlogDrip API
Padrões práticos para software construído sobre uma integração programática com o marketplace.
Painel personalizado para artigos de convidado
Uma aplicação interna que se liga ao BlogDrip e submete encomendas de artigos de convidado suportadas a partir de uma interface que a sua equipa controla.
Sistema de gestão para agências de SEO
Encomendas de artigos de convidado integradas num fluxo de trabalho de agência existente, para que os gestores de campanha nunca saiam do sistema que já utilizam.
Submissão automática de encomendas
Pedidos via API criam encomendas de artigos de convidado suportadas em lote, sem a etapa manual de introdução de dados por encomenda.
Gestão de campanhas de clientes
Ligue os registos internos de clientes e campanhas aos fluxos de encomenda do BlogDrip — uma única fonte de verdade sobre quem compra o quê.
Automação de fluxos de trabalho
Dispare operações suportadas pela API a partir de processos internos — aprovações, arranques, ondas de campanha programadas.
Relatórios e monitorização
Extraia informação relacionada com encomendas para ferramentas de relatório personalizadas onde suportado. Limite o âmbito dos relatórios ao que a API realmente expõe em vez de assumir visibilidade total em tempo real.
Arquitetura
Exemplo de arquitetura de automação
Uma integração saudável separa preocupações por quatro camadas.
No topo está a sua aplicação de automação externa — um painel personalizado, software de agência de SEO, CRM interno ou sistema de gestão de campanhas. É aqui que a sua equipa trabalha no dia a dia.
Por baixo fica o backend da sua aplicação. As responsabilidades são as que toda a integração deve cumprir: armazenar `x-client-id` e `x-client-secret` de forma segura, validar a entrada antes de chegar ao BlogDrip, preparar e enviar pedidos à API, tratar respostas `{ data, pagination }`, registar eventos operacionais e gerir reintentos de forma segura para que um pico de rede transitório não se transforme numa encomenda paga duplicada.
A partir daí, os pedidos atingem a BlogDrip Advertiser API — a superfície pública e versionada sob `/api/public/*` — que expõe a funcionalidade suportada de encomenda de artigos de convidado.
A API encaminha as encomendas para o marketplace do BlogDrip — mais de 275,000+ sites de inventário total — e daí para o processamento de encomendas e o fluxo de publicação aplicável. Dependendo do site seleccionado, a publicação pode ser manual do lado do publicador ou automatizada através do plugin WordPress ou da Agency API. Nem todos os sites no marketplace suportam Publicação Instantânea, por isso a sua integração deve tratar o tempo de publicação como dependente do fluxo de trabalho, e não instantâneo.
Crie a sua ferramenta de automação, passo a passo
Oito passos desde o planeamento até à monitorização. Trate‑os como referência, não como uma sequência rígida — muitos decorrem em paralelo.
Defina o seu fluxo de automação
Identifique quais as tarefas a automatizar, que informação a sua aplicação precisa, quando uma encomenda deve ser submetida, como prevenir encomendas duplicadas, como os erros são tratados e como os dados de campanha são armazenados. Um exemplo concreto de scoping: uma agência que gere 20 clientes, cada um com 3–5 campanhas activas, quer que novas campanhas gerem automaticamente encomendas para uma lista curta de sites pré‑aprovados — mas apenas depois de um humano aprovar o briefing da campanha.
Obtenha acesso à BlogDrip API
Abra a sua conta em app.blogdrip.com/settings e vá a Definições da conta → Acesso à API para encontrar as suas credenciais. Verá dois valores: um `x-client-id` e um `x-client-secret`. O secret é mostrado apenas uma vez quando é emitido ou rodado, por isso copie‑o imediatamente para o seu gestor de segredos. O acesso requer um gasto mínimo de €500 por mês na conta — tanto encomendas manuais como via API contam para o total. O acesso à API é desactivado automaticamente se o mínimo não for atingido num dado mês. Os €500 são um limite de gasto, não uma taxa de subscrição separada.
Leia a documentação da API
A documentação oficial em app.blogdrip.com/api/public/docs/index.html descreve os endpoints exactos sob o namespace `/api/public/*`, autenticação (os dois pares de cabeçalhos mencionados acima), métodos de pedido, parâmetros obrigatórios, formatos de resposta (endpoints de listagem envolvem respostas em `{ data, pagination }` com paginação 0-based `?page=0`), erros de validação (`{ message }`) e as operações de encomenda disponíveis. Considere a documentação como a fonte autoritativa: se um parâmetro não está documentado, não assuma que existe.
Construa a ligação à API
Crie um backend de aplicação que armazene de forma segura tanto o `x-client-id` como o `x-client-secret` (variáveis de ambiente, gestor de segredos — nunca no código do frontend), envie pedidos autenticados com ambos os cabeçalhos, analise respostas, trate erros e escreva logs estruturados para cada chamada de saída. Mantenha o cliente da API como um módulo pequeno e bem testado para que o restante da sua aplicação nunca fale com o BlogDrip directamente.
Implemente a encomenda automática de artigos de convidado
Ligue o seu fluxo de trabalho interno às operações de encomenda suportadas pelo BlogDrip. Um fluxo típico: uma nova campanha é criada no seu sistema → é seleccionado um site (resolva o seu `marketSiteId` a partir dos endpoints do marketplace) → a sua aplicação prepara a informação necessária para a encomenda (título, URL, descrição, `categoryId`, `marketSiteId`, `campaignId`, `scheduleDate` opcional, `linkNoFollow`) → o backend valida a encomenda segundo as suas regras de negócio → a aplicação submete a encomenda através da Advertiser API → a resposta é armazenada no seu sistema para rastreabilidade. Valide cada campo contra a especificação OpenAPI antes de enviar.
Trate erros e encomendas duplicadas
Valide pedidos antes de os submeter, previna encomendas duplicadas por acidente (uma chave de idempotência ou uma verificação de desduplicação no servidor são padrões seguros), registe cada falha da API com contexto suficiente para depurar mais tarde, trate problemas temporários de conectividade de forma graciosa e respeite os limites de taxa documentados. Uma regra a interiorizar: nunca reenvie automaticamente um pedido de criação de encomenda não idempotente sem confirmação explícita humana ou do sistema — um reenvio de uma encomenda bem sucedida da qual não viu a resposta cria um débito em duplicado.
Teste a sua integração
Execute a sua integração contra um ambiente sandbox se um estiver documentado. Se não existir sandbox, teste cuidadosamente contra produção — nunca execute suites de teste automáticas que criem encomendas pagas reais sem autorização explícita. Utilize uma campanha de teste dedicada com revisão humana antes da primeira encomenda automática ser enviada e restrinja as execuções de teste automáticas a uma lista curta e aprovada de sites para testes de integração.
Coloque em produção e monitorize
Transfira as credenciais para o seu cofre de segredos em produção, adicione monitorização para falhas de integração e padrões invulgares de submissão de encomendas, acompanhe os resultados da submissão de encomendas de ponta a ponta, mantenha logs operacionais tempo suficiente para depurar um incidente com duas semanas, monitorize o gasto da conta para não perder o acesso à API por ficar abaixo do mínimo mensal de €500 e acompanhe o changelog do BlogDrip para actualizações da API que possam exigir manutenção da integração.
Padrões de integração
Como é uma integração saudável
A fonte autoritativa para exemplos executáveis é a especificação OpenAPI em app.blogdrip.com/api/public/openapi.json e a documentação legível em /api/public/docs. A spec é aquilo contra o que o seu código deve ser gerado ou verificado — não um excerto de landing page que pode ficar desactualizado.
Na prática, uma integração limpa tende a seguir a mesma forma. Um módulo fino cliente‑API na sua linguagem preferida — uma função wrapper por operação necessária — trata da mecânica: define os cabeçalhos `x-client-id` e `x-client-secret` em cada pedido, serializa o corpo do pedido, desserializa o envelope `{ data, pagination }` nos endpoints de listagem (paginação 0-based) e converte respostas de erro (`{ message }`) em excepções que a sua lógica de negócio consegue apanhar de forma limpa. Cada wrapper tem pelo menos um teste a afirmar a forma documentada, para que uma alteração de schema surja como teste falhado antes de chegar à produção. Só depois desse módulo estar estável o liga ao resto da sua aplicação — triggers de campanha, filas de encomendas, workers de reintento, relatórios.
Essa sequência mantém a integração auditável: o seu cliente da API é uma superfície pequena e bem testada; todo o resto comunica com o BlogDrip através dele.
Boas práticas
O que faz uma integração via API perdurar
Padrões que mantêm os sistemas automatizados saudáveis muito depois do dia de lançamento.
Idempotência por design
Considere a criação de encomendas como cara e irreversível. Faça a desduplicação do seu lado antes de o pedido sair — nunca depois.
Higiene de credenciais
As credenciais da API devem residir num gestor de segredos, com âmbito por ambiente. Faça a rotação quando alguém sair, não apenas após uma violação.
Registo estruturado
Cada par pedido‑resposta deve ter um ID de correlação. Quem depurar uma encomenda antiga agradecerá.
Clientes conscientes dos limites de taxa
Respeite os limites de taxa documentados. Um cliente que reduz a cadência de forma adequada escala mais do que um que tenta reenvios agressivos.
Humano no processo
Proteja a primeira chamada em produção com aprovação humana. Expanda a automação apenas após a integração provar ser estável.
Monitorização de gastos
Alerte quando o gasto mensal da conta tender para ou estiver abaixo de €500. Perder o acesso à API a meio de uma campanha é problemático.
Perguntas frequentes
Para quem se destina a BlogDrip API?
Contas de anunciante que queiram ligar o seu próprio software — um painel personalizado, uma plataforma de agência de SEO, um CRM interno — ao fluxo de encomenda de artigos de convidado do BlogDrip. Os utilizadores típicos são agências que gerem campanhas em volume, equipas internas de SEO que integram com uma stack existente e desenvolvedores que criam ferramentas operacionais para um cliente ou produto específico.
É necessário ser desenvolvedor para utilizar a API?
Para construir a integração em si, sim. A API é uma interface programática — o seu uso exige escrever código ou trabalhar com um desenvolvedor. Se pretender os benefícios operacionais sem o trabalho de integração, a interface do marketplace cobre a mesma funcionalidade de encomenda manualmente.
Quais são os requisitos de acesso?
Uma conta activa no BlogDrip que gaste pelo menos €500 por mês no total — tanto encomendas manuais como via API contam para o limite. O acesso à API é desactivado automaticamente se a sua conta gastar menos num dado mês. Os €500 são um limite de volume, não uma taxa de subscrição separada para a API.
Onde está a documentação da API?
A documentação oficial da API está publicada em app.blogdrip.com/api/public/docs/index.html, com a especificação OpenAPI legível por máquina em app.blogdrip.com/api/public/openapi.json. Ambas descrevem o esquema de autenticação, o catálogo completo de endpoints sob o namespace `/api/public/*`, formatos de pedido e resposta, o formato de paginação e respostas de erro. Considere‑as a fonte de verdade para a sua integração.
Onde encontro as minhas credenciais da API?
Em Definições da conta → Acesso à API em app.blogdrip.com/settings. Receberá um `x-client-id` e um `x-client-secret`; ambos devem ir em cada pedido autenticado como cabeçalhos HTTP. O secret é mostrado apenas uma vez quando é emitido ou rodado — copie‑o imediatamente para o seu gestor de segredos, pois não pode ser recuperado depois. As credenciais são por conta; trate‑as como qualquer outro segredo e mantenha‑as fora do controlo de versão.
Como funciona a paginação nos endpoints de listagem?
Os endpoints de listagem envolvem as suas respostas num envelope `{ data, pagination }` e usam paginação 0-based — passe `?page=0` para a primeira página, `?page=1` para a segunda, e assim sucessivamente. O bloco de paginação na resposta indica se existem mais páginas. Se estiver a migrar da interface legada `/api/<path>`, a forma da resposta mantém‑se — apenas o caminho base muda para `/api/public/*`.
A API suporta webhooks?
Consulte a spec OpenAPI em app.blogdrip.com/api/public/openapi.json para a lista actual de mecanismos de callback ou notificação de eventos suportados. Se uma funcionalidade não estiver listada, construa a sua integração sem assumir que existe — fazer polling à API ao seu próprio ritmo é um fallback seguro.
Existe um ambiente sandbox?
A resposta autoritativa encontra‑se na documentação actual da API. Se um sandbox estiver listado, utilize‑o para testes de integração. Se não estiver listado, não crie encomendas pagas reais durante testes automatizados sem autorização explícita — utilize antes uma campanha de teste dedicada e revisão humana.
As encomendas via API podem usar Publicação Instantânea?
A disponibilidade da Publicação Instantânea depende do site seleccionado ter uma integração de publicação automatizada suportada (ou o plugin BlogDrip para WordPress ou uma ligação via Agency API). Qualquer encomenda — API ou manual — colocada num site elegível pode beneficiar de publicação automatizada. Nem todos os sites no marketplace a suportam, portanto a sua integração deve tratar o tempo de publicação por site, e não de forma uniforme.
Qual a diferença entre a Advertiser API e a Agency API?
A Advertiser API destina‑se a clientes que querem automatizar encomendas de artigos de convidado a partir do seu próprio software. A Agency API é para agências externas, plataformas de link building e redes de publicadores que queiram ligar o seu próprio inventário ao BlogDrip e automatizar o cumprimento suportado. Ambas são independentes — usar uma não exige a outra.
O que acontece se reencaminhar um pedido de criação de encomenda que falhou?
Se não viu uma resposta confirmada, assuma que o primeiro pedido pode ter sido bem‑sucedido no servidor. Não reenvie automaticamente a criação de encomendas não idempotentes. Acrescente uma chave de desduplicação no servidor ou consulte a existência da possível encomenda antes de tentar novamente — o que quer que o seu fluxo de trabalho suporte de forma limpa. Um reenvio sobre uma encomenda bem‑sucedida mas cuja resposta não viu cria um débito em duplicado.
Pronto para automatizar a sua construção de links?
Abra a documentação da API, gere as suas credenciais e comece a construir. O marketplace escala com a sua automação — não o contrário.