Pular para conteúdo

Ambientes

A API Pontotel está disponível em dois ambientes: Produção e Sandbox.

Produção

Ambiente oficial onde os dados são reais e as operações têm efeito imediato.

Text Only
1
https://apis.pontotel.com.br/pontotel/api/v4/

Atenção

Operações em produção afetam dados reais de empregados e empresas. Sempre valide sua integração no Sandbox antes de ir para produção.

Características

  • Dados reais de clientes
  • Rate limit: 500 requisições/hora, burst 50/min
  • SLA de disponibilidade: 99.9%
  • Monitoramento 24/7

Sandbox

Ambiente isolado para desenvolvimento e testes. Os dados são fictícios e não afetam produção.

Text Only
1
https://sandbox-apis.pontotel.com.br/pontotel/api/v4/

Use o Sandbox

O Sandbox é o lugar certo para:

  • Prototipar sua integração
  • Testar fluxos de erro
  • Validar comportamentos antes de produção
  • Treinar equipes de desenvolvimento

Características

  • Dados de teste isolados
  • Rate limit: 1000 requisições/hora, burst 100/min
  • Reseta periodicamente
  • Latência pode ser ligeiramente maior

Comparativo

Característica Produção Sandbox
Base URL apis.pontotel.com.br sandbox-apis.pontotel.com.br
Dados Reais Fictícios
Rate Limit 500 req/hora 1000 req/hora
Disponibilidade 99.9% SLA Best effort
Credenciais Separadas Separadas

Credenciais Separadas

As credenciais do Sandbox são diferentes das de Produção. Solicite credenciais para cada ambiente separadamente ao suporte.

Configuração Recomendada

Variáveis de Ambiente

Use variáveis de ambiente para alternar entre ambientes:

Python
1
2
3
4
5
6
7
8
9
# .env.sandbox
PONTOTEL_BASE_URL=https://sandbox-apis.pontotel.com.br/pontotel/api/v4/
PONTOTEL_USERNAME=seu_usuario_sandbox
PONTOTEL_PASSWORD=sua_senha_sandbox

# .env.production
PONTOTEL_BASE_URL=https://apis.pontotel.com.br/pontotel/api/v4/
PONTOTEL_USERNAME=seu_usuario_producao
PONTOTEL_PASSWORD=sua_senha_producao
Python
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
import os
from dotenv import load_dotenv

# Carregar env de acordo com o ambiente
env = os.getenv("APP_ENV", "sandbox")
load_dotenv(f".env.{env}")

BASE_URL = os.getenv("PONTOTEL_BASE_URL")
USERNAME = os.getenv("PONTOTEL_USERNAME")
PASSWORD = os.getenv("PONTOTEL_PASSWORD")

Próximos Passos