APIs liberadas e SAP Business Accelerator Hub

Um objeto está liberado quando seu estado de liberação é Released sob um contrato de liberação específico, que define o uso permitido e as alterações que a SAP evitará:

Um objeto Deprecated ainda funciona, mas deve ser substituído pelo seu sucessor; um objeto Decommissioned não é mais suportado, estado que a SAP atualmente aplica apenas a APIs remotas. Para objetos C0 e C1, uma configuração de visibilidade decide se desenvolvedores ABAP Cloud, key users ou ambos podem usar o objeto.

Uma API liberada é, portanto, uma promessa sobre um objeto e uma finalidade, e não um rótulo genérico para qualquer coisa que tenha uma interface.

O SAP Business Accelerator Hub, antes chamado SAP API Business Hub, é uma aplicação web hospedada pela SAP. Ele cataloga APIs da SAP e de parceiros (OData, SOAP, REST), business events, CDS views, data products, integration flows e process blueprints.

Para cada API, o hub mostra a especificação, a documentação e, para muitas APIs, um sandbox para testar chamadas antes de conectar qualquer sistema. Um desenvolvedor da Alder Manufacturing que precisa criar faturas de fornecedor a partir de um portal externo começa por aqui: encontra a API, lê seu status e seu sucessor, testa no sandbox e depois baixa a especificação.

Dois limites importam. O hub documenta as APIs padrão da SAP, não as específicas de cada cliente, e as APIs são listadas por produto, então uma API listada para uma edição não está automaticamente disponível em outra. O SAP Business Accelerator Hub é o ponto de partida para o desenho de APIs remotas, e não a prova de que uma API existe em um determinado sistema.

As APIs liberadas se dividem em dois grupos práticos:

• APIs locais (contrato C1). CDS views, classes, behavior definitions e outros objetos liberados, usados por código ABAP customizado no mesmo sistema. O código ABAP Cloud só pode chamar estas. Os desenvolvedores as encontram no ABAP Development Tools, onde a aba API State mostra o estado de liberação e o contrato, e na seção de extensibilidade de desenvolvedor do Business Accelerator Hub.
• APIs remotas (contrato C2). Serviços OData, SOAP e outros chamados pela rede por apps no SAP BTP, middleware ou sistemas de terceiros. Elas são documentadas no Business Accelerator Hub.

Quando a SAP substitui uma API, a antiga passa a deprecated e um sucessor é indicado; a SAP tornou obsoleta a API OData Production Order no SAP S/4HANA Cloud 2008, por exemplo.

A distinção define a arquitetura: as APIs locais atendem extensões on-stack construídas com ABAP Cloud, enquanto as APIs remotas atendem extensões side-by-side e integrações.

• SAP S/4HANA Cloud Public Edition: as APIs liberadas são o único caminho de acesso. O código ABAP customizado usa apenas APIs locais liberadas, e as APIs remotas são expostas por meio de communication scenarios que um administrador ativa com um communication arrangement.
• Private Edition e on-premise: as APIs liberadas coexistem com interfaces clássicas como as BAPIs. As APIs OData remotas são ativadas como os demais serviços OData no SAP Gateway, por exemplo com a /IWFND/MAINT_SERVICE para OData V2. Onde não existe API liberada, a orientação da SAP permite wrappers customizados em torno de APIs clássicas listadas, liberados com o contrato C1.
• SAP BTP ABAP environment: valem os mesmos contratos de liberação, e objetos customizados usados entre software components são liberados ou conectados por meio de software component relations.

Os clientes só podem liberar seus próprios objetos com os contratos C0 e C1. O conceito de API liberada é idêntico em todas as edições; o que difere é quanto acesso não liberado cada edição ainda tolera.

• Estabilidade em upgrades por contrato. A SAP verifica os objetos entregues contra seu contrato de liberação, de modo que alterações incompatíveis em uma API liberada não são esperadas em um upgrade.
• Imposição, e não apenas recomendação. No ABAP Cloud, o compilador rejeita chamadas a objetos não liberados para desenvolvimento cloud, o que transforma a regra do clean core em uma verificação de sintaxe.
• Um único vocabulário. Os mesmos estados e contratos valem em todas as edições do SAP S/4HANA e no SAP BTP ABAP environment.
• Mudança planejada. A descontinuação com um sucessor indicado dá às equipes um caminho de migração em vez de uma interface quebrada.

As APIs liberadas são a regra de dependência em que se apoia o nível A da classificação do clean core.

• A cobertura é desigual. Nem todo business object ou campo tem uma API liberada. Uma queixa frequente nas comunidades de profissionais é encontrar a operação necessária apenas em uma BAPI clássica ou em uma tabela interna.
• Um contrato não é um desenho. Uma API liberada garante estabilidade técnica, não que sua granularidade se ajuste a um processo; várias chamadas podem ser necessárias para uma etapa de negócio.
• O comportamento ainda pode mudar. As regras de contrato da SAP permitem alterações compatíveis em APIs liberadas e não prometem compatibilidade retroativa total, então os consumidores precisam testar novamente após os upgrades.
• A descontinuação é fácil de ignorar. As APIs deprecated continuam funcionando por um tempo, então a troca pelo sucessor tende a ser adiada.

As APIs liberadas removem o risco de upgrade da interface; a adequação ao processo e o ciclo de vida de cada consumidor continuam sendo responsabilidade da equipe.

1. Supor que todo serviço OData é uma API. Um serviço OData gerado para um app SAP Fiori é um serviço de UI. Verifique o estado de liberação antes que uma integração dependa dele.
2. Desenhar apenas a partir do hub. Confirme que a API existe e está ativada no sistema e na release de destino.
3. Ignorar avisos de descontinuação. Acompanhe os sucessores de cada API em uso.
4. Encapsular tudo. Wrappers C1 customizados em torno de APIs clássicas cobrem lacunas; cada um precisa de um responsável e de uma revisão quando a SAP liberar um sucessor.

O critério de decisão prático é simples: se o objeto não tem estado de liberação para o uso pretendido, trate qualquer dependência dele como dívida técnica e registre-a.