A nossa documentação da API: o que é, para quem é e como lá chegar

WhatsApp e APIs·· 10 visualizações· 4 min de leitura

A resposta curta: a documentação da API é o site onde explicamos, página a página, como ligar os seus programas à sua conta na MozOut: o seu site, o sistema de facturação, uma aplicação ou um simples script. Tem guias, a referência de todas as operações, exemplos de código prontos a copiar e um Playground para experimentar pedidos no navegador. Lê-se sem conta e sem entrar em lado nenhum: abrir a documentação.

Para quem é

Quem O que lá encontra
Programador ou agência As regras da API, a referência de cada operação, os exemplos em curl, PHP, Python e JavaScript, e a especificação OpenAPI para importar nas suas ferramentas.
Dono de uma empresa A lista «O que a API já faz», na página inicial, para saber o que pode ser automatizado antes de pedir um orçamento a um programador.
Equipa técnica que já usa a API As páginas de cada área, os códigos de erro, os limites e as operações que mostram o estado da chave.
Ferramentas de IA Uma versão em Markdown de cada página e um índice em texto simples, o ficheiro llms.txt.

O que é, e o que não é

A documentação fala da API: pedidos, respostas, chaves e permissões. Para usar os serviços pelo Meu MozOut, por exemplo criar uma caixa de e-mail, pagar uma factura ou mudar os nameservers à mão, o sítio certo é esta Base de Conhecimento. As duas estão ligadas: no fim de cada página da documentação há uma caixa «Não encontrou o que procurava?» que leva à pesquisa e à Base de Conhecimento.

O que está na página inicial

1 Primeiros passos: confirmar que a API responde, criar uma chave no Meu MozOut e fazer o primeiro pedido com essa chave.
2 Comece aqui: cartões para Começar com a API, Autenticação e chaves, Permissões, Regras da API, a Referência e o Playground.
3 O que a API já faz: a lista das operações desta versão. A API está a crescer por fases, e a própria página avisa: o que não está na lista ainda não existe na API, e essas tarefas fazem-se no Meu MozOut.
4 Áreas da API: domínios, DNS, hospedagem, e-mail, servidores, SMS, Email Center, facturas e saldo, conta, catálogo, suporte, produtos extra, revenda e chave e estado.

Como lá chegar

1 Pelo site: a página da API tem o botão para abrir a documentação.
2 Directamente: esta ligação leva à página inicial; guarde-a nos favoritos.
3 Pela Base de Conhecimento: os artigos sobre a API, como este, ligam às páginas certas da documentação.

Do lado da documentação, o menu de cima leva de volta ao site, à Base de Conhecimento e ao Meu MozOut. A documentação existe em português e em inglês: veja onde está cada língua.

Ler a documentação é livre; usar a API pede uma chave. Para criar chaves precisa de uma conta na MozOut com um serviço ou um domínio activo. A chave cria-se no Meu MozOut, na página API, e nunca na documentação.
Não é programador? Leia a página inicial e a lista «O que a API já faz», e depois passe as ligações certas a quem vai programar: veja como entregar a documentação a um programador ou agência.

Quer ver o que a API já faz pela sua conta? A documentação está aberta a todos.

Abrir a documentação

VEJA TAMBÉM

Como está organizada a documentação da API: Começar, Áreas, Referência e Playground

Um percurso de leitura na documentação da API: do primeiro pedido à integração pronta

O Playground da API: experimentar um pedido real a partir do navegador, passo a passo

Entregar a documentação da API a um programador: ligações a secções, Markdown e a especificação

O que é uma API, em palavras simples: pedidos, respostas e um exemplo REST

PRODUTO RECOMENDADO

Hospedagem de sites com cPanel

Domínio e SSL incluídos, cópias diárias e o painel que já conhece. desde 396,00 MT/mês (plano de 3 anos, com cupão)

Ver planos
Esta resposta foi útil? A sua resposta ajuda-nos a melhorar este artigo.