Saltar a contenido

Entornos

La API Pontotel está disponible en dos ambientes: Producción y Sandbox.

Producción

Ambiente oficial donde los datos son reales y las operaciones tienen efecto inmediato.

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

Atención

Operaciones en producción afectan datos reales de empleados y empresas. Siempre valide su integración en Sandbox antes de ir a la producción.

Características

  • Datos reales de clientes
  • Rate limit: 500 solicitudes/hora, burst 50/min
  • SLA de disponibilidad: 99.9%
  • Monitoreo 24/7

Sandbox

Ambiente aislado para desarrollo y pruebas. Los datos son ficticios y no afectan producción.

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

Usá Sandbox

Sandbox es el lugar correcto para:

  • Prototipar su integración
  • Testar flujos de error
  • Validar comportamientos antes de la producción
  • Treinar equipos de desarrollo

Características

  • Datos de prueba aislados
  • Rate limit: 1000 solicitudes/hora, burst 100/min
  • Reseta periódicamente
  • Latencia puede ser ligeramente mayor

Comparativo

Característica Producción Sandbox
Base URL apis.pontotel.com.br sandbox-apis.pontotel.com.br
Datos Reais Ficticios
Rate Limit 500 req/hora 1000 req/hora
Disponibilidad 99.9% SLA Best Effort
Credenciales Separadas Separadas

Credenciales Separadas

Las credenciales de Sandbox son diferentes de producción. Solicita credenciales para cada entorno por separado al soporte.

Configuración recomendada

Variables de entorno

Utilice variables de entorno para cambiar entre entornos:

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=tu_usuario_sandbox
PONTOTEL_PASSWORD=tu_contrasena_sandbox

# .env.production
PONTOTEL_BASE_URL=https://apis.pontotel.com.br/pontotel/api/v4/
PONTOTEL_USERNAME=tu_usuario_produccion
PONTOTEL_PASSWORD=tu_contrasena_produccion
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")

Siguientes pasos