Skip to content

Environments

The Pontotel API is available in two environments: Production and Sandbox.

Production

Official environment where the data is real and operations have immediate effect.

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

Warning

Operations in production affect real data of employees and companies. Always validate your integration into the Sandbox before going to production.

Characteristics

  • Real customer data
  • Rate limit: 500 requests/hour, burst 50/min
  • Availability SLA: 99.9%
  • Monitoring 24/7

Sandbox

Isolated environment for development and testing. The data are fictitious and do not affect production.

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

Use Sandbox

Sandbox is the right place for:

  • Prototyping your integration
  • Test error streams
  • Validate behaviour before production
  • Training development teams

Characteristics

  • Isolated test data
  • Rate limit: 1000 requests/hour, burst 100/min
  • Resumes periodically
  • Latency may be slightly higher

Comparative

Feature Production Sandbox
Base URL apis.pontotel.com.br sandbox-apis.pontotel.com.br
Data Real Fictitious
Rate Limit 500 req/hour 1000 req/hour
Availability 99.9% SLA Best effort
Accreditations Separated Separated

Separate credentials

Sandbox credentials are different Production. Request credentials for each environment separately to support.

Environment Variables

Use environment variables to switch between environments:

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=your_sandbox_username
PONTOTEL_PASSWORD=your_sandbox_password

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

Next Steps