API y recursos para desarrolladores de HIT Communications

• Conocer qué ofrece HIT Communications — telefonía para Microsoft Teams, PBX y contact center en la nube, atención omnicanal por WhatsApp, conectividad multioperador y SD-WAN, ciberseguridad, servicios de TI gestionados y tráfico de voz — y en qué países (Brasil, Colombia, México, Panamá, España, Portugal, Estados Unidos).
• Leer o resumir los artículos del blog de HIT Communications sobre conectividad, seguridad, telefonía y tecnología, en español, inglés o portugués.
• Preparar una solicitud comercial para una persona que quiere una demostración o propuesta, validarla con el sandbox dry-run y entregársela para que la envíe desde la página de contacto o por WhatsApp.
• No la use para obtener precios: HIT Communications no publica precios; las propuestas se elaboran después de una llamada con el equipo comercial.

El contrato está versionado bajo /api/v1. Liste los artículos de seguridad más recientes:

curl -sS "https://www.hitcommunications.com/api/v1/blog/posts?locale=en-us&category=Security"

Cada página del sitio también está disponible en Markdown si la solicita:

curl -sS -H "Accept: text/markdown" https://www.hitcommunications.com/en-us/solutions/cybersecurity

Todos los endpoints de escritura aceptan dry_run=true. La solicitud se valida exactamente como un envío real y no se guarda, envía por correo ni reenvía a ventas:

curl -sS -X POST "https://www.hitcommunications.com/api/v1/contact?dry_run=true" \
  -H "Content-Type: application/json" \
  -d '{"name":"Ana Souza","email":"ana@example.com","country":"Brazil","message":"We need Microsoft Teams telephony for 300 users."}'

Los envíos reales del formulario de contacto requieren el token CAPTCHA del formulario del sitio, por lo que el último paso siempre lo da una persona en la página de contacto.

• OpenAPI 3.1: https://www.hitcommunications.com/openapi.json
• llms.txt: https://www.hitcommunications.com/llms.txt
• OAuth protected resource metadata (RFC 9728): https://www.hitcommunications.com/.well-known/oauth-protected-resource/api/admin
• Sitemap: https://www.hitcommunications.com/sitemap.xml

• Versionado en la ruta: /api/v1/… es el contrato vigente; cada respuesta incluye API-Version: 1.
• Los cambios incompatibles se publican en una nueva ruta (/api/v2/…). Los cambios compatibles (campos o endpoints opcionales nuevos) pueden ocurrir dentro de v1.
• Una versión obsoleta sigue funcionando al menos 180 días después del anuncio. Las operaciones obsoletas responden con los encabezados Deprecation (RFC 9745), Sunset (RFC 8594) y Link rel="deprecation" y se marcan como deprecated en el documento OpenAPI.

Por IP de cliente: 120 solicitudes de lectura y 60 de escritura cada 60 segundos. Las respuestas incluyen los encabezados IETF RateLimit-Policy y RateLimit; una respuesta 429 añade Retry-After.

API-Version: 1
RateLimit-Policy: "read";q=120;w=60
RateLimit: "read";r=119;t=60

Cada error de la API es un objeto JSON con un código estable, un mensaje, el estado HTTP, una pista para resolverlo y un enlace al documento OpenAPI:

{
  "error": "Invalid blog listing parameters.",
  "code": "validation_failed",
  "message": "Invalid blog listing parameters.",
  "status": 400,
  "hint": "locale must be a site locale (en-us, es-co, …)",
  "docs": "https://www.hitcommunications.com/openapi.json"
}

Los endpoints públicos no requieren autenticación. Los endpoints administrativos bajo /api/v1/admin requieren una sesión de Supabase Auth y un permiso por módulo; los scopes (admin:blog, admin:cms, admin:users y otros) se declaran en los esquemas de seguridad de OpenAPI y en los metadatos RFC 9728.

Para demostraciones, propuestas e integraciones, use la página de contacto: https://www.hitcommunications.com/es-co/contact