Melhor Alternativa de Apiário

O Apiary está sendo desativado. A Oracle publicou um comunicado sobre o término do suporte ao Apiary, e reportagens do setor de ferramentas de API indicam o encerramento final do serviço hospedado por volta de setembro de 2026. O site ainda carrega hoje, mas a trajetória tem sido visível por anos: a Oracle adquiriu o Apiary em janeiro de 2017, descontinuou os planos pagos em 2018 e deixou as ferramentas de código aberto (Dredd, Gavel) caírem em status de arquivadas. Se a documentação da sua API está no apiary.io, você não está mais avaliando alternativas. Você está migrando, e o prazo não é seu para adiar.

Aqui está a resposta direta: o Apidog é a melhor alternativa ao Apiary, porque ele substitui tudo o que o Apiary fazia (edição de especificação design-first, documentos interativos hospedados, um servidor mock) e adiciona as partes que o Apiary nunca terminou: testes automatizados de API, validação orientada por especificação para substituir o agora arquivado Dredd, e integração CI. É gratuito para até 4 usuários, com planos pagos a partir de US$ 9 por usuário por mês. A única ressalva honesta é que o Apidog não importa arquivos API Blueprint diretamente, então projetos baseados em Blueprint precisam de uma conversão única para OpenAPI na saída. Este artigo aborda o que está acontecendo com o Apiary, o caminho exato da migração, incluindo essa etapa de conversão, e qual alternativa se encaixa se o Apidog não for ideal.

O que realmente está acontecendo com o Apiary

O Apiary, fundado em 2011, efetivamente inventou o fluxo de trabalho de API design-first como produto. Ele deu ao mundo o API Blueprint, um formato de descrição de API baseado em Markdown da era antes de o OpenAPI vencer, além do layout de documentação de três colunas que a Stripe tornou famoso e todos os outros copiaram. Ele incluía um servidor mock hospedado, sincronização com GitHub e um par de ferramentas de teste de contrato de código aberto muito apreciadas, Dredd e Gavel.

Então a Oracle o comprou em janeiro de 2017, e o produto entrou em um longo período de silêncio. As camadas pagas foram descontinuadas em 2018, deixando o Apiary como um serviço legado gratuito, enquanto a Oracle direcionava clientes corporativos para sua API Platform Cloud. O desenvolvimento de novos recursos parou. Dredd e Gavel foram arquivados. E agora o fim formal: o comunicado da Oracle sobre o término do suporte, com o serviço hospedado previsto para ser desativado por volta de setembro de 2026. O Bump.sh, um dos fornecedores que publicam guias de migração, explicou claramente em sua postagem de despedida: exporte suas descrições de API antes do desligamento, porque depois dele não haverá mais nada para exportar.

Duas consequências práticas se seguem. Primeiro, tudo o que existe apenas dentro do Apiary (descrições de API, textos de documentação, configuração de equipe) precisa sair agora, enquanto os botões de exportação ainda funcionam. Segundo, como o API Blueprint não tem uma ferramenta sucessora mantida, a migração também é uma migração de formato: o formato de destino sensato é o OpenAPI, seja qual for a plataforma em que você pousar.

O que você está substituindo

Ajuda ser preciso sobre o que o Apiary realmente fazia pela sua equipe, porque o substituto precisa cobrir cada parte:

• Um editor de especificações design-first. Você escrevia API Blueprint (ou, em projetos posteriores, OpenAPI 3.0) no navegador, e os documentos eram atualizados ao vivo.
• Documentação interativa hospedada. A referência de três colunas com exemplos de solicitações, em uma URL apiary.io.
• Um servidor mock. Todo projeto Apiary tinha um endpoint mock hospedado que servia os exemplos da sua especificação, para que os consumidores pudessem integrar antes que o backend existisse.
• Sincronização com GitHub. O arquivo de especificação ficava no seu repositório e sincronizava em ambos os sentidos.
• Teste de contrato via Dredd. O executor de código aberto que reproduzia sua especificação contra uma implementação real e relatava desvios. Agora está arquivado; abordamos o problema de substituição em como validar sua API contra sua especificação sem o Dredd.

Esse pacote (design, documentos, mock, validação) é exatamente o formato de uma plataforma de desenvolvimento de API moderna. É por isso que o melhor alvo de migração não é um renderizador de documentação, mas uma plataforma com o mesmo formato e desenvolvimento ativo por trás dela.

A resposta: Apidog

Apidog é uma plataforma de desenvolvimento de API usada por mais de 500.000 desenvolvedores. Ela cobre o ciclo de vida completo que o Apiary esboçou em 2011 e depois parou de construir: design, documentação, mocking, depuração e testes automatizados, tudo impulsionado por uma única especificação.

