Блог

Я получаю следующую ошибку при создании API в Postman: «Недопустимый тип данных. Должно быть либо массив, логическое значение, целое число, число, объект или строка»

Ошибка исправлена при преобразовании строки "type": "file" в "type": "object" , но я не уверен, есть ли правильный способ для этой ситуации. Потому что с этим обновлением запрос может не быть передан при отправке запроса в Postman.

 "parameters": [
  {
      "in": "body",
      "name": "file",
      "description": "file",
      "required": false,
      "schema": {
          "type": "array",
          "items": {
              "type": "file"
          }
      }
  },
  ...
]
 

Итак, как я могу устранить проблему в Postman?

Проблема не в Почтальоне, а в определении API. "type": "file" не является допустимым значением типа для использования в схемах и параметрах тела, этот тип можно использовать только в in: formData параметрах.

С другой стороны, я не добавляю файл, пытаясь протестировать свое приложение через Postman. По этой причине я просто хочу подавить ошибки

В этом случае вы можете изменить "type": "file" значение на "type": "string" для подавления ошибок импорта. Или удалите всю проблемную операцию из определения API.

Как правильно определить загрузку файлов в OpenAPI

Определение API пытается описать загрузку массива файлов, но это не поддерживается в OpenAPI 2.0 ( swagger: '2.0' ). OAS2 поддерживает только загрузку отдельных именованных файлов через multipart/form-data , и в этом случае определение API будет выглядеть следующим образом:

 {
  "swagger: "2.0",
  ...

  "paths": {
    "/something": {
      "post": {
        "consumes": [
          "multipart/form-data"
        ],
        "parameters": [
          {
            "in": "formData",
            "name": "file1",
            "type": "file"    // A single file sent via form field "file1"
          },
          {
            "in": "formData",
            "name": "file2",
            "type": "file"    // Another file sent via form field "file2"
          }
        ]
        ...
}
 

Однако загрузка массива файлов поддерживается в OpenAPI 3:

 {
  "openapi": "3.0.0",
  ...

  "paths": {
    "/something": {
      "post": {
        "requestBody": {
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "format": "binary"
                    }
                  }
                }
              }
            }
          }
        },
        ...

      }
    }
  }
}