API e recursos para desenvolvedores da HIT Communications

• Descobrir o que a HIT Communications oferece — telefonia para Microsoft Teams, PABX e contact center em nuvem, atendimento omnichannel por WhatsApp, conectividade multioperadora e SD-WAN, cibersegurança, serviços de TI gerenciados e tráfego de voz — e em quais países (Brasil, Colômbia, México, Panamá, Espanha, Portugal, Estados Unidos).
• Ler ou resumir os artigos do blog da HIT Communications sobre conectividade, segurança, telefonia e tecnologia, em português, inglês ou espanhol.
• Preparar uma solicitação comercial para uma pessoa que quer uma demonstração ou proposta, validá-la com o sandbox dry-run e entregá-la para que ela envie pela página de contato ou pelo WhatsApp.
• Não use para obter preços: a HIT Communications não publica preços; as propostas são feitas após uma conversa com o time comercial.

O contrato é versionado em /api/v1. Liste os artigos de segurança mais recentes:

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

Toda página do site também está disponível em Markdown quando solicitada:

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

Todos os endpoints de escrita aceitam dry_run=true. A requisição é validada exatamente como um envio real e nada é gravado, enviado por e-mail ou repassado ao comercial:

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."}'

Envios reais do formulário de contato exigem o token CAPTCHA emitido pelo formulário do site, então o último passo é sempre dado por uma pessoa na página de contato.

• 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

• Versionamento no caminho: /api/v1/… é o contrato atual; toda resposta traz API-Version: 1.
• Mudanças incompatíveis saem em um novo caminho (/api/v2/…). Mudanças compatíveis (novos campos ou endpoints opcionais) podem acontecer dentro da v1.
• Uma versão descontinuada continua funcionando por pelo menos 180 dias após o anúncio. Operações descontinuadas respondem com os cabeçalhos Deprecation (RFC 9745), Sunset (RFC 8594) e Link rel="deprecation" e são marcadas como deprecated no documento OpenAPI.

Por IP de cliente: 120 requisições de leitura e 60 de escrita a cada 60 segundos. As respostas trazem os cabeçalhos IETF RateLimit-Policy e RateLimit; uma resposta 429 acrescenta Retry-After.

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

Todo erro da API é um objeto JSON com um código estável, uma mensagem, o status HTTP, uma dica de como resolver e um link para o 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"
}

Os endpoints públicos não exigem autenticação. Os endpoints administrativos em /api/v1/admin exigem uma sessão do Supabase Auth e uma permissão por módulo; os scopes (admin:blog, admin:cms, admin:users e outros) estão declarados nos esquemas de segurança do OpenAPI e nos metadados RFC 9728.

Para demonstrações, propostas e integrações, use a página de contato: https://www.hitcommunications.com/pt-br/contact