Para programadores de APIs

Distribuição de uma API: do exemplo público aos marketplaces

Os programadores adotam uma API que conseguem experimentar em minutos. É isso que torna a distribuição de uma API diferente da de qualquer outro produto: o exemplo público e a documentação fazem a venda, e cada marketplace, rede e lista assenta neles. Este plano põe os canais por ordem, cita os requisitos reais de cada um e verifica o teu ficheiro OpenAPI face a eles.

Resposta curta

  1. Torna a primeira chamada bem-sucedida trivial: um URL base, uma chave num só passo, um pedido para copiar e a resposta real logo ao lado.
  2. Mantém um único ficheiro OpenAPI como fonte. O Postman e a RapidAPI recomendam importá-lo, e o APIs.guru precisa de um URL estável para ele.
  3. Depois publica onde os programadores já procuram: a Postman API Network, o RapidAPI Hub se quiseres faturação integrada, o public-apis se tiveres um plano gratuito e o APIs.guru para a própria definição.
  4. Lança quando funcionar sem uma chamada comercial: Show HN e Product Hunt, e um servidor MCP se as aplicações de IA tiverem de chamar a tua API como ferramentas.

Os canais por ordem

Cada passo reaproveita o trabalho do anterior. Saltar os dois primeiros enfraquece todas as fichas seguintes.

CanalO que te dáO que exigeCusto
1 A tua documentação e um exemplo públicoA página para onde todos os outros canais apontam e onde os programadores decidem.URL base, autenticação num passo, um pedido para copiar, a respetiva resposta e erros legíveis.O teu tempo
2 Postman API NetworkVisibilidade no Postman e na pesquisa orgânica; coleções de que os programadores podem fazer fork.Um workspace público com uma coleção de referência importada do OpenAPI e uma coleção de apresentação.A documentação para publicadores não indica nenhuma taxa
3 RapidAPI HubA sua base de utilizadores, uma página de perfil otimizada para pesquisa, chaves e faturação.Um projeto de API (importação do OpenAPI), visibilidade pública, planos de preços e PayPal para os pagamentos.Publicar é gratuito; 25% dos pagamentos
4 public-apisUma linha numa lista curada com 485k estrelas no GitHub.Acesso gratuito ou um plano gratuito, HTTPS, dados de Auth e CORS e uma descrição de até 100 caracteres.Gratuito; pull requests de marketing são rejeitados
5 APIs.guruA tua definição num diretório público de definições de API.Um URL estável para uma definição legível por máquina, como OpenAPI.O formulário não indica nenhuma taxa
6 Um servidor MCP para a tua APIAs aplicações de IA podem chamar a tua API como ferramentas.Um servidor que envolva a tua API, publicado nos registos MCP.Os principais registos são gratuitos
7 Product HuntUm dia de lançamento perante early adopters.Um exemplo público que funcione e uma página que também quem não programa perceba.Gratuito
8 Show HNProgramadores que experimentam e dizem o que pensam.Algo que se possa experimentar de imediato, um título simples e tu nos comentários.Gratuito

Os nomes dos canais levam às páginas oficiais ou ao nosso perfil da plataforma. De propósito, não referimos aqui outros marketplaces.

Começa por um exemplo público

O Postman resume-o numa frase: o sucesso começa com o primeiro 200 OK no menor número de passos. Escreve o exemplo antes de qualquer ficha, porque todas as fichas vão encaminhar pessoas para ele.

  1. Um URL baseColoca-o no topo da documentação e na lista de servers do teu ficheiro OpenAPI, sempre com HTTPS.
  2. Uma chave num passoDo registo à chave sem chamada comercial. Basta uma chave de teste ou um plano gratuito com uma quota pequena.
  3. Um pedido para copiarUm comando completo com todos os cabeçalhos. Os programadores colam-no antes de lerem mais nada.
  4. A resposta realMostra o JSON que é realmente devolvido, incluindo os campos de que as pessoas precisam a seguir.
  5. Erros que explicamDocumenta as respostas 4xx: chave em falta, parâmetro errado, quota esgotada, cada uma com a sua mensagem.
curl "https://api.example.com/v1/forecast?city=Berlin" \
  -H "X-API-Key: $API_KEY"

HTTP/1.1 200 OK
{ "city": "Berlin",
  "days": [{ "date": "2026-10-01", "temp_c": 14.2 }] }

HTTP/1.1 401 Unauthorized
{ "error": "missing_api_key",
  "message": "Send your key in the X-API-Key header." }
Um pedido e uma resposta de exemplo no formato que a tua documentação deve mostrar (example.com é um marcador de posição).

Verifica o teu ficheiro OpenAPI

Cola o teu openapi.json. A verificação lê o que os canais de publicação retiram dele (título, versão, servers, operações, exemplos, autenticação) e mostra que canal está pronto. Recebes um plano em Markdown e, se cumprires os requisitos, a linha no formato do public-apis. Corre no teu navegador; nada é enviado.

