Testar com segurança
O Zynko não tem um ambiente de testes separado: não existe um servidor de sandbox nem uma API de mentira. Bots, apps e agentes de IA usam a mesma API de produção, https://zynko.org/api/v1, com as mesmas regras e os mesmos limites. Tudo o que um teste faz acontece de verdade, então o jeito seguro é testar num canto só seu:
1. Um servidor só seu
Crie um servidor do tipo Amigos para os testes: é grátis e só entra quem você convidar. Não teste em comunidades públicas nem nos servidores de outras pessoas, e apague o servidor quando não precisar mais dele.
2. Um bot de testes
No portal dev.zynko.org, crie um bot só para testes e convide-o para o seu servidor. O token (bot_ e 64 dígitos hexadecimais) aparece uma vez só: guarde numa variável de ambiente, como ZYNKO_TOKEN, nunca no código. Se ele vazar, gere outro no portal e o antigo para de funcionar na hora. O guia está em Seu primeiro bot.
3. Apps e agentes com OAuth
Para testar um app ou agente que age por uma pessoa, registre um cliente público em POST /api/v1/oauth/register com um endereço de retorno de loopback, como http://127.0.0.1/callback (a porta pode mudar a cada execução), e autorize com a sua própria conta, pedindo só os escopos que for testar. Depois, desconecte o app em Apps conectados, nos ajustes do Zynko, ou revogue o token em POST /api/v1/oauth/revoke. O passo a passo, inclusive o registro de agentes que só conhecem o seu e-mail, está em auth.md e em OAuth para apps e agentes.
4. Servidores MCP
O servidor MCP da documentação, https://docs.zynko.org/mcp, é público e só lê. O do produto, https://zynko.org/mcp, age de verdade na conta que você conectar: aponte o assistente para o seu servidor de testes e leia o que ele vai fazer antes de aprovar cada ferramenta. Para desenvolver bots, npx -y zynko-mcp roda no seu computador com o token do bot de testes.
5. Limites
São os de produção: 1200 requisições por minuto por token e 300 por minuto por endereço sem token, além dos limites de cada ação (por exemplo, 10 mensagens a cada 10 segundos por conta). Toda resposta da API traz os cabeçalhos RateLimit-Policy e RateLimit, e um 429 traz Retry-After. Para repetir uma escrita sem duplicar, mande o cabeçalho Idempotency-Key.
Documentação
- Visão geral da API: autenticação, erros, limites e versões.
- OpenAPI 3.1 de todas as rotas, e o resumo para assistentes em /api/llms.txt.
- Bots com IA: os servidores MCP e como configurar o Claude.
In English
Zynko has no separate sandbox environment: tests run against the production API at https://zynko.org/api/v1, with the same rules and rate limits (1200 requests per minute per token, 300 per minute per address without one). To test safely, use a private server of your own (the free, invite-only Amigos kind) and a test bot created at dev.zynko.org; for OAuth, register a public client with a loopback redirect URI, authorize it with your own account and the fewest scopes, and disconnect it when you are done. The docs MCP server at https://docs.zynko.org/mcp is public and read-only; the product MCP server at https://zynko.org/mcp acts on the account you connect. Send an Idempotency-Key header to retry writes safely. See auth.md and the API docs.
Sobre · Termos · Privacidade · Suporte · Excluir conta