API e Desenvolvedores
Créditos e Limites de Taxa
A API do PDFSimple usa um sistema de faturamento baseado em créditos. Entenda como os créditos são consumidos, o que acontece quando eles se esgotam, e os limites de taxa da API.
O faturamento da API é separado das cotas de tarefas do plano web. Ao assinar um plano de API, você recebe uma quantidade mensal de créditos que é reiniciada na sua data de renovação.
Como funcionam os créditos
- Cada requisição à API consome uma determinada quantidade de créditos, dependendo da operação e do número de páginas processadas.
- Os créditos são reiniciados para a quantidade mensal do seu plano em cada data de renovação.
- Os créditos não utilizados não são transferidos para o próximo mês.
O que acontece quando os créditos se esgotam
Se sua conta não tiver créditos restantes, a API retorna HTTP 402 Payment Required. Suas requisições serão retomadas assim que os créditos forem reiniciados na próxima renovação, ou imediatamente se você fizer upgrade do seu plano de API.
HTTP/1.1 402 Payment Required
{
"code": 402,
"message": "Insufficient credits. Please upgrade your plan."
}Limites de taxa
Para garantir um uso justo, a API aplica limites de taxa por chave de API. Se você exceder o limite de taxa, a API retorna HTTP 429 Too Many Requests. A resposta inclui um cabeçalho Retry-After indicando quando você pode retomar.
Para casos de uso de alto volume, entre em contato com o suporte para discutir limites personalizados.
Isso foi útil?