O que diz o ficheiro: –

Verificações

  • Documento OpenAPI 3.x
  • info.title está definido
  • info.version está definido
  • Descrição com pelo menos 40 caracteres
  • Descrição de uma linha com até 100 caracteres
  • URL público de servidor com HTTPS
  • Pelo menos uma operação
  • Cada operação tem summary ou description
  • Os valores de operationId são únicos
  • Exemplos de pedido ou resposta
  • Respostas de erro em cada operação (4xx, 5xx ou default)
  • Tipo de autenticação lido para as fichas
  • Link de contacto ou da documentação
  • Link para os termos de serviço

Pronto para

  • Postman API Network
  • RapidAPI Hub
  • public-apis
  • APIs.guru

Linha no formato do public-apis

–

A verificação não abre URLs, não chama a tua API nem envia nada. Apenas lê o texto que colas.

Porque é que o ficheiro OpenAPI importa

RegraTexto oficialO que significa para ti
TítuloThe title of the API.info.title é obrigatório; torna-se o nome em todas as fichas.
operationIdThe id MUST be unique among all operations described in the API.IDs duplicados estragam importações e código gerado; mantém cada um único.
Importa primeiroIf you have one, we strongly suggest you start by importing your file.Começa o projeto na RapidAPI a partir do teu ficheiro OpenAPI, não à mão.
Coleção de referênciaPostman recommends you import your OpenAPI definition to create your API reference collection.Importa o ficheiro OpenAPI; não reconstruas os pedidos.
DefiniçãoThe most important requirement is the presence of a machine-readable API definition in one of the popular formats, such as: OpenAPI (formerly known as Swagger), RAML, API Blueprint, etc.Sem definição legível por máquina, não há ficha.
URL estávelSo please, provide us with a stable URL to the definition.Serve a definição num URL que não mude entre versões.

Vender através da RapidAPI

A RapidAPI é o marketplace em que quase toda a gente pensa quando pergunta como vender uma API. Publicar é gratuito; pagas uma parte do que ganhas. As APIs novas começam como privadas, por isso um projeto só aparece no hub depois de o tornares público.

Num plano de US$100 recebes US$75 com uma taxa de 25%, pagos por PayPal. Um plano gratuito está limitado a 1.000 pedidos por hora e 500.000 por mês.

  1. Importa o teu ficheiro OpenAPI ao criar o projeto; preenche os endpoints e os parâmetros.
  2. Escreve uma descrição curta e uma longa, define a categoria, o site e o URL base, e carrega um logótipo.
  3. Oferece um plano gratuito pequeno para os programadores testarem e depois planos pagos com quotas e excedentes claros.
  4. Associa o PayPal antes do primeiro pagamento; a Rapid não paga aos fornecedores de nenhuma outra forma.
  5. Mantém a tua própria documentação e página de preços: o marketplace é um canal, não a tua única montra.
RegraTexto oficialO que significa para ti
Custo de publicarIt is also free and easy to add your API to the hub.Adicionar uma API à RapidAPI não custa nada.
O que recebesAdding your API to the rapidapi.com hub gets you instant exposure to our growing user base, a search engine-optimized profile page for your API, as well as features like user management and billing services.Uma página de perfil, chaves e faturação vêm com a ficha.
Privada por predefiniçãoWhen a user or team creates an API, by default it is a private API.Muda a visibilidade para pública, senão ninguém encontra a API.
Plano gratuitoHaving a free pricing plan (with a small number of requests available) is vital to a good experience for a developer using your API.Uma pequena quota gratuita deixa os programadores testar antes de pagar.
Limites gratuitosFree API plans are limited to 1000 requests per hour and 500K requests per month.Uma utilização maior exige um plano pago ou de pagamento por utilização.
Taxa do marketplaceRapid takes a flat 25% marketplace fee on all payments made through the API Hub.Define os preços dos teus planos a contar com os 25%.
PagamentosRapid currently only pays out API providers via PayPal.Associa uma conta PayPal antes de ganhares alguma coisa.

Postman, public-apis e APIs.guru

Estes três não custam nada e chegam aos programadores no momento em que procuram uma API. Cada um tem as suas regras; se as seguires, a ficha fica.

RegraTexto oficialO que significa para ti
Primeira chamadaThis starts with getting your API consumers to their first 200 OK response in the fewest steps possible.Mede a tua documentação pela rapidez com que um desconhecido obtém um 200 OK.
VisibilidadeSharing APIs on the Postman API Network increases your API’s discovery in organic and Postman search results.Um workspace público aparece na pesquisa do Postman e nos resultados dos motores de busca.
SegredosIf Postman detects any API keys, tokens, or similar, it replaces them with placeholders.Mesmo assim, usa variáveis para as chaves nas coleções públicas.
Publicador verificadoVerify your team’s identity by verifying you own your domain.O selo exige um domínio que controles.
Acesso gratuitoPlease make sure the API you want to add has full, free access or at least a free tier and does not depend on the purchase of a device/service before submitting.APIs apenas pagas não têm lugar nesta lista.
Sem marketingPull requests that are identified as marketing attempts will not be accepted.Descreve o que a API faz, não porque é a melhor.
DescriçãoThe Description should not exceed 100 characters.Mantém a linha com 100 caracteres ou menos.

