Pular para o conteúdo principal

Visão geral

A REST API do Web2MD permite converter qualquer página web ou HTML bruto em Markdown limpo de forma programática. Use-a para construir pipelines, automatizar a ingestão de conteúdo ou integrar o Web2MD às suas próprias ferramentas.
A REST API requer um plano PRO. Gere sua chave de API no painel do Web2MD.

Especificações legíveis por máquina

Use a especificação OpenAPI para gerar automaticamente SDKs de cliente ou importar em ferramentas como Postman, Swagger UI ou frameworks de agentes de IA.

Autenticação

Todas as requisições devem incluir sua chave de API no cabeçalho Authorization:
As chaves de API têm o prefixo w2m_ e estão vinculadas à sua conta.

Endpoint

POST https://web2md.org/api/v1/convert

Corpo da requisição

Forneça url ou html, nunca os dois. A requisição falhará com erro 400 se ambos estiverem presentes ou se nenhum for fornecido.

Opções

Resposta

Uma resposta bem-sucedida retorna:

Limites de requisições

As requisições à API têm um limite de 60 requisições por minuto por chave de API. Se você exceder o limite, a API retorna o código de status 429. Aguarde a janela de reset antes de tentar novamente.

Respostas de erro

Todas as respostas de erro seguem este formato:

Exemplos

Convertendo uma URL com curl

Convertendo HTML bruto com curl

JavaScript (fetch)

Armazene sua chave de API em uma variável de ambiente em vez de deixá-la fixa no código. Por exemplo, use process.env.WEB2MD_API_KEY no Node.js.