Governança de APIs - Senior Business Services

A Senior está evoluindo a governança de acessos externos, consumo de APIs e uso de dados no ecossistema. Reunimos aqui algumas informações sobre a plataforma de governança Senior Business Services (SBS) e as principais perguntas e respostas para essa evolução.

Sobre a plataforma de governança Senior Business Services (SBS)

<p>O <b>SBS</b> é a camada de governança, controle e telemetria que centraliza a gestão de acessos externos, integrações e consumo de APIs nos ambientes Senior, permitindo maior visibilidade e segurança sobre as operações. Ela é destinada a clientes que já são Senior acompanharem e controlarem o consumo de produtos contratados da Senior.</p>

Fluxo Geral do SBS: Jornada do Desenvolvedor Externo

<p>Existem três perfis envolvidos no ciclo de desenvolvimento com o SBS:</p><ul><li>O <b>desenvolvedor da empresa parceira</b>, que desenvolverá a integração com as soluções da Senior.</li><li>A <b>empresa cliente da Senior</b>, que contratou o desenvolvedor parceiro</li><li>O <b>Administrador interno da Senior</b>, que aprovará os Tokens solicitados pelos clientes e parceiros</li></ul><p>Neste guia rápido mostramos como desenvolvedores parceiros podem começar a se conectar com produtos Senior. Abaixo está o fluxo geral da jornada de um desenvolvedor pelo hub e, na sequência, mostrar a jornada passo a passo.</p><p><img src='/images/governanca-de-apis/fluxo-desenvolvimento-com-shbs-pt-br.png' title='Fluxo de desenvolvimento com o Senior Business Services (SBS)' alt='Fluxo de desenvolvimento com o Senior Business Services (SBS)' /></p>

Passo a passo do desenvolvedor externo

1. Criar conta no SBS

O desenvolvedor terceiro cria sua própria conta no Senior Business Services. Depois, ele deve entrar em contato com clientes que possuem produtos Senior, para eles vincularem seus produtos a essa conta de desenvolvedor.

Tela de criação de conta de desenvolvedor - Senior Business Services (SBS)

2. Associação a um cliente e produto

O cliente seleciona o desenvolvedor e vincula ele a si mesmo e ao produto em que o desenvolvedor terceiro atuará.

Tela de vínculo com cliente - Senior Business Services (SBS)

Tela de vínculo com produto - Senior Business Services (SBS)

3. Solicitar um Token de Acesso

Após o cliente do desenvolvedor terceiro fazer o vínculo, o desenvolvedor poderá solicitar um Token e informar o ambiente em que ele será utilizado (Produção ou Homologação).

Tela de criação de Token - Senior Business Services (SBS)

Tela de criação de Token - Senior Business Services (SBS)

4. Aguardar aprovação do Token

Após solicitar o Token, a solicitação entra em uma esteira de aprovação por um usuário administrador interno da Senior. O desenvolvedor deverá aguardar a aprovação do Administrador para a geração do Token. A solicitação de Token é aprovada pela Senior após processos de validação, tais como verificações contratuais.

Tela de aprovação de Tokens - Senior Business Services (SBS)

5. Visualizar o Token gerado

Após a aprovação do usuário administrador, o desenvolvedor poderá visualizar o Token para ser utilizado nas integrações. O Token aparecerá na tela "Meus Tokens" com o status Ativo e a opção Ver Valor ficará disponível para a consulta do valor do Token.

Tela de visualização de Tokens - Senior Business Services (SBS)

Dessa forma, o Token poderá ser utilizado durante o consumo das integrações disponibilizadas pelos produtos Senior.

Importante

O Token SBS não substitui os mecanismos de autenticação próprios de cada produto. Além do Token SBS, algumas integrações podem exigir credenciais adicionais, permissões específicas ou autenticação complementar conforme definido pela documentação do produto.

O valor obtido na opção Ver Valor deverá ser informado no cabeçalho da requisição conforme a implementação de cada produto.

