Tipos de Dados
Os tipos comuns DEVEM ser definidos seguindo a especificação OpenAPI:
| Tipo | Especificação | Exemplo |
|---|---|---|
| String | OAS3 - Strings | ”foo” |
| Boolean | OAS3 - Boolean | true |
| Number | OAS3 - Numbers | 2025 |
| Integer | OAS3 - Numbers | 7 |
| Array | OAS3 - Arrays | [“foo”, 5, -2, “bar”] |
| Object | OAS3 - Objects | {“key”: “value”} |
Os tipos de Data e Data e Hora DEVEM devem seguir a sua respectiva RFC:
| Tipo | Especificação | Exemplo |
|---|---|---|
| Data e Hora | OAS3 - Strings / RFC - 3339 | Exemplo: “2025-07-21T10:30:00-03:00” * O valor Offset Local DEVE ser incluído |
| Data | OAS3 - Strings / RFC - 3339 | ”2025-06-21” |
O tipo Arquivo PODE apresentar dois comportamentos distintintos de acordo com o Content-Type aplicado:
| Tipo | Especificação | Ocorrência | Exemplo |
|---|---|---|---|
| Arquivo | OAS3 - Files | Upload | multipart/form-data |
| Arquivo | OAS3 - Strings | Upload | application/json |
| Arquivo | OAS3 - Files | Download | application/octet-stream |
| Arquivo | OAS3 - Strings | Download | application/json |