Lança a API

Um lançamento resulta melhor depois de o exemplo e pelo menos uma ficha estarem publicados, para que cada visitante possa fazer uma chamada no mesmo dia.

Show HN
Publica quando as pessoas puderem experimentar a API sem falar contigo. Um título simples, o exemplo no primeiro comentário e respostas rápidas contam mais do que a hora. Como lançar o teu projeto no Show HN →
Product Hunt
Mostra o que a API torna possível, não só os endpoints: uma demo curta, um plano gratuito e uma página que alguém que não programa perceba.
Um servidor MCP
Se as aplicações de IA tiverem de usar a tua API, envolve-a num servidor MCP e publica-o nos registos MCP. É um produto à parte, com as suas próprias fichas. Diretórios de servidores MCP: 10 sítios para publicar o teu servidor →
O teu changelog
Cada novo endpoint ou SDK é um motivo para voltar a publicar. Mantém um changelog público e põe o link na documentação.

Onde entra o LaunchRepo

O LaunchRepo trabalha dentro do teu agente de programação. O agente submete o site do teu produto a um grande catálogo de diretórios e plataformas de lançamento e mantém um registo que distingue as fichas publicadas das pendentes.

As contas nos marketplaces, os planos de preços, os pagamentos e o servidor MCP ficam contigo, porque precisam das tuas chaves e decisões. O LaunchRepo não submete APIs à RapidAPI, ao Postman nem a listas do GitHub; trata dos formulários dos diretórios gerais para o site da tua API.

Fontes

Cada regra e cada número foram verificados a 1 de outubro de 2026 na página do próprio editor e são citados palavra por palavra em inglês. Guardamos cópias do texto com as nossas provas.

FonteÚltima atualizaçãoVerificado
OpenAPI Specification v3.1.1
RapidAPI docs: What is rapidapi.com?sem data indicada
RapidAPI docs: Adding APIs - Getting Startedsem data indicada
RapidAPI docs: Hub Listing - Overviewsem data indicada
RapidAPI docs: Hub Listing - General Tabsem data indicada
RapidAPI docs: Monetizing Your API on rapidapi.comsem data indicada
RapidAPI docs: Payouts and Financesem data indicada
Postman Docs: Postman API Network overviewsem data indicada
Postman Docs: Showcase your public APIs on the Postman API Networksem data indicada
Postman Docs: Become a verified publisher on the Postman API Networksem data indicada
Postman Docs: Prepare your public collectionssem data indicada
public-apis/public-apis: CONTRIBUTING.mdsem data indicada
public-apis/public-apissem data indicada
APIs.guru: Add APIsem data indicada

Perguntas frequentes

Como promovo uma API?
Começa por um exemplo público que leve um desconhecido à primeira chamada bem-sucedida em minutos e depois publica a API onde os programadores procuram: a Postman API Network, a RapidAPI se quiseres faturação integrada, o public-apis para APIs gratuitas e o APIs.guru para a definição. Lança no Show HN e no Product Hunt quando funcionar sem a tua ajuda.
Como vendo uma API na RapidAPI?
Cria um projeto de API no RapidAPI Studio, importa o teu ficheiro OpenAPI, preenche a ficha do hub, adiciona planos de preços, torna a API pública e associa o PayPal para os pagamentos. Publicar é gratuito; na data da verificação, a Rapid cobrava uma taxa fixa de 25% do marketplace sobre os pagamentos.
Preciso de um ficheiro OpenAPI?
Não para todos os canais, mas é o que mais trabalho poupa. A RapidAPI e o Postman recomendam importá-lo, e o APIs.guru só lista definições legíveis por máquina. Mantém um único ficheiro como fonte para a documentação e as fichas.
Uma API paga pode entrar na lista public-apis?
Só se oferecer acesso gratuito completo ou pelo menos um plano gratuito e não exigir a compra de um dispositivo ou serviço. Os mantenedores rejeitam pull requests que soem a marketing.
A minha API também deve ser um servidor MCP?
Se as aplicações de IA tiverem de a chamar como ferramenta, sim, como um servidor à parte que envolve a API. É publicado em registos MCP, não em marketplaces de APIs.
O LaunchRepo publica a minha API na RapidAPI ou no Postman?
Não. Essas fichas precisam das tuas contas, chaves, preços e dados de pagamento. O LaunchRepo submete o site do teu produto a diretórios gerais e plataformas de lançamento através do teu agente de programação.

Deixa os diretórios com o teu agente

Uma só compra, o teu agente de programação, cada produto que crias: o LaunchRepo submete o site da tua API a diretórios e plataformas de lançamento enquanto tu melhoras a documentação.

Ver preços