shalom-api
Installation
SKILL.md
Shalom API — Guía de integración para agentes de IA
Shalom API Perú expone el sistema del courier Shalom (shalom.com.pe) como API REST con respuestas JSON. Esta guía contiene todo lo necesario para integrarlo sin explorar: autenticación, endpoints esenciales, recetas paso a paso y reglas de operación.
- Base URL:
https://api.shalom-api.lat - Documentación pública completa: https://shalom-api.lat/docs (última actualización: 2026-09-01)
- Directorio de agencias con direcciones y coordenadas: https://shalom-api.lat/agencias
Autenticación
Toda petición (salvo GET /public/agencies) requiere el header x-api-key: sk_.... La key se solicita por WhatsApp al responsable del servicio y tiene una cuota mensual según el plan. Valida siempre la key antes de operar:
curl "https://api.shalom-api.lat/validate" -H "x-api-key: TU_API_KEY"
# => { "valid": true, "limit": 1000, "currentUsage": 137, "remaining": 863 }
Rate limit global: 1000 peticiones por minuto. Al superarlo la API responde 429 con { limit, currentUsage, remaining }.