Atualmente, os seguintes produtos oferecem suporte ao Token SBS. Os exemplos apresentados têm como objetivo demonstrar sua utilização durante o consumo das integrações, sendo as particularidades de cada produto descritas em suas respectivas documentações.

  • Produtos:
    • ERP XT (Gestão Empresarial)
    • HCM XT (Gestão de Pessoas)
    • GRS XT (Gestão de Riscos e Segurança)
Exemplo de uso:

          curl -X POST \
            "http://example.com/g5-seniorservices/rubi_Synccom_senior_g5_rh_fp_consultarColaborador" \
            -H "Content-Type: text/xml; charset=UTF-8" \
            -H "Partner-ID: SEU_TOKEN" \
            --data '
          <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
            <soapenv:Body>
              <ser:ConsultarColaborador>
                <user>usuario</user>
                <password>senha</password>
                <encryption>0</encryption>
                <parameters>
                  <numCad>1</numCad>
                  <numEmp>1</numEmp>
                  <tipCol>1</tipCol>
                </parameters>
              </ser:ConsultarColaborador>
            </soapenv:Body>
          </soapenv:Envelope>'
          

  • Produto: ERP Mega
Exemplo de uso:

          curl -X POST \
          --url 'https://SEU_HOST_MEGA/api/Auth/SignIn' \
          --header 'Content-Type: application/json' \
          --header 'Accept: application/json' \
          --header 'grantType: Api' \
          --header 'developerToken: SEU_TOKEN' \
          --data '{
            "userName": "MegaUser",
            "password": "MegaPassword"
          }'
          

  • Produto: UAU XT
Exemplo de uso:

          curl --request POST \
            --url 'http://localhost:3507/api/v1.0/Autenticador/AutenticarUsuario' \
            --header 'Content-Type: application/json' \
            --header 'X-INTEGRATION-Authorization: SEU_TOKEN' \
            --data '{
              "login": "usuario",
              "senha": "senha"
            }'
          
Observação

Os exemplos apresentados nesta página utilizam URLs, credenciais e dados fictícios, tendo como único objetivo demonstrar a forma de envio do Token SBS nas requisições.

Os exemplos desta página não substituem a documentação técnica dos produtos. Para informações sobre endpoints disponíveis, payloads, autenticação, requisitos de acesso, regras de negócio e limitações de cada integração, consulte a documentação oficial do respectivo produto.

Saiba mais sobre os produtos:

Para obter informações adicionais sobre os produtos apresentados nos exemplos desta página, consulte a documentação oficial:

Perguntas frequentes

Por que a Senior está evoluindo a governança de acessos externos e APIs?

A Senior acompanha a evolução do mercado, no qual integrações, automações e soluções baseadas em dados, incluindo agentes de IA, passaram a ter papel estratégico nas operações dos clientes.

Com o crescimento do volume e da complexidade dessas integrações, tornou-se essencial fortalecer a governança para garantir segurança, rastreabilidade, controle e equilíbrio de custos.

O que muda, na prática, na governança de acessos externos?

A evolução contempla:

  • Identificação mais precisa de quem consome dados e APIs;
  • Classificação das integrações por tipo, origem e finalidade;
  • Monitoramento de volume, frequência e padrão de uso;
  • Reforço nos controles de segurança, auditoria e bloqueio de acessos.

Essas mudanças ampliam a transparência e permitem uma gestão mais equilibrada e previsível do consumo de recursos digitais.

Como a Senior identifica e classifica o consumo de APIs?

O consumo passa a ser observado com base em critérios como:

  • Origem do acesso (cliente, parceiro, solução externa, agente automatizado);
  • Tipo de integração (nativa, customizada, terceiro);
  • Volume de requisições e dados trafegados;
  • Padrões de uso ao longo do tempo.

Esse modelo permite diferenciar usos internos, estratégicos e externos, criando uma base sólida para governança, planejamento e evolução do ecossistema.

Quais integrações e soluções são impactadas por essa evolução?

A governança se aplica principalmente a integrações externas aos sistemas Senior, incluindo:

  • Soluções de terceiros conectadas via APIs;
  • Integrações customizadas desenvolvidas por clientes ou parceiros;
  • Plataformas externas que consomem dados Senior;
  • Agentes automatizados e agentes de IA.