Para alguém migrando especificamente do Apiary:

1. Design-first é o fluxo de trabalho padrão. O Apidog possui um editor de especificações visual e um editor de código para OpenAPI 3.x. Você define endpoints, esquemas e exemplos uma vez; documentos, mocks e testes são visualizações geradas dessa definição, a mesma filosofia que o Apiary foi pioneiro, com um produto mantido por trás.
2. Os documentos são hospedados, interativos e seus. A documentação publicada recebe o layout de referência moderno com um console "experimente" funcionando, em um domínio personalizado, com versionamento. Nenhuma URL apiary.io para perder em um desligamento.
3. O servidor mock é mais inteligente do que o que você está deixando. O mock do Apiary reproduzia seus exemplos escritos. O smart mock do Apidog gera respostas realistas de seus esquemas no momento em que a especificação existe, sem a necessidade de exemplos, e você pode adicionar regras de mock personalizadas onde o determinismo importa.
4. A validação de contrato substitui o Dredd. Os cenários de teste automatizados do Apidog executam solicitações reais contra sua implementação e validam as respostas em relação aos esquemas da especificação, que é o trabalho que o Dredd fazia, além de asserções, casos orientados por dados e execuções CI via Apidog CLI. Os documentos também são publicados junto com um servidor MCP, para que agentes de IA possam ler sua especificação diretamente; detalhes em o que é o Apidog MCP Server.

Migrando do Apiary, passo a passo

A migração tem um passo extra em comparação com uma troca normal de ferramenta, e é melhor dizer isso de antemão: o Apidog importa OpenAPI (Swagger 2.0, OpenAPI 3.0 e 3.1), coleções Postman, HAR, RAML, JMeter, apiDoc, I/O Docs, WADL e Google Discovery, de acordo com a documentação de importação do Apidog. O API Blueprint não está nessa lista, então projetos Blueprint convertem para OpenAPI primeiro. Na prática, este é um comando único, e é o mesmo passo que todo outro destino sério exige, porque ninguém mais mantém ferramentas Blueprint.

1. Exporte tudo do Apiary agora

Para cada projeto, baixe a descrição da API do editor do Apiary. Se o projeto sincroniza com o GitHub, sua fonte da verdade já está no repositório; confirme se está atualizada. Projetos Apiary posteriores, criados em OpenAPI 3.0, já estão no formato correto e podem pular o passo 2. Faça isso primeiro e completamente, antes de tocar em qualquer outra coisa: as exportações são o passo com um prazo.

2. Converta API Blueprint para OpenAPI

Use um dos conversores mantidos:

• api-spec-converter (LucyBot), que lida diretamente com API Blueprint para OpenAPI
• apib2swagger, um conversor focado de Blueprint para Swagger/OpenAPI
• openapi-format depois, se você quiser normalizar a saída e atualizá-la para OpenAPI 3.1

Então, lint o resultado (um validador como vacuum, ou qualquer linter OpenAPI em sua cadeia de ferramentas) e verifique manualmente dois pontos fracos conhecidos: esquemas de autenticação, que o API Blueprint nunca modelou formalmente e, portanto, os conversores não conseguem recuperar totalmente, e qualquer prosa que estivesse nas seções Markdown do Blueprint em vez de nas descrições dos endpoints. Orce uma hora por API, não uma semana; o formato é Markdown, não mágica.

3. Importe para o Apidog

Configurações do Projeto, Importação Manual, selecione seu arquivo OpenAPI (ou importe de uma URL). Endpoints, esquemas e exemplos chegam estruturados e agrupados. Documentos de referência existem imediatamente, e o servidor mock inteligente está ativo para cada endpoint importado sem configuração adicional, o que restaura a capacidade "URL mock para consumidores" que o Apiary lhe deu.

4. Reconstrua as partes que o Apiary não conseguia fazer de qualquer forma

Aponte um domínio personalizado para seus documentos publicados, para que o próximo desligamento da plataforma (de qualquer um) nunca leve sua URL de documentos com ele. Recrie suas verificações Dredd como cenários de teste do Apidog: solicitações reais, validação de esquema contra a especificação, executadas localmente ou em CI via CLI. Se sua equipe tinha consumidores dependendo da URL mock do Apiary, envie a eles a nova URL base mock no mesmo e-mail que anuncia a mudança dos documentos.

Um projeto de API única migra em uma tarde, incluindo a conversão. Um portfólio de uma dúzia de APIs Blueprint é um sprint, a maior parte dele a verificação manual dos esquemas de autenticação.

Apiary vs Apidog em um relance

O que custa substituir uma ferramenta gratuita

