---
title: "Autenticação da API: documentação do Spark! | Chargezen"
description: "Autentique-se na API do Spark!. Da seção Referência da API da documentação do Spark! da Chargezen."
url: "https://chargezen.com/pt-br/docs/spark/api/authentication"
lang: "pt-BR"
updated: "2026-01-19"
---

Canonical URL: https://chargezen.com/pt-br/docs/spark/api/authentication

# Autenticação da API

Autentique-se na API do Spark!

Última atualização: 2026-01-19

A API do Spark! usa chaves de API para autenticação. Inclua sua chave no cabeçalho Authorization de cada solicitação.

## Como obter sua chave de API

1.  Acesse Settings → API → API Keys
2.  Clique em "Create API Key"
3.  Dê um nome à chave (por exemplo, "Produção" ou "Homologação")
4.  Defina as permissões (somente leitura ou leitura e gravação)
5.  Copie e armazene a chave com segurança

Mantenha as chaves em segredo

As chaves de API dão acesso completo aos seus dados do Spark!. Nunca as exponha em código do lado do cliente, repositórios públicos ou logs.

## Como usar sua chave de API

Inclua a chave de API no cabeçalho Authorization:

`Authorization: Bearer YOUR_API_KEY`

## Limites de requisições

As requisições à API têm limites:

*   **Padrão** — 100 requisições por minuto
*   **Operações em massa** — 10 requisições por minuto
*   **Webhooks** — Sem limite (saída)

Cada resposta inclui cabeçalhos de limite de requisições:

*   `X-RateLimit-Limit` — Máximo de requisições permitido
*   `X-RateLimit-Remaining` — Requisições restantes
*   `X-RateLimit-Reset` — Timestamp Unix de quando o limite é reiniciado

## Tratamento de erros

Os erros da API retornam códigos de status HTTP padrão:

*   **400** — Solicitação inválida (parâmetros inválidos)
*   **401** — Não autorizado (chave de API inválida ou ausente)
*   **403** — Proibido (permissões insuficientes)
*   **404** — Não encontrado
*   **429** — Excesso de requisições (limite atingido)
*   **500** — Erro do servidor

## Ambientes

*   **Produção** — `https://api.chargezen.com/spark/v1`
*   **Sandbox** — `https://sandbox.chargezen.com/spark/v1`

Testes no sandbox

Use o ambiente sandbox para testes. Ele espelha a produção, mas não afeta dados reais nem aciona pagamentos reais.

## Próximos passos

[

### Endpoints REST

Referência completa dos endpoints

Saiba mais



](https://chargezen.com/pt-br/docs/spark/api/endpoints)[

### Webhooks

Notificações de eventos

Saiba mais



](https://chargezen.com/pt-br/docs/spark/api/webhooks)

### Artigos relacionados

[

#### Endpoints REST

Referência dos endpoints da API



](https://chargezen.com/pt-br/docs/spark/api/endpoints)[

#### Webhooks

Notificações de eventos



](https://chargezen.com/pt-br/docs/spark/api/webhooks)

Esta página foi útil?

Precisa de mais ajuda? [Fale com o suporte](https://chargezen.com/pt-br/docs/checkoutos/troubleshooting/support)