Toda API no Zyla API Hub passa pelas mesmas regras de qualidade, seja como foi publicada: o assistente web, uma importação ou a Listings API usada por agentes de IA. Elas existem para que os clientes possam confiar no que compram e para que as boas APIs sejam fáceis de encontrar. Listings que não atendem a elas não são publicados, e o erro diz o que mudar.
Escreva em inglês, nós traduzimos
Escreva seu listing em inglês: nome, descrições, endpoints e FAQs. O Zyla API Hub o traduz automaticamente para os outros idiomas do hub (espanhol, português, hindi e chinês), para que sua API alcance clientes em todos eles. Quando você edita o texto em inglês, as traduções também são atualizadas.
Nome
- Um nome claro, em inglês, que diga o que a API faz e inclua a palavra "API", por exemplo "Weather Forecast API".
- Único no hub, e com até 50 caracteres.
- Precisa parecer um produto finalizado. Nomes que sugiram um teste, uma demonstração, uma cópia, um placeholder ou uma duplicata de outra API não são aceitos.
- Escreva marcas e plataformas por extenso (Instagram, não IG) e não use os nomes de outros marketplaces de API.
Descrições
- Em inglês, explicando o que a API faz e o que ela retorna. A descrição curta precisa de no mínimo 50 caracteres.
- Consistente com o nome e os endpoints.
- Informativa, não promocional: sem publicidade, preços, descontos ou afirmações que você não possa comprovar.
Mantenha tudo no hub
O Zyla API Hub é o intermediário entre você e seus clientes: descoberta, cobrança, chaves, limites e suporte, tudo acontece no hub. É assim que garantimos qualidade para os dois lados.
- Não inclua endereços de e-mail, sites, telefones, perfis de redes sociais ou qualquer outro dado de contato em nenhuma parte do listing: nome, descrições, endpoints, FAQs ou respostas de exemplo.
- Não convide os clientes a entrar em contato com você ou comprar fora do hub.
- As perguntas dos clientes chegam até você através da Zyla.
Endpoints
- Um nome claro e uma descrição do que o endpoint faz.
- Um método e uma base URL válidos, e cada parâmetro com seu tipo e uma descrição curta.
- Uma resposta de exemplo real, para que os clientes vejam o que vão receber antes de comprar.
Planos
- Ao menos três planos mensais pagos, em que um plano mais caro sempre inclua mais chamadas.
- Limites de taxa por minuto entre 60 e 240 requisições.
Quantas novas APIs você pode criar
Para manter o catálogo útil e evitar enxurradas de listings de baixa qualidade, toda conta tem uma cota de novas APIs. A cota cresce com seu histórico.
| Conta | Novas APIs | APIs vinculadas (variantes de uma das suas APIs) |
|---|---|---|
| Ainda sem vendas pagas | 5 por 24 horas e 20 por 7 dias | 20 por 24 horas |
| Ao menos uma assinatura paga | 20 por 24 horas | 60 por 24 horas |
- As janelas são contínuas, e APIs excluídas continuam contando. Editar suas APIs existentes nunca conta.
- Acima da cota, novas APIs são rejeitadas com uma mensagem que diz quando você poderá criar mais (a Listings API responde
429). Sua conta e suas APIs existentes não são afetadas.
Precisa de um limite maior para um catálogo grande e legítimo? Escreva para nossa equipe.
Revisão
Verificações automáticas são executadas quando você salva, e a equipe da Zyla revisa as APIs do hub. Uma API que não segue estas regras ou os Termos e Condições, mesmo que já tenha sido publicada, pode ser rejeitada, ocultada ou removida.
