> prism mock doc/openapi.yaml

> openapi-generator-cli generate -i \\
  ./YOUR_PATH/openapi.yaml -g typescript-axios -o openapi/types \\
  --additional-properties=modelPropertyNaming=camelCase,supportsES6=true

    async getShops() {
      state.isLoading = true
      const { data, error }: any = await new ApiV1ShopApi(
        undefined,
        $config.baseURL,
        axios as AxiosInstance
      )
        .apiV1ShopsGet(1, 1000)
        .catch((error) => {
          return { error }
        })
      state.isLoading = false
      if (error) {
        state.error = error
        return
      }
      state.shops = data.shops
    },

RSpec.describe 'Tables', type: :request do
  describe '#index' do
    it 'テーブルの配列を取得する' do
      get '/tables', params: { page: '1', per: '10' }, headers: { authorization: 'k0kubun' }
      expect(response.status).to eq(200)
    end

    it 'does not return tables if unauthorized' do
      get '/tables'
      expect(response.status).to eq(401)
    end
  end

  # ...
end

openapi: 3.0.3
info:
  title: rspec-openapi
paths:
  "/tables":
    get:
      summary: index
      tags:
      - Table
      parameters:
      - name: page
        in: query
        schema:
          type: integer
        example: 1
      - name: per
        in: query
        schema:
          type: integer
        example: 10
      responses:
        '200':
          description: returns a list of tables
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    id:
                      type: integer
                    name:
                      type: string
                    # ...

paths:
  "/api/v1/shops":
    get:
      security:
      - client: []
        access_token: []
        uid: []

components:
  securitySchemes:
    client:
      type: apiKey
      description: ClientID
      in: header
      name: client
    access_token:
      type: apiKey
      description: access-token
      in: header
      name: access-token
    uid:
      type: apiKey
      description: uid
      in: header
      name: uid

responses:
 '204':
   description: 商品カテゴリを更新
   # これ以降を削除する
   content:
    '':
      schema:
        type: string
      example: ''

responses:
  '204':
  description: 商品カテゴリを更新

let(:category) { create(:category, name: '名前') }

let(:category) { create(:category, id:1, name: '名前') }

responses:
    '200':
        description: 製品情報のリストを取得
        content:
        application/json:
            schema:
            properties:
                products:
                type: array
                items:
                    type: object
                    properties:
                    id:
                        type: integer
                    name:
                        type: string

/**
 *
 * @export
 * @interface InlineResponse2006
 */
export interface InlineResponse2006 {
    /**
     *
     * @type {number}
     * @memberof Shop
     */
    id: number;
    ...
}

/**
 *
 * @export
 * @interface Shop
 */
export interface Shop {
    /**
     *
     * @type {number}
     * @memberof Shop
     */
    id: number;
    ...
}

responses:
    '200':
        description: お店のリスト取得する
        content:
        application/json:
            schema:
            properties:
                products:
                type: array
                items:
                    "$ref": "#/components/schemas/Shop"

components:
  schemas:
    Shop:
      nullable: true
      type: object
      properties:
        id:
          type: integer
        name:
          type: string

responses:
    '200':
        description: お店のリストを取得
        content:
        application/json:
            schema:
            properties:
                products:
                type: array
                items:
                    "$ref": "#/components/schemas/Shop"
                    # せっかくコンポーネントを作ったのに下記の余分なものがついてしまう
                    type: object
                    properties:
                    id:
                        type: integer
                    name:
                        type: string