Desenvolvedores
A API existe. A referência pública ainda não.
Tudo nesta plataforma (a loja, o carrinho, o painel) já se comunica com uma única API. O que ainda não fizemos foi publicá-la: hoje não há tokens para clientes nem documentação de referência, e preferimos dizer isso a vender uma captura de tela.
Hoje
O que é de fato verdade agora.
A loja e o painel já funcionam sobre a nossa própria API interna. Publicá-la exige documentação, emissão de tokens e compromissos de estabilidade que possamos cumprir, e nada disso existe ainda.
O que ainda não existe: chaves de API que você mesmo pode criar, uma referência publicada com esquemas e os compromissos de estabilidade que fazem uma API valer o investimento. Até podermos colocar por escrito políticas de versionamento e descontinuação, não vamos distribuir tokens: uma API que muda sem aviso é pior do que nenhuma API.
Se o seu fluxo de trabalho precisa de provisionamento programático hoje, conte-nos o que você está construindo pelo formulário de solicitação. O interesse realmente define a ordem em que desenvolvemos, e o acesso antecipado começará pelas pessoas que pediram.
Escopo planejado
O que a API pública vai cobrir.
Estes são os recursos que a API interna já tem e que a pública vai expor. Planejado significa planejado: nada disso pode ser chamado por clientes hoje.
- Ciclo de vida do servidor
- Crie, reconstrua, reinicie e destrua servidores a partir do seu próprio código: as operações que o painel realiza hoje.
- Catálogo em tempo real
- Planos, regiões e imagens como dados, com os mesmos preços que a loja mostra, incluindo seu desconto de parceiro quando aplicável.
- Domínios e DNS
- Pesquise, registre e gerencie registros pela mesma integração com o registrador que o site usa.
- Uso e cobrança
- Medição hora a hora que você pode ler programaticamente: os números de que precisaria para refaturar seus próprios clientes.
- Webhooks, não polling
- Eventos do ciclo de vida enviados ao seu endpoint e assinados, para que seus sistemas reajam em vez de perguntar.
- Tokens com escopo
- Chaves somente leitura, somente provisionamento ou de acesso total, revogáveis instantaneamente, com logs de auditoria por token.
Princípios que estamos seguindo: REST simples com códigos de status significativos, chaves de idempotência nas chamadas que alteram dados, cloud-init user_data na criação, limites de taxa informados nos cabeçalhos de resposta e erros que dizem o que fazer a seguir. Sem surpresas, de propósito.
Registrar interesse
Conte-nos o que você construiria com ela.
Uma frase sobre o seu caso de uso é suficiente. Você terá notícias nossas quando houver algo real para testar, e não uma sequência de e-mails de marketing.