Introdução ao Projeto CAMARA

Atualização importante: Mudamos a forma como nossas APIs utilizam o padrão CAMARA. Quer saber quais são as novidades? Confira nosso artigo mais recente “Como a Vonage usa as APIs CAMARA para melhorar a experiência do desenvolvedor"

Em nosso artigo anterior Anunciando as APIs de rede da Vonage, apresentamos a ideia de que as novas APIs foram desenvolvidas seguindo o padrão CAMARA. Neste artigo, vamos nos aprofundar no projeto CAMARA para entender suas implicações e o que isso significa para o setor de telecomunicações.

O que é a CAMARA?

Imagine o seguinte: os gigantes das telecomunicações e da tecnologia, reunindo-se como os Vingadores, para estabelecer um novo padrão com o objetivo de harmonizar e revelar novos recursos de rede, a fim de criar uma experiência de usuário perfeita. Não precisa dizer mais nada. Seja bem-vindo à CAMARA!

O CAMARA é um projeto de código aberto da Linux Foundation que hospeda os padrões de API e desenvolve e testa as APIs. O projeto colabora estreitamente com o GSMA Operator Platform Group para alinhar os requisitos das APIs.

O nome CAMARA tem origem na palavra grega que significa “teto abobadado”, simbolizando a colaboração ou aliança entre várias entidades sob uma mesma visão.

Como isso funciona?

Os membros (participantes, coordenadores, colaboradores etc.) do projeto CAMARA estão organizados em subprojetos e grupos de trabalho. Embora possam parecer semelhantes, há algumas diferenças.

Subprojetos

Um subprojeto é onde são discutidos temas relacionados a cada API, incluindo como documentá-la e descrevê-la, bem como desenvolvê-la e testá-la.

Os membros de cada subprojeto se reúnem virtualmente de tempos em tempos e organizam seu trabalho por meio de um repositório no GitHub e de uma lista de discussão. Todos os repositórios seguem a mesma estrutura, o que facilita a localização de informações:

• A documentation/MeetingMinutes pasta armazena todas as atas das reuniões anteriores, nas quais são tomadas decisões sobre o comportamento da API.

• O code/API_definitions contém a especificação OpenAPI da API no formato YAML.

Grupos de trabalho

Os grupos de trabalho geralmente tratam de temas comuns a todos os subprojetos. Alguns exemplos de grupos de trabalho são o Backlog de APIs, que gerencia o ciclo de vida das propostas de API, o grupo de Marketing, responsável pela promoção das APIs, ou o grupo de Pontos em Comum, onde são discutidos temas comuns relevantes para todas as APIs (por exemplo, autorização, documentação ou diretrizes)

Assim como nos subprojetos, os membros dos grupos de trabalho utilizam um repositório do GitHub e uma lista de discussão para coordenar suas atividades.

Se você estiver curioso sobre a estrutura do projeto e as funções de seus participantes, confira a página de documentação sobre a estrutura e as funções do projeto .

Ciclo de vida da API

Uma das atividades mais interessantes do projeto é cuidar do ciclo de vida das APIs.

Tudo começa com a processo de integração da API, onde as empresas podem enviar uma nova proposta de API apresentando uma descrição geral da API (o que ela faz, com alguns exemplos), juntamente com sua viabilidade técnica e comercial.

O grupo de trabalho API Backlog avaliará a proposta e, caso a aprove, a encaminhará ao comitê diretor para aprovação final. Se tudo correr bem, a proposta da API se tornará um subprojeto efetivo, que passará a receber contribuições e ideias por meio dos mecanismos descritos acima.

Assim que a especificação da API estiver suficientemente estável, a implementação será implantada e testada em uma ou mais redes de operadoras. A implantação poderá ser utilizada em ambientes de produção caso os testes sejam bem-sucedidos.

Conclusão

O projeto CAMARA representa um marco importante no setor de telecomunicações em termos de coordenação e cooperação. A estrutura aberta do projeto facilita o acompanhamento e a compreensão de algumas decisões tomadas por trás de cada API.

Os recursos e a documentação já produzidos pelos membros do projeto são bastante abrangentes. Não deixe de explorar o repositórios do GitHub e Wiki.