Referencia da API

Bem-vindo a API do GetRaze. Use nossa API REST para integrar as funcionalidades do GetRaze nas suas aplicacoes.

URL Base

https://app.getraze.com/external/v1

Autenticacao

Todas as requisicoes a API exigem autenticacao usando uma chave de API. Inclua sua chave no header da requisicao:

X-API-Key: sua_chave_api_aqui

Ou usando o formato Bearer token:

Authorization: Bearer sua_chave_api_aqui

Inicio Rapido

1. Obtenha sua Chave de API

Navegue ate Configuracoes > Chaves de API no painel do GetRaze para criar uma nova chave de API.

2. Faca sua primeira requisicao

curl --request GET \
  --url "https://app.getraze.com/external/v1/contacts" \
  --header "X-API-Key: YOUR_API_KEY"

3. Resposta

{
  "success": true,
  "data": [...],
  "pagination": {
    "page": 1,
    "per_page": 50,
    "total": 150,
    "total_pages": 3,
    "has_next": true,
    "has_prev": false
  }
}

Endpoints Disponiveis

Contatos

Metodo	Endpoint	Descricao
GET	/contacts	Listar todos os contatos
GET	/contacts/:id	Buscar um contato
POST	/contacts	Criar um contato
PUT	/contacts/:id	Atualizar um contato
DELETE	/contacts/:id	Excluir um contato

Oportunidades

Metodo	Endpoint	Descricao
GET	/opportunities	Listar todas as oportunidades
GET	/opportunities/:id	Buscar uma oportunidade
POST	/opportunities	Criar uma oportunidade
PUT	/opportunities/:id	Atualizar uma oportunidade
PATCH	/opportunities/:id/stage	Atualizar estagio da oportunidade
DELETE	/opportunities/:id	Excluir uma oportunidade

Campanhas

Metodo	Endpoint	Descricao
GET	/campaigns	Listar todas as campanhas
POST	/campaigns/:id/contacts	Adicionar um contato a uma campanha

Agentes de Instagram

Metodo	Endpoint	Descricao
GET	/instagram-agents	Listar todos os agentes de Instagram
POST	/instagram-agents/:id/profiles	Adicionar um perfil a um agente

Limites de Requisicao

Cada chave de API possui limites de requisicao configuraveis. O padrao e 1000 requisicoes por hora.

As informacoes de limite sao incluidas nos headers da resposta:

• X-RateLimit-Limit: Maximo de requisicoes por hora
• X-RateLimit-Remaining: Requisicoes restantes
• X-RateLimit-Reset: Timestamp Unix de quando o limite reinicia

Permissoes

As chaves de API utilizam permissoes granulares:

Permissao	Descricao
contacts:read	Ler dados de contatos
contacts:write	Criar e atualizar contatos
contacts:delete	Excluir contatos
opportunities:read	Ler dados de oportunidades
opportunities:write	Criar e atualizar oportunidades
opportunities:delete	Excluir oportunidades
campaigns:read	Ler dados de campanhas
campaigns:write	Adicionar contatos a campanhas
instagram_agents:read	Ler dados de agentes de Instagram
instagram_agents:write	Adicionar perfis a agentes

Permissoes com wildcard sao suportadas (ex.: contacts:* concede todas as permissoes de contatos).