Как писать specs?

Question

[ganjo888]

Как писать specs в json формате. Объясню, что имею ввиду.
У меня есть простая апишка по загрузке файлов , в котором по POST запросу отправляю файлы и записываю их в minio
Вот мне нужно описать это в виде спека в josn формате
Буду благодарен за пример как это описывается
вот что я сам написал, но не уверен что это норм

{
  "type": "object",
  "properties": {
    "request": {
      "type": "object",
      "properties": {
        "files": {
          "type": "array"
        }
      }
    },
    "response": {
      "type": "array",
      "properties": {
        "url": {
          "type": "array"
        }
      }
    }
  }
}

Answer 1

[Antony Tkachenko]

https://json-schema.org/
https://swagger.io/