常連

現在担当しているタスクで、OpenAPI 3.0を使用してAPIの定義をしているのですが、CSVファイルをアップロードするAPI定義の方法が分かりません。[公式ドキュメント](https://swagger.io/docs/specification/describing-request-body/file-upload/#multipart)を参照するとimage/pngの画像ファイルをアップロードするAPIの定義方法が書かれているのですが、CSV等のテキストファイルをアップロードする方法について書かれておらず、調べても情報が出てこないので困っています。
また、バックエンドへリクエストを送信するためのコードはnpmの[@openapitools/openapi-generator-cli](https://www.npmjs.com/package/@openapitools/openapi-generator-cli)というパッケージを使用して自動生成しているのですが、リクエストが送信される時に、アップロードするファイルがどういう形式にエンコードされるのかということが分からず、現状は以下のコードのように定義しているのですが、これで大丈夫かどうかが分かりません。
どなたかご教授いただけると幸いです。よろしくお願い致します。

```ここに言語を入力
  /import-csv:
    post:
      tags:
        - csv
      requestBody:
        required: true
        content:
          multipart/form-data:
            schema:
              type: object
              properties:
                file:
                  type: string
                  format: binary
      responses:
        "201":
          description: Created
          content:
            application/json:
              schema:
                $ref: "./schemas/importCsvResponse.yaml"
        "400":
          description: Bad Request
        "401":
          description: Unauthorized
        "500":
          description: Internal Server Error
```

OpenAPI 3.0でCSVファイルをアップロードするAPIを定義する方法を教えてください

### redoclyのHTMLテンプレートをカスタムしたい


- [ ] `build-docs`をして作成されたhtmlファイルをカスタムして、`<script src="https://cdn.jsdelivr.net/npm/redoc/bundles/redoc.standalone.js">`などの外部参照してるところを内部のファイル参照にしたい

### 前提

OpenAPIの形式でAPI仕様書を会社の開発端末で書いています。
yamlファイルは出来上がり、`npx @redocly/cli build-docs xxx.yaml -o xxx.html`を実行したら問題なくHTMLファイルが作成されてWEB上でも表示できるところまできました。
開発環境、試験環境では問題ないのですが、本番環境ではセキュリティが厳しく、
WEBに表示する際に外部参照しているCSSファイルなどが参照できないので
内部のcssファイルやjsファイルを参照できないかと調査しています。
(redoc.standalone.jsなど)

直接HTMLファイルを書き換えれば出来ますが、ビルドオプション等でビルドする際に自動的に書き換わるようにしたいです。
色々方法は試してみているのですが実現できず困っています。

### 試したこと

- build後に直接HTMLファイルを書き換え
- カスタムHTMLテンプレートを作成し、`build-docs`のオプション`-template`で実現できるか試してみたが{{title}}以外のプレースホルダーが効かない
```
<!DOCTYPE html>
<html>
<head>
    <meta charset="UTF-8">
    <title>{{title}}</title>
    <style>
        {{redoc-styles}}
    </style>
</head>
<body>
    <div id="redoc-container"></div>
    <div id="redoc-content" class="redoc-content">
        {{redoc-html}}
    </div>
    <script srcr="js/redoc.standalone.js"> //WEBからファイルをダウンロードし内部に設置
        {{redoc-script}}
    </script>
</body>
</html>
```
- 公式でTemplateを編集できると書いてあるが、会社のPCでredocのアカウント登録をしてはいけないとのことなので使用できず
公式：https://redocly.com/docs/api-registry/settings/template/


### 補足情報（FW/ツールのバージョンなど）
Windows11
@redocly/cli : v1.9.0
Node.js : v20.11.0
npm : 10.2.4
VScode


redoclyのHTMLテンプレートをカスタムしたい

Open API(Swagger)にてリクエストがPostの場合CORSエラーが画面に表示される対処法について

利用環境はMacOSでブラウザはChromeを使用しています。
AWSのAPIGatewayにて、APIを作成しております。
swagger.yaml内のservers:url箇所にAPIGatewayのURLを入れております。

リクエストパラメータをGetの時は問題なく、値が取得できるのですが、
Postの場合、以下のエラーメッセージが表示されます。


Failed to fetch.
Possible Reasons:
CORS
Network Failure
URL scheme must be "http" or "https" for CORS request.



safariのブラウザで、CORSを無効化にすれば、CORSのエラーは解消されますが、
Chromeにて拡張機能を使用しましたが、CORSエラーが表示されたままになります。

この場合、swagger.yamlファイル内の記述でCORSを無効にする書き方はありますでしょうか？
もしくはChromeで設定すべき箇所あればご教示いただきたく存じます。


Open API(Swagger)にてリクエストがPostの場合CORSエラーが画面に表示される

### openapi-generator-cliのgenerateコマンドをdockerから実行。
openapi-generator-cliのgenerateコマンドをdockerで叩きたく以下のシェルを実行しているのですが、
/usr/local/bin/docker-entrypoint.shが見つからないと言われ実行できません。

``` Bash
set -e
CLI_VERSION=v4.3.1
API_NAME=$1
docker run --rm -v ${PWD}:/local openapitools/openapi-generator-cli:${CLI_VERSION} genarate -i /local/${API_NAME}/openapi.yml -g aspnetcore -o /local/${API_NAME}/aspnetcore
```
**エラーメッセージ**
```
/usr/local/bin/docker-entrypoint.sh: line 32: exec: genarate: not found
```

##### 試したこと
Docker for mac の再インストールは試しましたが変わらずでした。

解決法等ご存知の方おりましたら、ご教授のほどよろしくお願いいたします！

openapi-generator-cliのgenerateコマンドをdockerから実行できない。

構成

```docker-compose.yml
version: '3'
services:
  nginx:
    build: ./nginx
    ports:
      - '9000:80'
    volumes:
      - ./data/www:/var/www/html
      - ./nginx/server.conf:/etc/nginx/nginx.conf
  vue:
    build: ./vue
    volumes:
      - ./data/www:/app
    command: npm run dev
    ports:
      - '80:8080'
    tty: true

  swagger-editor:
    image: swaggerapi/swagger-editor
    container_name: "swagger-editor"
    ports:
      - "8081:8080"

  swagger-ui:
    image: swaggerapi/swagger-ui
    container_name: "swagger-ui"
    ports:
      - "8082:8080"
    volumes:
      - ./swagger/openapi.json:/openapi.json
    environment:
      SWAGGER_JSON: /openapi.json

  swagger-api:
    image: danielgtaylor/apisprout
    container_name: "swagger-api"
    ports:
      - "8083:8000"
    volumes:
      - ./swagger/openapi.json:/openapi.json
    command: /openapi.json
```

該当のコード
```ParentList.vue
<script>
  import Parent from '@/components/Parent'
  export default {
    name: 'ParentList',
    data(){
      return {
        parents: []
      }
    },
    created(){
      this.fetchData()
    },
    watch: {
      // ルートが変更されたらこのメソッドを再び呼び出します
      '$route': 'fetchData'
    },
    components: {
      'parent' : Parent
    },
    methods: {
      fetchData () {
        axios.post(
          "http://localhost:8083/parents",
          null,
          {},
          {
            headers:{
            }
          })
        .then(function(res){
          //vueにバインドされている値を書き換えると表示に反映される
          // app.result = res.data
          console.log(res)
        })
        .catch(function(res){
          //vueにバインドされている値を書き換えると表示に反映される
          // app.result = res.data
          console.log(res)
        })
      }
    }
  }
</script>
```

ログ
```
spread.js:25 POST http://localhost:8083/parents 404 (Not Found)
ParentList.vue?7aa4:51 Error: Request failed with status code 404
    at e.exports (spread.js:25)
    at e.exports (spread.js:25)
    at XMLHttpRequest.d.onreadystatechange (spread.js:25)
```

`http://localhost:8083/parents`を直接ブラウザで開けば開けます。
ホストを0.0.0.0にしてみたりもしましたがだめでした。Docker側に問題があるのかVue側に問題があるのかすらわからない有様で（どちらも素人です）検索ワードすら思いつかず困り果てています。お力添えをいただければ幸いです。

Docker上のVueからDocker上のswaggerAPIを叩きたい

### 前提・実現したいこと

「実現したいこと」
ファイルをS３からダウンロードするAPIを作成しています。
そのAPIのPOSTの正常な値を確認したいです。

「実施したこと」
・API仕様書をswaggerを用いて作成し、download.jsonファイルにレスポンスの値を記述
・api.phpにルートを記述
・FileDownloadController.phpファイルを作成
・Test API Testerを用いて、GET,POSTの値を確認


### 発生している問題・エラーメッセージ

GETを投げた際は、jsonファイルに記載したBODY内容が値として帰ってきましたが、
POSTでは404エラー（要求された URL は本サーバでは見つかりませんでした。）が返ってきます。
またBODY部分には{}という値が返ってきています。

```
//api.php
Route::get('/download', 'Api\FileDownloadController@post');
Route::post('/download/{admin_page_id }/{page_flg}', 'Api\FileDownloadController@post');
```

```
//FileDownloadController.php
class FileDownloadController extends ApiController
{
    public function post(Request $request)
    {
        return 'テスト';
    }
```



APIのモック（スタブ）の作成のために行っている上記の事が的外れな様な気も致します...
分からないことばかりのため、不明な部分が多い質問文かと思いますが、
回答いただけると幸いです。
よろしくお願いいたします。

APIモック(スタブ)を作成したいです...

お世話になります。
Swagger EditorのGenerateServer、Clientで質問があります。

###  実現したいこと
OpenAPI(Swagger)を使ってAPIの定義を記載してます。
コンポーネントの参照先が別のファイルにしているため、SwaggerEditorでファイルを開いたときにエラーが発生してしまいServer、Clientのコードファイルが生成できません。
解決策をご教授お願い致します。

ファイル構成は下記になります。
```
 ┌ components(共通のコンポーネントファイルが格納されているフォルダ)
 │　└ △△△.yaml(参照元であるコンポーネントが記述されているyamlファイル)
 └ 〇〇〇.yaml(△△△.yamlのコンポーネントを参照している。このファイルからコードファイルを生成したい)
```

### 発生している問題・エラーメッセージ

SwaggerEditor（Dockerで起動している）で表示されるエラー
```
Could not resolve reference: Tried to resolve a relative URL, without having a basePath. path: 'components/△△△.yaml' basePath: 'undefined'
Jump to line 38
```

### 該当のソースコード

△△△.yaml(該当箇所のみ抜粋)
```yaml

components:
  schemas:
    projectInfo:
      description: "プロジェクト情報"
      type: String
```

〇〇〇.yaml(該当箇所のみ抜粋)
```yaml
responses:
  "200":
  description:
　　"Success operation"
  content:
  　 application/json:
  schema:
    $ref: "components/△△△.yaml#/components/schemas/projectInfo"
```

〇〇〇.yaml の```$ref: "components/△△△.yaml#/components/schemas/projectInfo"```で参照をしてます。


### 補足情報
OpenAPIのバージョン・・・"3.0.3"
SwaggerEditor・・・dockerの「swaggerapi/swagger-editor:v3.8.2」を使用

Swagger Editorで複数ファイルからServer、Clientのコードファイルを生成したい

### 前提
こんにちは。
SpringでWEBシステムを作っています。
Swagger(openAPI)で生成したものを組み込んでいます。

ただ、手動で作成したControllerはURLを叩けばブレークポイントが止まるのですが、
Swaggerで生成されるControllerは止まりません。

手動で作成したものは@RestControllerに対し、Swaggerが生成した者は@Apiで書き出されてますが、混同していてはいけないのでしょうか？
いずれはSwaggerで生成される物を是とし、手動作成したControllerは破棄の予定です。

### 実現したいこと

Swaggerで生成されるControllerも正常に通る様にしたい。

### 発生している問題・エラーメッセージ
ブレークポイントを当てても入って来ず、Exceptionでエラーを起こしている形跡もありません。

### 該当のソースコード

```Java
// Swaggerで生成したControllerクラス
@javax.annotation.Generated(value = "io.swagger.codegen.v3.generators.java.SpringCodegen", date = "")
@Api(value = "Echo", description = "the Echo API")
public interface EchoApi {

    Logger log = LoggerFactory.getLogger(EchoApi.class);

    default Optional<ObjectMapper> getObjectMapper(){
        return Optional.empty();
    }

    default Optional<HttpServletRequest> getRequest(){
        return Optional.empty();
    }

    default Optional<String> getAcceptHeader() {
        return getRequest().map(r -> r.getHeader("Accept"));
    }

    @ApiOperation(value = "Echo処理", nickname = "echoPost", notes = "Helloを返却する", response = EchoReply.class, tags={ "echo", })
    @ApiResponses(value = { 
        @ApiResponse(code = 200, message = "成功", response = EchoReply.class) })
    @RequestMapping(value = "/echo",
        produces = { "application/json" }, 
        consumes = { "application/json" },
        method = RequestMethod.POST)
    default ResponseEntity<EchoReply> echoPost(@ApiParam(value = "" ,required=true )  @Valid @RequestBody EchoRequest body
) {
        if(getObjectMapper().isPresent() && getAcceptHeader().isPresent()) {
            if (getAcceptHeader().get().contains("application/json")) {
                try {
                    return new ResponseEntity<>(getObjectMapper().get().readValue("{\r\n  \"name\" : \"Hello\"\r\n}", EchoReply.class), HttpStatus.NOT_IMPLEMENTED);
                } catch (IOException e) {
                    log.error("Couldn't serialize response for content type application/json", e);
                    return new ResponseEntity<>(HttpStatus.INTERNAL_SERVER_ERROR);
                }
            }
        } else {
            log.warn("ObjectMapper or HttpServletRequest not configured in default EchoApi interface so no example is generated");
        }
        return new ResponseEntity<>(HttpStatus.NOT_IMPLEMENTED);
    }

}

//手動作成したControllerクラス
@RestController
public class TestController {
  @Autowired
  private TestService service;

  // curl -v 'http://localhost:8080/test?name=test'
  @GetMapping("/test")
  public JsonResult execute_a(@Validated TestForm form, BindingResult validate) throws JsonProcessingException {
    JsonResult result = new JsonResult();
    if (validate.hasErrors()) {
      result.setResult("error");
      result.setErrors(getValidationErrorMessage(validate));
      return result;
    }
    result.setResult(service.execute(form));
    return result;
  }
```

### 試したこと

両方のURLをcurlコマンドで実行した。
curl -v 'http://localhost:8080/test?name=test'
curl -i -X POST -H "Content-Type: application/json" -d "@c:/request.json" http://localhost:8080/echo

### 補足情報（FW/ツールのバージョンなど）

Java1.8
Spring
Swagger3.0.19