O preço do Apiary era sua melhor característica restante, então a comparação justa para uma equipe em migração é a conta anual no destino. Usando os preços de tabela: Apidog gratuito para 4 usuários, depois US$ 9 por usuário por mês; SwaggerHub Team a US$ 34,44 por usuário por mês; ReadMe Pro a US$ 250 por mês, cobrado anualmente:

A nota honesta: se tudo o que você precisa é um lugar para renderizar uma especificação gratuitamente, várias ferramentas apenas de docs também têm camadas gratuitas, e a tabela acima só importa quando você quer o servidor mock, testes e colaboração que tornaram o Apiary útil em primeiro lugar. O plano gratuito do Apidog cobre tudo isso para até 4 usuários, o que para muitos refugiados do Apiary significa que a migração custa exatamente a tarde de conversão.

Se o Apidog não for a opção certa

Uma seção honesta, já que "continuar usando Apiary" não está no menu:

• Você só quer renderização de documentação, nada mais. Se sua especificação é produzida e testada em outro lugar e você precisa puramente de belos documentos hospedados com ferramentas de registro de mudanças, um produto focado em documentos como Bump.sh (cujo guia de migração para usuários do Apiary é genuinamente bom) é um ponto de chegada razoável. Você ainda precisará converter Blueprint para OpenAPI para chegar lá.
• Você está padronizando a pilha SmartBear. O SwaggerHub é o descendente filosófico mais próximo da ideia de registro de especificações hospedadas do Apiary. Esteja ciente do custo por assento e das execuções de teste mensuradas; detalhamos isso em a melhor alternativa ao SwaggerHub.
• Seu centro de gravidade é a governança de design para uma grande equipe de plataforma. O Stoplight construiu ferramentas de guia de estilo e governança aprofundadas; veja a melhor alternativa ao Stoplight para comparar antes de se comprometer.
• Você está emocionalmente apegado ao API Blueprint. Simpatizamos, mas não o faça. As ferramentas do formato não são mantidas, a empresa que o criou está sendo desativada, e o OpenAPI venceu. Converta uma vez e nunca mais pense nisso. Nosso guia antigo para API Blueprint pode permanecer como uma leitura histórica.

Perguntas frequentes

Quando exatamente o Apiary será desativado?

A Oracle anunciou o término do suporte ao Apiary em seus fóruns, e as reportagens atuais de fornecedores de ferramentas de API indicam o desligamento do serviço hospedado por volta de setembro de 2026. A suposição mais segura é simples: exporte agora, porque cada parte do produto já não é mantida.

O Apidog pode importar arquivos API Blueprint diretamente?

Não. O Apidog importa formatos OpenAPI/Swagger, Postman, HAR, RAML, JMeter, apiDoc, I/O Docs, WADL e Google Discovery. Converta API Blueprint para OpenAPI primeiro com uma ferramenta como api-spec-converter ou apib2swagger, depois importe o resultado. É um passo único, e verifique os esquemas de autenticação manualmente depois.

O que substitui o servidor mock do Apiary?

O servidor mock inteligente integrado do Apidog. Onde o Apiary reproduzia os exemplos que você escreveu, o Apidog gera respostas realistas a partir de seus esquemas automaticamente, e você pode definir regras mock personalizadas para casos específicos. Cada endpoint importado recebe um endpoint mock sem nenhuma configuração.

O que substitui o Dredd para testes de contrato?

Os cenários de teste automatizados do Apidog: eles enviam solicitações reais à sua implementação e validam as respostas em relação aos esquemas da sua especificação, com asserções e execução CI por meio do Apidog CLI. Isso cobre o trabalho do Dredd, além dos recursos de suíte de testes que o Dredd nunca teve.

O Apidog é realmente gratuito para uma pequena equipe?

Sim. O plano gratuito cobre até 4 usuários com os editores de especificações, documentos interativos publicados, o servidor mock inteligente e testes de API incluídos. Acima de 4 usuários, custa US$ 9 por usuário por mês, que é o preço por assento mais baixo entre os destinos sérios de migração do Apiary.

Exporte hoje, não redesenhe nada

A ordem das operações importa: exporte do Apiary primeiro, converta Blueprint para OpenAPI em segundo, e só então avalie os destinos à vontade, porque os dois primeiros passos têm um prazo e o terceiro não. Quando estiver pronto, importe o arquivo OpenAPI para o Apidog e você terá documentos, mocks e um ambiente de teste antes que a tarde termine. Baixe o Apidog ou comece no navegador; uma equipe de 4 não paga nada, e o fluxo de trabalho design-first que o Apiary inventou finalmente obtém a plataforma mantida que merecia.