Pular para o conteúdo principal

​
Visão geral

A API do Windsurf permite que clientes Enterprise acessem, de forma programática, Analytics detalhados de uso e gerenciem as configurações de uso de suas equipes.
A API está disponível apenas para planos Enterprise

​
URL base

Todas as requisições à API devem ser feitas para: 
https://server.codeium.com/api/v1/

​
Autenticação

A API do Windsurf usa chaves de serviço (Service Keys) para autenticação. As Service Keys devem ser incluídas no corpo da requisição de todas as chamadas de API.

​
Criando uma Chave de serviço

  1. Acesse a sua página de configurações da equipe
  2. Vá para a seção “Chaves de serviço”
  3. Crie uma nova Chave de serviço com as permissões apropriadas
  4. Copie a Chave de serviço gerada para usar em solicitações à API

​
Permissões necessárias

Diferentes endpoints de API exigem permissões diferentes. Consulte a documentação de cada endpoint para ver a permissão específica necessária:
EndpointPermissão necessária
Custom Analytics (/Analytics)Leitura de Analytics
User Page Analytics (/UserPageAnalytics)Teams somente leitura
Cascade Analytics (/CascadeAnalytics)Teams somente leitura
Set Usage Configuration (/UsageConfig)Gravação de Cobrança
Get Usage Configuration (/GetUsageConfig)Leitura de Cobrança

​
Usando Chaves de serviço

Inclua sua Service Key no corpo da requisição em todas as chamadas de API: 
{
  "service_key": "your_service_key_here",
  // ... outros parâmetros
}
Mantenha suas Service Keys seguras e nunca as exponha em código cliente ou em repositórios públicos

​
Limites de taxa

As requisições à API estão sujeitas a limites de taxa para garantir a estabilidade do serviço. Se você exceder esse limite, receberá uma resposta 429 Too Many Requests.

​
Suporte

Para obter suporte à API ou tirar dúvidas, entre em contato com o Windsurf Support.