Adição de versionamento obrigatórios no header e response da API
Torna-se obrigatória a inserção do versionamento no header e response das APIs de person (v1.3.0), capitalization-title (v1.2.0) e pension plan (v1.2.0) até dia 30/11/2023 .
O motor de conformidade será ajustado para avaliar essas alterações.
O header e response das APIs deverão ficar como sugere a versão atual abaixo (exemplo de person v1.5.1):
get:
tags:
- person
summary: Obtém a lista dos produtos do tipo seguro de pessoas.
description: "Obtém a lista dos produtos do tipo seguro de pessoas."
operationId: "getPerson"
parameters:
- $ref: "#/components/parameters/cache-Control"
- $ref: "#/components/parameters/content-Security-Policy"
- $ref: "#/components/parameters/content-Type"
- $ref: "#/components/parameters/strict-Transport-Security"
- $ref: "#/components/parameters/x-Content-Type-Options"
- $ref: "#/components/parameters/x-Frame-Options"
- $ref: "#/components/parameters/page"
- $ref: "#/components/parameters/pageSize"
- $ref: "#/components/parameters/x-v"
- $ref: "#/components/parameters/x-min-v"
responses:
'200':
description: Dados dos Plano de Seguro de Pessoas
content:
application/json:
schema:
$ref: '#/components/schemas/ResponsePersonList'
headers:
x-v:
description: |
Caso x-min-v e x-v tenham sido enviados, o titular dos dados deve responder
com a versao mais alta suportada entre x-min-v e x-v.
Caso x-min-v e x-v nao tenham sido enviados, o titular dos dados deve responder
com a versao que esta sendo utilizada naquele momento.
required: true
schema:
type: string
'204':
$ref: '#/components/responses/NoContent'
'400':
$ref: '#/components/responses/BadRequest'
'401':
$ref: '#/components/responses/Unauthorized'
'403':
$ref: '#/components/responses/Forbidden'
'404':
$ref: '#/components/responses/NotFound'
'405':
$ref: '#/components/responses/MethodNotAllowed'
'406':
$ref: '#/components/responses/NotAcceptable'
'422':
$ref: '#/components/responses/UnprocessableEntity'
'429':
$ref: '#/components/responses/TooManyRequests'
'500':
$ref: '#/components/responses/InternalServerError'
default:
description: Dados dos Plano de Seguro de Pessoas
content:
application/json:
schema:
$ref: '#/components/schemas/ResponsePersonList'
headers:
x-v:
description: |
Caso x-min-v e x-v tenham sido enviados, o titular dos dados deve responder
com a versao mais alta suportada entre x-min-v e x-v.
Caso x-min-v e x-v nao tenham sido enviados, o titular dos dados deve responder
com a versao que esta sendo utilizada naquele momento.
required: true
schema:
type: string
parameters:
.......
x-v:
name: x-v
in: header
description: |
Versão do endpoint da API requisitado pelo cliente. O titular dos dados deve
responder com a versão mais alta suportada entre x-min-v e x-v. Se o valor de
x-min-v for igual ou maior que o valor de x-v, o cabeçalho x-min-v deve ser
tratado como ausente. Se todas as versões solicitadas não forem suportadas,
o titular dos dados deve responder com o código de status 406 Not Acceptable.
required: false
schema:
type: string
example: '2.1.3'
x-min-v:
name: x-min-v
in: header
description: |
Versão mínima do endpoint da API requisitado pelo cliente. O detentor dos dados
deve responder com a versão mais alta suportada entre x-min-v e x-v. Se todas as
versões solicitadas não forem suportadas, o titular dos dados deve responder com
um código de status 406 Not Acceptable.
required: false
schema:
type: string
example: '2.0.0'
Especificação em OAS 3.0
⚙️ Download da Especificação
📑 Release Notes: