# Autenticação

A API pública autentica com uma chave no formato `pf_live_…`. A chave herda o workspace e as permissões de quem a emitiu. O `workspaceId` nunca vai no corpo da requisição.

1. No PipeFácil, vá até **Configurações** > **Chaves de API**.

2. Crie uma chave. Copie o valor. Ele aparece só nessa tela.

![Área de Chaves de API sem tokens emitidos no workspace](/images/pipefacil/developers/chaves-api-light.png)

![Diálogo Nova chave de API com nome e prazo de expiração](/images/pipefacil/developers/chaves-api-nova-light.png)

3. Envie a chave no cabeçalho `Authorization: Bearer pf_live_…`.

O limite por volume é de 600 pedidos por minuto, por workspace e por IP. A API também limita a concorrência por workspace: 10 requisições são processadas ao mesmo tempo e até 40 aguardam por no máximo 5 segundos. Se não houver vaga, a API responde `429` com `Retry-After: 1`. Distribua as chamadas em lote em vez de enviá-las todas ao mesmo tempo.

O contrato completo está na [referência da API pública](/api/).