Integrações internas entre produtos Senior seguem tratadas dentro de políticas próprias e não são impactadas por esse movimento.

Como funciona o uso de dados por agentes externos e agentes de IA?

Agentes externos e agentes de IA são tratados como consumidores específicos de APIs e dados.

A governança permite:

  • Identificar esses agentes de forma clara;
  • Monitorar padrões de consumo;
  • Aplicar políticas adequadas de segurança, controle e rastreabilidade.

Essa abordagem garante que a adoção de automações e IA ocorra de forma responsável, segura e sustentável para todo o ecossistema.

Isso significa que haverá cobrança pelo uso de APIs e dados?

A Senior está estruturando um modelo mais maduro de governança e uso de APIs, alinhado às melhores práticas de mercado. Esse modelo cria as bases para novos formatos de consumo, nos quais o uso de recursos digitais passa a ser claramente identificado, governado e associado ao valor gerado.

Detalhes sobre modelos, cenários e condições serão comunicados de forma gradual e transparente nos próximos materiais oficiais.

O que muda para clientes, parceiros e desenvolvedores?

Os principais impactos positivos são:

  • Mais clareza sobre quem acessa dados e como;
  • Maior previsibilidade sobre o uso de integrações;
  • Melhor controle sobre custos operacionais relacionados a APIs;
  • Base mais sólida para inovação, automação e novos modelos de negócio.

Clientes e parceiros passam a operar em um ecossistema mais transparente, seguro e sustentável.

Como acompanhar o consumo de dados e APIs?

A Senior está evoluindo mecanismos de telemetria, relatórios e monitoramento, permitindo:

  • Visualizar padrões de uso;
  • Identificar integrações ativas;
  • Apoiar decisões técnicas, operacionais e estratégicas.

Essas informações ajudam clientes e parceiros a gerir melhor suas integrações e planejar sua evolução tecnológica por meio do módulo SBS (Senior Business Services).

O que acontece se uma integração não estiver identificada?

A evolução da governança reforça a importância da identificação adequada de integrações externas. Integrações não identificadas ou fora das diretrizes poderão ser:

  • Alertadas;
  • Orientadas para regularização;
  • Tratadas conforme as políticas de segurança e governança vigentes, incluindo bloqueios.

Esse cuidado protege os dados dos clientes e a estabilidade das plataformas.

Como clientes e parceiros podem se preparar para os próximos passos?

Recomenda-se:

  • Mapear integrações externas atualmente em uso;
  • Avaliar o papel de soluções de terceiros e agentes automatizados;
  • Acompanhar os próximos comunicados e materiais oficiais da Senior.

A Senior seguirá apoiando clientes e parceiros com orientações claras, diálogo contínuo e comunicação transparente durante essa evolução.

É necessário realizar alguma configuração para continuar utilizando as APIs atuais?

Nesse primeiro momento não há necessidade de nenhuma alteração. Com a futura evolução dos controles e acessos, comunicaremos os ajustes que se farão necessários.

Haverá alterações nas integrações que já estão em funcionamento?

Não haverá mudanças na lógica de negócio das integrações. O que evolui é a camada de controle, identificação e monitoramento, trazendo mais transparência e previsibilidade para clientes e parceiros.

Existe limite de utilização ou volume máximo de requisições?

Não existe um limite fixo para utilização ou volume máximo de requisições. Existem pacotes de requisições a serem contratados conforme avaliação de custos operacionais.

Haverá impacto na segurança dos dados?

Sim, positivamente. O modelo reforça os princípios de confidencialidade, integridade e disponibilidade, alinhados às políticas de segurança da Senior e normas reconhecidas de mercado.

Onde posso encontrar mais informações?

A Senior possui materiais técnicos, políticas e documentação que orientam esse modelo de governança, disponíveis por meio dos canais oficiais dos produtos Senior e do Portal de Desenvolvedores, conforme aplicável.

Assistente IA
Precisa de ajuda? Fale com nosso assistente de IA.
Saiba mais sobre nossas soluções, entre em contato.