Páginas filhas
  • 4. Aprovando API de mensagem padronizada

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

Índice

Fluxo do processo

Overview

...

Criar nova Mensagem Padronizada e/ou API

...

Aprovação

...

Passo a passo

Clonar repositório GIT 


A estrutura do repositório está dividida nas seguintes pastas:

  • APIs
    • Contém documentação OpenAPI 
  • Schema
    • Contém os Schemas dos recursos utilizados por APIs e mensagem padronizada (/transactions)
  • Transactions
    • Contém propriedades comuns para a definição de um schema como um recurso de mensagem padronizada

Buscar JsonSchema na pasta "Schemas"

Nesse momento, devemos procurar se os modelos que serão utilizados como recursos da API já existem.

...

  • Se é uma mensagem padronizada sobre esse recurso que foi aprovada através de XSD, o mesmo teve o seu modelo automaticamente convertido para JsonSchema. 
  • Se é um JsonSchema proposto que foi aprovado pelo comitê.


Verificar se já existe alguma solicitação similar na lista de "Pull Requests"

Se não for possível encontrar o JsonSchema na pasta "Schemas", precisamos verificar se já existe um Pull Request existente para aquele schema ou API.

...

Se não encontrar, criar uma nova branch para a criação dos JSONs.

Criar branch 

Padrão nomenclatura para branch que contenha API e Schema

ResourceName/ApiVersion/SchemaVersion 

API version é iniciada pela letra "V"

...

Exemplo: Parameters/V1/1_000

Padrão nomenclatura para branch que contenha apenas a API

ResourceName/ApiVersion

Exemplo: Parameters/V1

Padrão nomenclatura para branch que contenha apenas o eschema

ResourceName/SchemaVersion 

Exemplo: Parameters/1_000



Add, Commit e Push

Abrir Pull Request

O pull request deve ser aberto com o mesmo nome da branch. 

...

Da mesma forma, a equipe TTALK interage sobre possíveis problemas na estrutura dos arquivos, padrões definidos e boas práticas, também pedindo ajustes antes da aprovação.




API Aprovada (merge com a Master)

Ao passar por essas duas etapas de aprovação (TTALK e comitê), os arquivos JSON são aprovados e é realizado um merge com a master.

...