spree_api 4.2.4 → 4.3.0.rc3

data/app/serializers/spree/v2/storefront/taxon_serializer.rb

@@ -23,13 +23,14 @@ module Spree
         belongs_to :taxonomy, record_type: :taxonomy
 
         has_many   :children, record_type: :taxon, serializer: :taxon
-        has_many   :products, record_type: :product
+        has_many   :products, record_type: :product,
+                              if: proc { |_taxon, params| params && params[:include_products] == true }
 
         has_one    :image,
-          object_method_name: :icon,
-          id_method_name: :icon_id,
-          record_type: :taxon_image,
-          serializer: :taxon_image
+                   object_method_name: :icon,
+                   id_method_name: :icon_id,
+                   record_type: :taxon_image,
+                   serializer: :taxon_image
       end
     end
   end

data/config/initializers/doorkeeper.rb

@@ -2,6 +2,7 @@ Doorkeeper.configure do
   orm :active_record
   use_refresh_token
   api_only
+  base_controller 'ActionController::API'
 
   skip_client_authentication_for_password_grant { true } if defined?(skip_client_authentication_for_password_grant)
 
@@ -23,9 +24,15 @@ Doorkeeper.configure do
     current_spree_user&.has_spree_role?('admin') || redirect_to(routes.root_url)
   end
 
-  grant_flows %w(password)
+  grant_flows %w[password client_credentials]
+
+  allow_blank_redirect_uri true
+
+  handle_auth_errors :raise
 
   access_token_methods :from_bearer_authorization, :from_access_token_param
+
+  optional_scopes :admin, :write, :read
 end
 
 Doorkeeper::AccessGrant.class_eval do

data/config/initializers/rabl.rb

@@ -0,0 +1,9 @@
+Rabl.configure do |config|
+  config.include_json_root = false
+  config.include_child_root = false
+
+  # Motivation here it make it call as_json when rendering timestamps
+  # and therefore display miliseconds. Otherwise it would fall to
+  # JSON.dump which doesn't display the miliseconds
+  config.json_engine = ActiveSupport::JSON
+end

data/config/locales/en.yml

@@ -26,7 +26,7 @@ en:
         cannot_ready: "Cannot ready shipment."
       stock_location_required: "A stock_location_id parameter must be provided in order to retrieve stock movements."
       invalid_taxonomy_id: "Invalid taxonomy id."
-      shipment_transfer_errors_occurred: "Following errors occured while attempting this action:"
+      shipment_transfer_errors_occurred: "Following errors occurred while attempting this action:"
       negative_quantity: "quantity is negative"
       wrong_shipment_target: "target shipment is the same as original shipment"
 

data/config/routes.rb

@@ -128,7 +128,7 @@ Spree::Core::Engine.add_routes do
 
     namespace :v2 do
       namespace :storefront do
-        resource :cart, controller: :cart, only: %i[show create] do
+        resource :cart, controller: :cart, only: %i[show create destroy] do
           post   :add_item
           patch  :empty
           delete 'remove_line_item/:line_item_id', to: 'cart#remove_line_item', as: :cart_remove_line_item
@@ -149,11 +149,11 @@ Spree::Core::Engine.add_routes do
           get :shipping_rates
         end
 
-        resource :account, controller: :account, only: %i[show]
+        resource :account, controller: :account, only: %i[show create update]
 
         namespace :account do
           resources :addresses, controller: :addresses
-          resources :credit_cards, controller: :credit_cards, only: %i[index show]
+          resources :credit_cards, controller: :credit_cards, only: %i[index show destroy]
           resources :orders, controller: :orders, only: %i[index show]
         end
 
@@ -163,6 +163,118 @@ Spree::Core::Engine.add_routes do
         resources :products, only: %i[index show]
         resources :taxons,   only: %i[index show], id: /.+/
         get '/stores/:code', to: 'stores#show', as: :store
+
+        resources :menus, only: %i[index show]
+        resources :cms_pages, only: %i[index show]
+      end
+
+      namespace :platform do
+        # Promotions API
+        resources :promotions
+
+        # Returns API
+        resources :customer_returns
+        resources :reimbursements
+        resources :return_authorizations do
+          member do
+            put :add
+            put :cancel
+            put :receive
+          end
+        end
+
+        # Product Catalog API
+        resources :products
+        resources :taxonomies
+        resources :taxons
+        resources :classifications do
+          member do
+            put :reposition
+          end
+        end
+        resources :images
+        resources :variants
+        resources :properties
+        resources :product_properties
+        resources :option_types
+        resources :option_values
+
+        # Order API
+        resources :orders do
+          member do
+            put :next
+            put :advance
+            put :approve
+            put :cancel
+            put :empty
+            put :apply_coupon_code
+            put :remove_coupon_code
+          end
+        end
+        resources :line_items
+        resources :payments do
+          member do
+            put :authorize
+            put :capture
+            put :purchase
+            put :void
+            put :credit
+          end
+        end
+
+        # Geo API
+        resources :zones
+        resources :countries, only: [:index, :show]
+        resources :states, only: [:index, :show]
+
+        # Shipment API
+        resources :shipments do
+          collection do
+            post 'transfer_to_location'
+            post 'transfer_to_shipment'
+          end
+          member do
+            put :ready
+            put :ship
+            put :add
+            put :remove
+          end
+        end
+
+        # Inventory API
+        resources :inventory_units
+        resources :stock_items
+        resources :stock_locations
+        resources :stock_movements
+
+        # User API
+        resources :users
+        resources :credit_cards
+        resources :addresses
+
+        # Menu API
+        resources :menus
+        resources :menu_items do
+          member do
+            patch :reposition
+          end
+        end
+
+        # CMS Pages API
+        resources :cms_pages do
+          member do
+            patch :toggle_visibility
+          end
+        end
+
+        resource :cms_sections do
+          member do
+            patch :reposition
+          end
+        end
+
+        # Store API
+        resources :stores
       end
     end
 

data/db/migrate/20210727102516_change_integer_id_columns_type.rb

@@ -0,0 +1,9 @@
+class ChangeIntegerIdColumnsType < ActiveRecord::Migration[5.2]
+  def change
+    change_column :spree_oauth_access_grants, :resource_owner_id, :bigint
+    change_column :spree_oauth_access_grants, :application_id, :bigint
+
+    change_column :spree_oauth_access_tokens, :resource_owner_id, :bigint
+    change_column :spree_oauth_access_tokens, :application_id, :bigint
+  end
+end

data/docs/oauth/index.yml

@@ -6,8 +6,8 @@ servers:
     description: localhost
 info:
   version: 1.0.0
-  title: Spree OAuth 2.0 Authentication
-  description: "For API v2 Spree uses [Doorkeeper](https://github.com/doorkeeper-gem/doorkeeper) gem for handling OAuth athentication. \n\nSpree supports new token creation and refreshing of existing tokens."
+  title: Authentication
+  description: "Spree uses oAuth based Authentication via short-lived Bearer tokens. You can either create a new one or refresh existing token."
   contact:
     name: Spark Solutions
     url: 'https://sparksolutions.co'
@@ -18,13 +18,13 @@ info:
 paths:
   /spree_oauth/token:
     post:
-      description: Creates or refreshes a Bearer token required to authorize calls API calls
+      description: Creates or refreshes a Bearer token required to authorize API calls
       tags:
         - Token
       operationId: Create or Refresh Token
       responses:
         '200':
-          description: Token was succesfully created or refreshed
+          description: Token was successfully created or refreshed
           content:
             application/json:
               schema:

data/docs/v2/platform/index.yaml

@@ -0,0 +1,3597 @@
+---
+openapi: 3.0.1
+info:
+  title: Platform API V2
+  version: v2
+paths:
+  "/api/v2/platform/addresses":
+    get:
+      summary: Returns a list of Addresses
+      tags:
+      - Addresses
+      security:
+      - bearer_auth: []
+      parameters:
+      - name: page
+        in: query
+        example: 1
+        schema:
+          type: integer
+      - name: per_page
+        in: query
+        example: 50
+        schema:
+          type: integer
+      - name: include
+        in: query
+        description: 'Select which associated resources you would like to fetch, see:
+          <a href="https://jsonapi.org/format/#fetching-includes">https://jsonapi.org/format/#fetching-includes</a>'
+        example: user,country,state
+        schema:
+          type: string
+      - name: filter
+        in: query
+        description: ''
+        example: user_id_eq=1&firstname_cont=Joh
+        schema:
+          type: string
+      responses:
+        '200':
+          description: Records returned
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    data:
+                    - id: '1'
+                      type: address
+                      attributes:
+                        firstname: John
+                        lastname: Doe
+                        address1: 1 Lovely Street
+                        address2: Northwest
+                        city: Herndon
+                        zipcode: '35005'
+                        phone: 555-555-0199
+                        state_name:
+                        alternative_phone: 555-555-0199
+                        company: Company
+                        created_at: '2021-08-23T21:28:22.108Z'
+                        updated_at: '2021-08-23T21:28:22.108Z'
+                        deleted_at:
+                        label:
+                      relationships:
+                        country:
+                          data:
+                            id: '1'
+                            type: country
+                        state:
+                          data:
+                            id: '1'
+                            type: state
+                        user:
+                          data:
+                    - id: '2'
+                      type: address
+                      attributes:
+                        firstname: John
+                        lastname: Doe
+                        address1: 2 Lovely Street
+                        address2: Northwest
+                        city: Herndon
+                        zipcode: '35005'
+                        phone: 555-555-0199
+                        state_name:
+                        alternative_phone: 555-555-0199
+                        company: Company
+                        created_at: '2021-08-23T21:28:22.134Z'
+                        updated_at: '2021-08-23T21:28:22.134Z'
+                        deleted_at:
+                        label:
+                      relationships:
+                        country:
+                          data:
+                            id: '1'
+                            type: country
+                        state:
+                          data:
+                            id: '2'
+                            type: state
+                        user:
+                          data:
+                    meta:
+                      count: 2
+                      total_count: 2
+                      total_pages: 1
+                    links:
+                      self: http://www.example.com/api/v2/platform/addresses?page=1&per_page=&include=&filter=
+                      next: http://www.example.com/api/v2/platform/addresses?include=&page=1&per_page=
+                      prev: http://www.example.com/api/v2/platform/addresses?include=&page=1&per_page=
+                      last: http://www.example.com/api/v2/platform/addresses?include=&page=1&per_page=
+                      first: http://www.example.com/api/v2/platform/addresses?include=&page=1&per_page=
+        '401':
+          description: Authentication Failed
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: The access token is invalid
+    post:
+      summary: Creates an Address
+      tags:
+      - Addresses
+      security:
+      - bearer_auth: []
+      parameters:
+      - name: include
+        in: query
+        description: 'Select which associated resources you would like to fetch, see:
+          <a href="https://jsonapi.org/format/#fetching-includes">https://jsonapi.org/format/#fetching-includes</a>'
+        example: user,country,state
+        schema:
+          type: string
+      responses:
+        '201':
+          description: record created
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    data:
+                      id: '1'
+                      type: address
+                      attributes:
+                        firstname: John
+                        lastname: Doe
+                        address1: 5 Lovely Street
+                        address2: Northwest
+                        city: Herndon
+                        zipcode: '35005'
+                        phone: 555-555-0199
+                        state_name:
+                        alternative_phone: 555-555-0199
+                        company: Company
+                        created_at: '2021-08-23T21:28:22.275Z'
+                        updated_at: '2021-08-23T21:28:22.275Z'
+                        deleted_at:
+                        label:
+                      relationships:
+                        country:
+                          data:
+                            id: '2'
+                            type: country
+                        state:
+                          data:
+                            id: '1'
+                            type: state
+                        user:
+                          data:
+                            id: '1'
+                            type: user
+        '422':
+          description: invalid request
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: First Name can't be blank, Last Name can't be blank, Address
+                      can't be blank, City can't be blank, Country can't be blank,
+                      Zip Code can't be blank, and Phone can't be blank
+                    errors:
+                      firstname:
+                      - can't be blank
+                      lastname:
+                      - can't be blank
+                      address1:
+                      - can't be blank
+                      city:
+                      - can't be blank
+                      country:
+                      - can't be blank
+                      zipcode:
+                      - can't be blank
+                      phone:
+                      - can't be blank
+      requestBody:
+        content:
+          application/json:
+            schema:
+              "$ref": "#/components/schemas/addresses_params"
+  "/api/v2/platform/addresses/{id}":
+    get:
+      summary: Returns an Address
+      tags:
+      - Addresses
+      security:
+      - bearer_auth: []
+      parameters:
+      - name: id
+        in: path
+        required: true
+        schema:
+          type: string
+      - name: include
+        in: query
+        description: 'Select which associated resources you would like to fetch, see:
+          <a href="https://jsonapi.org/format/#fetching-includes">https://jsonapi.org/format/#fetching-includes</a>'
+        example: user,country,state
+        schema:
+          type: string
+      responses:
+        '200':
+          description: Record found
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    data:
+                      id: '1'
+                      type: address
+                      attributes:
+                        firstname: John
+                        lastname: Doe
+                        address1: 6 Lovely Street
+                        address2: Northwest
+                        city: Herndon
+                        zipcode: '35005'
+                        phone: 555-555-0199
+                        state_name:
+                        alternative_phone: 555-555-0199
+                        company: Company
+                        created_at: '2021-08-23T21:28:22.297Z'
+                        updated_at: '2021-08-23T21:28:22.297Z'
+                        deleted_at:
+                        label:
+                      relationships:
+                        country:
+                          data:
+                            id: '1'
+                            type: country
+                        state:
+                          data:
+                            id: '1'
+                            type: state
+                        user:
+                          data:
+        '404':
+          description: Record not found
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: The resource you were looking for could not be found.
+        '401':
+          description: Authentication Failed
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: The access token is invalid
+    put:
+      summary: Updates an Address
+      tags:
+      - Addresses
+      security:
+      - bearer_auth: []
+      parameters:
+      - name: id
+        in: path
+        required: true
+        schema:
+          type: string
+      - name: include
+        in: query
+        description: 'Select which associated resources you would like to fetch, see:
+          <a href="https://jsonapi.org/format/#fetching-includes">https://jsonapi.org/format/#fetching-includes</a>'
+        example: user,country,state
+        schema:
+          type: string
+      responses:
+        '200':
+          description: record updated
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    data:
+                      id: '1'
+                      type: address
+                      attributes:
+                        firstname: Jack
+                        lastname: Doe
+                        address1: 8 Lovely Street
+                        address2: Northwest
+                        city: Herndon
+                        zipcode: '35005'
+                        phone: 555-555-0199
+                        state_name:
+                        alternative_phone: 555-555-0199
+                        company: Company
+                        created_at: '2021-08-23T21:28:22.331Z'
+                        updated_at: '2021-08-23T21:28:22.336Z'
+                        deleted_at:
+                        label:
+                      relationships:
+                        country:
+                          data:
+                            id: '1'
+                            type: country
+                        state:
+                          data:
+                            id: '1'
+                            type: state
+                        user:
+                          data:
+        '422':
+          description: invalid request
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: First Name can't be blank and Last Name can't be blank
+                    errors:
+                      firstname:
+                      - can't be blank
+                      lastname:
+                      - can't be blank
+        '404':
+          description: Record not found
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: The resource you were looking for could not be found.
+        '401':
+          description: Authentication Failed
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: The access token is invalid
+      requestBody:
+        content:
+          application/json:
+            schema:
+              "$ref": "#/components/schemas/addresses_params"
+    delete:
+      summary: Deletes an Address
+      tags:
+      - Addresses
+      security:
+      - bearer_auth: []
+      parameters:
+      - name: id
+        in: path
+        required: true
+        schema:
+          type: string
+      responses:
+        '204':
+          description: Record deleted
+        '404':
+          description: Record not found
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: The resource you were looking for could not be found.
+        '401':
+          description: Authentication Failed
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: The access token is invalid
+  "/api/v2/platform/classifications":
+    get:
+      summary: Returns a list of Classifications
+      tags:
+      - Classifications
+      security:
+      - bearer_auth: []
+      parameters:
+      - name: page
+        in: query
+        example: 1
+        schema:
+          type: integer
+      - name: per_page
+        in: query
+        example: 50
+        schema:
+          type: integer
+      - name: include
+        in: query
+        description: 'Select which associated resources you would like to fetch, see:
+          <a href="https://jsonapi.org/format/#fetching-includes">https://jsonapi.org/format/#fetching-includes</a>'
+        example: product,taxon
+        schema:
+          type: string
+      - name: filter
+        in: query
+        description: ''
+        example: taxon_id_eq=1
+        schema:
+          type: string
+      responses:
+        '200':
+          description: Records returned
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    data:
+                    - id: '1'
+                      type: classification
+                      attributes:
+                        position: 1
+                        created_at: '2021-08-23T21:28:22.534Z'
+                        updated_at: '2021-08-23T21:28:22.534Z'
+                      relationships:
+                        product:
+                          data:
+                            id: '1'
+                            type: product
+                        taxon:
+                          data:
+                            id: '2'
+                            type: taxon
+                    - id: '2'
+                      type: classification
+                      attributes:
+                        position: 1
+                        created_at: '2021-08-23T21:28:22.569Z'
+                        updated_at: '2021-08-23T21:28:22.569Z'
+                      relationships:
+                        product:
+                          data:
+                            id: '2'
+                            type: product
+                        taxon:
+                          data:
+                            id: '4'
+                            type: taxon
+                    meta:
+                      count: 2
+                      total_count: 2
+                      total_pages: 1
+                    links:
+                      self: http://www.example.com/api/v2/platform/classifications?page=1&per_page=&include=&filter=
+                      next: http://www.example.com/api/v2/platform/classifications?include=&page=1&per_page=
+                      prev: http://www.example.com/api/v2/platform/classifications?include=&page=1&per_page=
+                      last: http://www.example.com/api/v2/platform/classifications?include=&page=1&per_page=
+                      first: http://www.example.com/api/v2/platform/classifications?include=&page=1&per_page=
+        '401':
+          description: Authentication Failed
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: The access token is invalid
+    post:
+      summary: Creates a Classification
+      tags:
+      - Classifications
+      security:
+      - bearer_auth: []
+      parameters:
+      - name: include
+        in: query
+        description: 'Select which associated resources you would like to fetch, see:
+          <a href="https://jsonapi.org/format/#fetching-includes">https://jsonapi.org/format/#fetching-includes</a>'
+        example: product,taxon
+        schema:
+          type: string
+      responses:
+        '201':
+          description: record created
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    data:
+                      id: '1'
+                      type: classification
+                      attributes:
+                        position: 1
+                        created_at: '2021-08-23T21:28:22.728Z'
+                        updated_at: '2021-08-23T21:28:22.728Z'
+                      relationships:
+                        product:
+                          data:
+                            id: '1'
+                            type: product
+                        taxon:
+                          data:
+                            id: '2'
+                            type: taxon
+        '422':
+          description: invalid request
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: Taxon can't be blank and Product can't be blank
+                    errors:
+                      taxon:
+                      - can't be blank
+                      product:
+                      - can't be blank
+      requestBody:
+        content:
+          application/json:
+            schema:
+              "$ref": "#/components/schemas/classifications_params"
+  "/api/v2/platform/classifications/{id}":
+    get:
+      summary: Returns a Classification
+      tags:
+      - Classifications
+      security:
+      - bearer_auth: []
+      parameters:
+      - name: id
+        in: path
+        required: true
+        schema:
+          type: string
+      - name: include
+        in: query
+        description: 'Select which associated resources you would like to fetch, see:
+          <a href="https://jsonapi.org/format/#fetching-includes">https://jsonapi.org/format/#fetching-includes</a>'
+        example: product,taxon
+        schema:
+          type: string
+      responses:
+        '200':
+          description: Record found
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    data:
+                      id: '1'
+                      type: classification
+                      attributes:
+                        position: 1
+                        created_at: '2021-08-23T21:28:22.787Z'
+                        updated_at: '2021-08-23T21:28:22.787Z'
+                      relationships:
+                        product:
+                          data:
+                            id: '1'
+                            type: product
+                        taxon:
+                          data:
+                            id: '2'
+                            type: taxon
+        '404':
+          description: Record not found
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: The resource you were looking for could not be found.
+        '401':
+          description: Authentication Failed
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: The access token is invalid
+    put:
+      summary: Updates a Classification
+      tags:
+      - Classifications
+      security:
+      - bearer_auth: []
+      parameters:
+      - name: id
+        in: path
+        required: true
+        schema:
+          type: string
+      - name: include
+        in: query
+        description: 'Select which associated resources you would like to fetch, see:
+          <a href="https://jsonapi.org/format/#fetching-includes">https://jsonapi.org/format/#fetching-includes</a>'
+        example: product,taxon
+        schema:
+          type: string
+      responses:
+        '200':
+          description: record updated
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    data:
+                      id: '1'
+                      type: classification
+                      attributes:
+                        position: 1
+                        created_at: '2021-08-23T21:28:22.904Z'
+                        updated_at: '2021-08-23T21:28:22.904Z'
+                      relationships:
+                        product:
+                          data:
+                            id: '1'
+                            type: product
+                        taxon:
+                          data:
+                            id: '2'
+                            type: taxon
+        '422':
+          description: invalid request
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: Product can't be blank
+                    errors:
+                      product:
+                      - can't be blank
+        '404':
+          description: Record not found
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: The resource you were looking for could not be found.
+        '401':
+          description: Authentication Failed
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: The access token is invalid
+      requestBody:
+        content:
+          application/json:
+            schema:
+              "$ref": "#/components/schemas/classifications_params"
+    delete:
+      summary: Deletes a Classification
+      tags:
+      - Classifications
+      security:
+      - bearer_auth: []
+      parameters:
+      - name: id
+        in: path
+        required: true
+        schema:
+          type: string
+      responses:
+        '204':
+          description: Record deleted
+        '404':
+          description: Record not found
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: The resource you were looking for could not be found.
+        '401':
+          description: Authentication Failed
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: The access token is invalid
+  "/api/v2/platform/classifications/{id}/reposition":
+    put:
+      summary: Reposition a Classification
+      tags:
+      - Classifications
+      security:
+      - bearer_auth: []
+      parameters:
+      - name: id
+        in: path
+        required: true
+        schema:
+          type: string
+      - name: include
+        in: query
+        description: 'Select which associated resources you would like to fetch, see:
+          <a href="https://jsonapi.org/format/#fetching-includes">https://jsonapi.org/format/#fetching-includes</a>'
+        example: product,taxon
+        schema:
+          type: string
+      responses:
+        '200':
+          description: record updated
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    data:
+                      id: '1'
+                      type: classification
+                      attributes:
+                        position: 2
+                        created_at: '2021-08-23T21:28:23.191Z'
+                        updated_at: '2021-08-23T21:28:23.199Z'
+                      relationships:
+                        product:
+                          data:
+                            id: '1'
+                            type: product
+                        taxon:
+                          data:
+                            id: '2'
+                            type: taxon
+        '422':
+          description: invalid request
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: is not a number
+                    errors: {}
+        '404':
+          description: Record not found
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: The resource you were looking for could not be found.
+        '401':
+          description: Authentication Failed
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: The access token is invalid
+      requestBody:
+        content:
+          application/json:
+            schema:
+              "$ref": "#/components/schemas/classification_params"
+  "/api/v2/platform/countries":
+    get:
+      summary: Returns a list of Countries
+      tags:
+      - Countries
+      security:
+      - bearer_auth: []
+      responses:
+        '200':
+          description: Records returned
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    data:
+                    - id: '1'
+                      type: country
+                      attributes:
+                        iso_name: UNITED STATES
+                        iso: US
+                        iso3: IS34
+                        name: United States of America
+                        numcode: 840
+                        states_required: true
+                        updated_at: '2021-08-23T21:28:23.328Z'
+                        zipcode_required: true
+                        created_at: '2021-08-23T21:28:23.328Z'
+                      relationships:
+                        states:
+                          data: []
+                    - id: '2'
+                      type: country
+                      attributes:
+                        iso_name: ISO_NAME_2
+                        iso: I2
+                        iso3: IS35
+                        name: NAME_2
+                        numcode: 840
+                        states_required: false
+                        updated_at: '2021-08-23T21:28:23.332Z'
+                        zipcode_required: true
+                        created_at: '2021-08-23T21:28:23.332Z'
+                      relationships:
+                        states:
+                          data: []
+                    - id: '3'
+                      type: country
+                      attributes:
+                        iso_name: ISO_NAME_3
+                        iso: I3
+                        iso3: IS36
+                        name: NAME_3
+                        numcode: 840
+                        states_required: false
+                        updated_at: '2021-08-23T21:28:23.333Z'
+                        zipcode_required: true
+                        created_at: '2021-08-23T21:28:23.333Z'
+                      relationships:
+                        states:
+                          data: []
+                    meta:
+                      count: 3
+                      total_count: 3
+                      total_pages: 1
+                    links:
+                      self: http://www.example.com/api/v2/platform/countries
+                      next: http://www.example.com/api/v2/platform/countries?page=1
+                      prev: http://www.example.com/api/v2/platform/countries?page=1
+                      last: http://www.example.com/api/v2/platform/countries?page=1
+                      first: http://www.example.com/api/v2/platform/countries?page=1
+        '401':
+          description: Authentication Failed
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: The access token is invalid
+  "/api/v2/platform/countries/{id}":
+    get:
+      summary: Returns a Country
+      tags:
+      - Countries
+      security:
+      - bearer_auth: []
+      parameters:
+      - name: id
+        in: path
+        required: true
+        schema:
+          type: string
+      responses:
+        '200':
+          description: Record found
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    data:
+                      id: '2'
+                      type: country
+                      attributes:
+                        iso_name: ISO_NAME_6
+                        iso: I6
+                        iso3: IS41
+                        name: NAME_6
+                        numcode: 840
+                        states_required: false
+                        updated_at: '2021-08-23T21:28:23.362Z'
+                        zipcode_required: true
+                        created_at: '2021-08-23T21:28:23.362Z'
+                      relationships:
+                        states:
+                          data: []
+        '404':
+          description: Record not found
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: The resource you were looking for could not be found.
+        '401':
+          description: Authentication Failed
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: The access token is invalid
+  "/api/v2/platform/menu_items":
+    get:
+      summary: Returns a list of MenuItems
+      tags:
+      - MenuItems
+      security:
+      - bearer_auth: []
+      parameters:
+      - name: page
+        in: query
+        example: 1
+        schema:
+          type: integer
+      - name: per_page
+        in: query
+        example: 50
+        schema:
+          type: integer
+      - name: include
+        in: query
+        description: 'Select which associated resources you would like to fetch, see:
+          <a href="https://jsonapi.org/format/#fetching-includes">https://jsonapi.org/format/#fetching-includes</a>'
+        example: linked_resource
+        schema:
+          type: string
+      - name: filter
+        in: query
+        description: ''
+        example:
+        schema:
+          type: string
+      responses:
+        '200':
+          description: Records returned
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    data:
+                    - id: '1'
+                      type: menu_item
+                      attributes:
+                        name: Quia ea unde minus sunt voluptatum iste repellendus.
+                        subtitle:
+                        destination:
+                        new_window: false
+                        item_type: Container
+                        linked_resource_type: URL
+                        code:
+                        lft: 1
+                        rgt: 16
+                        depth: 0
+                        created_at: '2021-08-23T21:28:23.403Z'
+                        updated_at: '2021-08-23T21:28:23.479Z'
+                        link:
+                        is_container: true
+                        is_root: true
+                        is_child: false
+                        is_leaf: false
+                      relationships:
+                        icon:
+                          data:
+                        menu:
+                          data:
+                            id: '1'
+                            type: menu
+                        parent:
+                          data:
+                        linked_resource:
+                          data:
+                        children:
+                          data:
+                          - id: '2'
+                            type: menu_item
+                          - id: '3'
+                            type: menu_item
+                          - id: '4'
+                            type: menu_item
+                          - id: '5'
+                            type: menu_item
+                          - id: '6'
+                            type: menu_item
+                          - id: '7'
+                            type: menu_item
+                          - id: '8'
+                            type: menu_item
+                    - id: '2'
+                      type: menu_item
+                      attributes:
+                        name: Link no. 1 To Somewhere
+                        subtitle:
+                        destination:
+                        new_window: false
+                        item_type: Link
+                        linked_resource_type: URL
+                        code:
+                        lft: 2
+                        rgt: 3
+                        depth: 1
+                        created_at: '2021-08-23T21:28:23.414Z'
+                        updated_at: '2021-08-23T21:28:23.416Z'
+                        link:
+                        is_container: false
+                        is_root: false
+                        is_child: true
+                        is_leaf: true
+                      relationships:
+                        icon:
+                          data:
+                            id: '1'
+                            type: icon
+                        menu:
+                          data:
+                            id: '1'
+                            type: menu
+                        parent:
+                          data:
+                            id: '1'
+                            type: menu_item
+                        linked_resource:
+                          data:
+                        children:
+                          data: []
+                    - id: '3'
+                      type: menu_item
+                      attributes:
+                        name: Link no. 2 To Somewhere
+                        subtitle:
+                        destination:
+                        new_window: false
+                        item_type: Link
+                        linked_resource_type: URL
+                        code:
+                        lft: 4
+                        rgt: 5
+                        depth: 1
+                        created_at: '2021-08-23T21:28:23.425Z'
+                        updated_at: '2021-08-23T21:28:23.426Z'
+                        link:
+                        is_container: false
+                        is_root: false
+                        is_child: true
+                        is_leaf: true
+                      relationships:
+                        icon:
+                          data:
+                            id: '2'
+                            type: icon
+                        menu:
+                          data:
+                            id: '1'
+                            type: menu
+                        parent:
+                          data:
+                            id: '1'
+                            type: menu_item
+                        linked_resource:
+                          data:
+                        children:
+                          data: []
+                    - id: '4'
+                      type: menu_item
+                      attributes:
+                        name: Link no. 3 To Somewhere
+                        subtitle:
+                        destination:
+                        new_window: false
+                        item_type: Link
+                        linked_resource_type: URL
+                        code:
+                        lft: 6
+                        rgt: 7
+                        depth: 1
+                        created_at: '2021-08-23T21:28:23.435Z'
+                        updated_at: '2021-08-23T21:28:23.436Z'
+                        link:
+                        is_container: false
+                        is_root: false
+                        is_child: true
+                        is_leaf: true
+                      relationships:
+                        icon:
+                          data:
+                            id: '3'
+                            type: icon
+                        menu:
+                          data:
+                            id: '1'
+                            type: menu
+                        parent:
+                          data:
+                            id: '1'
+                            type: menu_item
+                        linked_resource:
+                          data:
+                        children:
+                          data: []
+                    - id: '5'
+                      type: menu_item
+                      attributes:
+                        name: Link no. 4 To Somewhere
+                        subtitle:
+                        destination:
+                        new_window: false
+                        item_type: Link
+                        linked_resource_type: URL
+                        code:
+                        lft: 8
+                        rgt: 9
+                        depth: 1
+                        created_at: '2021-08-23T21:28:23.444Z'
+                        updated_at: '2021-08-23T21:28:23.446Z'
+                        link:
+                        is_container: false
+                        is_root: false
+                        is_child: true
+                        is_leaf: true
+                      relationships:
+                        icon:
+                          data:
+                            id: '4'
+                            type: icon
+                        menu:
+                          data:
+                            id: '1'
+                            type: menu
+                        parent:
+                          data:
+                            id: '1'
+                            type: menu_item
+                        linked_resource:
+                          data:
+                        children:
+                          data: []
+                    - id: '6'
+                      type: menu_item
+                      attributes:
+                        name: Link no. 5 To Somewhere
+                        subtitle:
+                        destination:
+                        new_window: false
+                        item_type: Link
+                        linked_resource_type: URL
+                        code:
+                        lft: 10
+                        rgt: 11
+                        depth: 1
+                        created_at: '2021-08-23T21:28:23.454Z'
+                        updated_at: '2021-08-23T21:28:23.456Z'
+                        link:
+                        is_container: false
+                        is_root: false
+                        is_child: true
+                        is_leaf: true
+                      relationships:
+                        icon:
+                          data:
+                            id: '5'
+                            type: icon
+                        menu:
+                          data:
+                            id: '1'
+                            type: menu
+                        parent:
+                          data:
+                            id: '1'
+                            type: menu_item
+                        linked_resource:
+                          data:
+                        children:
+                          data: []
+                    - id: '7'
+                      type: menu_item
+                      attributes:
+                        name: Link no. 6 To Somewhere
+                        subtitle:
+                        destination:
+                        new_window: false
+                        item_type: Link
+                        linked_resource_type: URL
+                        code:
+                        lft: 12
+                        rgt: 13
+                        depth: 1
+                        created_at: '2021-08-23T21:28:23.464Z'
+                        updated_at: '2021-08-23T21:28:23.465Z'
+                        link:
+                        is_container: false
+                        is_root: false
+                        is_child: true
+                        is_leaf: true
+                      relationships:
+                        icon:
+                          data:
+                            id: '6'
+                            type: icon
+                        menu:
+                          data:
+                            id: '1'
+                            type: menu
+                        parent:
+                          data:
+                            id: '1'
+                            type: menu_item
+                        linked_resource:
+                          data:
+                        children:
+                          data: []
+                    - id: '8'
+                      type: menu_item
+                      attributes:
+                        name: Link no. 7 To Somewhere
+                        subtitle:
+                        destination:
+                        new_window: false
+                        item_type: Link
+                        linked_resource_type: URL
+                        code:
+                        lft: 14
+                        rgt: 15
+                        depth: 1
+                        created_at: '2021-08-23T21:28:23.474Z'
+                        updated_at: '2021-08-23T21:28:23.475Z'
+                        link:
+                        is_container: false
+                        is_root: false
+                        is_child: true
+                        is_leaf: true
+                      relationships:
+                        icon:
+                          data:
+                            id: '7'
+                            type: icon
+                        menu:
+                          data:
+                            id: '1'
+                            type: menu
+                        parent:
+                          data:
+                            id: '1'
+                            type: menu_item
+                        linked_resource:
+                          data:
+                        children:
+                          data: []
+                    meta:
+                      count: 8
+                      total_count: 8
+                      total_pages: 1
+                    links:
+                      self: http://www.example.com/api/v2/platform/menu_items?page=1&per_page=&include=&filter=
+                      next: http://www.example.com/api/v2/platform/menu_items?include=&page=1&per_page=
+                      prev: http://www.example.com/api/v2/platform/menu_items?include=&page=1&per_page=
+                      last: http://www.example.com/api/v2/platform/menu_items?include=&page=1&per_page=
+                      first: http://www.example.com/api/v2/platform/menu_items?include=&page=1&per_page=
+        '401':
+          description: Authentication Failed
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: The access token is invalid
+    post:
+      summary: Creates a MenuItem
+      tags:
+      - MenuItems
+      security:
+      - bearer_auth: []
+      parameters:
+      - name: include
+        in: query
+        description: 'Select which associated resources you would like to fetch, see:
+          <a href="https://jsonapi.org/format/#fetching-includes">https://jsonapi.org/format/#fetching-includes</a>'
+        example: linked_resource
+        schema:
+          type: string
+      responses:
+        '201':
+          description: record created
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    data:
+                      id: '5'
+                      type: menu_item
+                      attributes:
+                        name: Link no. 18 To Somewhere
+                        subtitle:
+                        destination:
+                        new_window: false
+                        item_type: Link
+                        linked_resource_type: URL
+                        code:
+                        lft: 8
+                        rgt: 9
+                        depth: 1
+                        created_at: '2021-08-23T21:28:23.637Z'
+                        updated_at: '2021-08-23T21:28:23.639Z'
+                        link:
+                        is_container: false
+                        is_root: false
+                        is_child: true
+                        is_leaf: true
+                      relationships:
+                        icon:
+                          data:
+                        menu:
+                          data:
+                            id: '1'
+                            type: menu
+                        parent:
+                          data:
+                            id: '1'
+                            type: menu_item
+                        linked_resource:
+                          data:
+                        children:
+                          data: []
+        '422':
+          description: invalid request
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: Name can't be blank, Menu can't be blank, and Item type
+                      is not included in the list
+                    errors:
+                      name:
+                      - can't be blank
+                      menu:
+                      - can't be blank
+                      item_type:
+                      - is not included in the list
+      requestBody:
+        content:
+          application/json:
+            schema:
+              "$ref": "#/components/schemas/menu_items_params"
+  "/api/v2/platform/menu_items/{id}":
+    get:
+      summary: Returns a MenuItem
+      tags:
+      - MenuItems
+      security:
+      - bearer_auth: []
+      parameters:
+      - name: id
+        in: path
+        required: true
+        schema:
+          type: string
+      - name: include
+        in: query
+        description: 'Select which associated resources you would like to fetch, see:
+          <a href="https://jsonapi.org/format/#fetching-includes">https://jsonapi.org/format/#fetching-includes</a>'
+        example: linked_resource
+        schema:
+          type: string
+      responses:
+        '200':
+          description: Record found
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    data:
+                      id: '5'
+                      type: menu_item
+                      attributes:
+                        name: Link no. 25 To Somewhere
+                        subtitle:
+                        destination:
+                        new_window: false
+                        item_type: Link
+                        linked_resource_type: URL
+                        code:
+                        lft: 8
+                        rgt: 9
+                        depth: 1
+                        created_at: '2021-08-23T21:28:23.746Z'
+                        updated_at: '2021-08-23T21:28:23.748Z'
+                        link:
+                        is_container: false
+                        is_root: false
+                        is_child: true
+                        is_leaf: true
+                      relationships:
+                        icon:
+                          data:
+                            id: '4'
+                            type: icon
+                        menu:
+                          data:
+                            id: '1'
+                            type: menu
+                        parent:
+                          data:
+                            id: '1'
+                            type: menu_item
+                        linked_resource:
+                          data:
+                        children:
+                          data: []
+        '404':
+          description: Record not found
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: The resource you were looking for could not be found.
+        '401':
+          description: Authentication Failed
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: The access token is invalid
+    put:
+      summary: Updates a MenuItem
+      tags:
+      - MenuItems
+      security:
+      - bearer_auth: []
+      parameters:
+      - name: id
+        in: path
+        required: true
+        schema:
+          type: string
+      - name: include
+        in: query
+        description: 'Select which associated resources you would like to fetch, see:
+          <a href="https://jsonapi.org/format/#fetching-includes">https://jsonapi.org/format/#fetching-includes</a>'
+        example: linked_resource
+        schema:
+          type: string
+      responses:
+        '200':
+          description: record updated
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    data:
+                      id: '5'
+                      type: menu_item
+                      attributes:
+                        name: Menu Item One
+                        subtitle:
+                        destination:
+                        new_window: false
+                        item_type: Link
+                        linked_resource_type: URL
+                        code:
+                        lft: 8
+                        rgt: 9
+                        depth: 1
+                        created_at: '2021-08-23T21:28:23.926Z'
+                        updated_at: '2021-08-23T21:28:23.937Z'
+                        link:
+                        is_container: false
+                        is_root: false
+                        is_child: true
+                        is_leaf: true
+                      relationships:
+                        icon:
+                          data:
+                            id: '4'
+                            type: icon
+                        menu:
+                          data:
+                            id: '1'
+                            type: menu
+                        parent:
+                          data:
+                            id: '1'
+                            type: menu_item
+                        linked_resource:
+                          data:
+                        children:
+                          data: []
+        '422':
+          description: invalid request
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: Name can't be blank
+                    errors:
+                      name:
+                      - can't be blank
+        '404':
+          description: Record not found
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: The resource you were looking for could not be found.
+        '401':
+          description: Authentication Failed
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: The access token is invalid
+      requestBody:
+        content:
+          application/json:
+            schema:
+              "$ref": "#/components/schemas/menu_items_params"
+    delete:
+      summary: Deletes a MenuItem
+      tags:
+      - MenuItems
+      security:
+      - bearer_auth: []
+      parameters:
+      - name: id
+        in: path
+        required: true
+        schema:
+          type: string
+      responses:
+        '204':
+          description: Record deleted
+        '404':
+          description: Record not found
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: The resource you were looking for could not be found.
+        '401':
+          description: Authentication Failed
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: The access token is invalid
+  "/api/v2/platform/menu_items/{id}/reposition":
+    patch:
+      summary: Reposition a Menu Item
+      tags:
+      - MenuItems
+      security:
+      - bearer_auth: []
+      parameters:
+      - name: id
+        in: path
+        required: true
+        schema:
+          type: string
+      responses:
+        '200':
+          description: record updated
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    data:
+                      id: '5'
+                      type: menu_item
+                      attributes:
+                        name: Link no. 62 To Somewhere
+                        subtitle:
+                        destination:
+                        new_window: false
+                        item_type: Link
+                        linked_resource_type: URL
+                        code:
+                        lft: 5
+                        rgt: 6
+                        depth: 2
+                        created_at: '2021-08-23T21:28:24.309Z'
+                        updated_at: '2021-08-23T21:28:24.321Z'
+                        link:
+                        is_container: false
+                        is_root: false
+                        is_child: true
+                        is_leaf: true
+                      relationships:
+                        icon:
+                          data:
+                            id: '4'
+                            type: icon
+                        menu:
+                          data:
+                            id: '1'
+                            type: menu
+                        parent:
+                          data:
+                            id: '3'
+                            type: menu_item
+                        linked_resource:
+                          data:
+                        children:
+                          data: []
+        '404':
+          description: Record not found
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: The resource you were looking for could not be found.
+        '401':
+          description: Authentication Failed
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: The access token is invalid
+      requestBody:
+        content:
+          application/json:
+            schema:
+              "$ref": "#/components/schemas/menu_item_reposition_params"
+  "/api/v2/platform/menus":
+    get:
+      summary: Returns a list of Menus
+      tags:
+      - Menus
+      security:
+      - bearer_auth: []
+      parameters:
+      - name: page
+        in: query
+        example: 1
+        schema:
+          type: integer
+      - name: per_page
+        in: query
+        example: 50
+        schema:
+          type: integer
+      - name: include
+        in: query
+        description: 'Select which associated resources you would like to fetch, see:
+          <a href="https://jsonapi.org/format/#fetching-includes">https://jsonapi.org/format/#fetching-includes</a>'
+        example: menu_items
+        schema:
+          type: string
+      - name: filter
+        in: query
+        description: ''
+        example: location_eq=header
+        schema:
+          type: string
+      responses:
+        '200':
+          description: Records returned
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    data:
+                    - id: '1'
+                      type: menu
+                      attributes:
+                        name: Main Menu
+                        location: header
+                        locale: en
+                        created_at: '2021-08-23T21:28:24.436Z'
+                        updated_at: '2021-08-23T21:28:24.464Z'
+                      relationships:
+                        menu_items:
+                          data:
+                          - id: '1'
+                            type: menu_item
+                          - id: '3'
+                            type: menu_item
+                          - id: '4'
+                            type: menu_item
+                    - id: '2'
+                      type: menu
+                      attributes:
+                        name: Footer Menu
+                        location: footer
+                        locale: en
+                        created_at: '2021-08-23T21:28:24.440Z'
+                        updated_at: '2021-08-23T21:28:24.484Z'
+                      relationships:
+                        menu_items:
+                          data:
+                          - id: '2'
+                            type: menu_item
+                          - id: '5'
+                            type: menu_item
+                          - id: '6'
+                            type: menu_item
+                    meta:
+                      count: 2
+                      total_count: 2
+                      total_pages: 1
+                    links:
+                      self: http://www.example.com/api/v2/platform/menus?page=1&per_page=&include=&filter=
+                      next: http://www.example.com/api/v2/platform/menus?include=&page=1&per_page=
+                      prev: http://www.example.com/api/v2/platform/menus?include=&page=1&per_page=
+                      last: http://www.example.com/api/v2/platform/menus?include=&page=1&per_page=
+                      first: http://www.example.com/api/v2/platform/menus?include=&page=1&per_page=
+        '401':
+          description: Authentication Failed
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: The access token is invalid
+    post:
+      summary: Creates a Menu
+      tags:
+      - Menus
+      security:
+      - bearer_auth: []
+      parameters:
+      - name: include
+        in: query
+        description: 'Select which associated resources you would like to fetch, see:
+          <a href="https://jsonapi.org/format/#fetching-includes">https://jsonapi.org/format/#fetching-includes</a>'
+        example: menu_items
+        schema:
+          type: string
+      responses:
+        '201':
+          description: record created
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    data:
+                      id: '1'
+                      type: menu
+                      attributes:
+                        name: Main Menu
+                        location: header
+                        locale: en
+                        created_at: '2021-08-23T21:28:24.595Z'
+                        updated_at: '2021-08-23T21:28:24.598Z'
+                      relationships:
+                        menu_items:
+                          data:
+                          - id: '1'
+                            type: menu_item
+        '422':
+          description: invalid request
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: Name can't be blank, Locale can't be blank, and Location
+                      is not included in the list
+                    errors:
+                      name:
+                      - can't be blank
+                      locale:
+                      - can't be blank
+                      location:
+                      - is not included in the list
+      requestBody:
+        content:
+          application/json:
+            schema:
+              "$ref": "#/components/schemas/menus_params"
+  "/api/v2/platform/menus/{id}":
+    get:
+      summary: Returns a Menu
+      tags:
+      - Menus
+      security:
+      - bearer_auth: []
+      parameters:
+      - name: id
+        in: path
+        required: true
+        schema:
+          type: string
+      - name: include
+        in: query
+        description: 'Select which associated resources you would like to fetch, see:
+          <a href="https://jsonapi.org/format/#fetching-includes">https://jsonapi.org/format/#fetching-includes</a>'
+        example: menu_items
+        schema:
+          type: string
+      responses:
+        '200':
+          description: Record found
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    data:
+                      id: '1'
+                      type: menu
+                      attributes:
+                        name: Main Menu
+                        location: header
+                        locale: en
+                        created_at: '2021-08-23T21:28:24.622Z'
+                        updated_at: '2021-08-23T21:28:24.625Z'
+                      relationships:
+                        menu_items:
+                          data:
+                          - id: '1'
+                            type: menu_item
+        '404':
+          description: Record not found
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: The resource you were looking for could not be found.
+        '401':
+          description: Authentication Failed
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: The access token is invalid
+    put:
+      summary: Updates a Menu
+      tags:
+      - Menus
+      security:
+      - bearer_auth: []
+      parameters:
+      - name: id
+        in: path
+        required: true
+        schema:
+          type: string
+      - name: include
+        in: query
+        description: 'Select which associated resources you would like to fetch, see:
+          <a href="https://jsonapi.org/format/#fetching-includes">https://jsonapi.org/format/#fetching-includes</a>'
+        example: menu_items
+        schema:
+          type: string
+      responses:
+        '200':
+          description: record updated
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    data:
+                      id: '1'
+                      type: menu
+                      attributes:
+                        name: Main Menu
+                        location: header
+                        locale: en
+                        created_at: '2021-08-23T21:28:24.664Z'
+                        updated_at: '2021-08-23T21:28:24.667Z'
+                      relationships:
+                        menu_items:
+                          data:
+                          - id: '1'
+                            type: menu_item
+        '422':
+          description: invalid request
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: Name can't be blank, Locale can't be blank, and Location
+                      is not included in the list
+                    errors:
+                      name:
+                      - can't be blank
+                      locale:
+                      - can't be blank
+                      location:
+                      - is not included in the list
+        '404':
+          description: Record not found
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: The resource you were looking for could not be found.
+        '401':
+          description: Authentication Failed
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: The access token is invalid
+      requestBody:
+        content:
+          application/json:
+            schema:
+              "$ref": "#/components/schemas/menus_params"
+    delete:
+      summary: Deletes a Menu
+      tags:
+      - Menus
+      security:
+      - bearer_auth: []
+      parameters:
+      - name: id
+        in: path
+        required: true
+        schema:
+          type: string
+      responses:
+        '204':
+          description: Record deleted
+        '404':
+          description: Record not found
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: The resource you were looking for could not be found.
+        '401':
+          description: Authentication Failed
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: The access token is invalid
+  "/api/v2/platform/option_types":
+    get:
+      summary: Returns a list of OptionTypes
+      tags:
+      - OptionTypes
+      security:
+      - bearer_auth: []
+      parameters:
+      - name: page
+        in: query
+        example: 1
+        schema:
+          type: integer
+      - name: per_page
+        in: query
+        example: 50
+        schema:
+          type: integer
+      - name: include
+        in: query
+        description: 'Select which associated resources you would like to fetch, see:
+          <a href="https://jsonapi.org/format/#fetching-includes">https://jsonapi.org/format/#fetching-includes</a>'
+        example: ''
+        schema:
+          type: string
+      - name: filter
+        in: query
+        description: ''
+        example: option_type_id_eq=1&name_cont=Size
+        schema:
+          type: string
+      responses:
+        '200':
+          description: Records returned
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    data:
+                    - id: '1'
+                      type: option_type
+                      attributes:
+                        name: foo-size-1
+                        presentation: Size
+                        position: 1
+                        created_at: '2021-08-23T21:28:24.774Z'
+                        updated_at: '2021-08-23T21:28:24.774Z'
+                        filterable: true
+                      relationships:
+                        option_values:
+                          data: []
+                    - id: '2'
+                      type: option_type
+                      attributes:
+                        name: foo-size-2
+                        presentation: Size
+                        position: 2
+                        created_at: '2021-08-23T21:28:24.775Z'
+                        updated_at: '2021-08-23T21:28:24.775Z'
+                        filterable: true
+                      relationships:
+                        option_values:
+                          data: []
+                    meta:
+                      count: 2
+                      total_count: 2
+                      total_pages: 1
+                    links:
+                      self: http://www.example.com/api/v2/platform/option_types?page=1&per_page=&include=&filter=
+                      next: http://www.example.com/api/v2/platform/option_types?include=&page=1&per_page=
+                      prev: http://www.example.com/api/v2/platform/option_types?include=&page=1&per_page=
+                      last: http://www.example.com/api/v2/platform/option_types?include=&page=1&per_page=
+                      first: http://www.example.com/api/v2/platform/option_types?include=&page=1&per_page=
+        '401':
+          description: Authentication Failed
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: The access token is invalid
+    post:
+      summary: Creates an OptionType
+      tags:
+      - OptionTypes
+      security:
+      - bearer_auth: []
+      parameters:
+      - name: include
+        in: query
+        description: 'Select which associated resources you would like to fetch, see:
+          <a href="https://jsonapi.org/format/#fetching-includes">https://jsonapi.org/format/#fetching-includes</a>'
+        example: ''
+        schema:
+          type: string
+      responses:
+        '201':
+          description: record created
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    data:
+                      id: '1'
+                      type: option_type
+                      attributes:
+                        name: foo-size-5
+                        presentation: Size
+                        position: 1
+                        created_at: '2021-08-23T21:28:24.807Z'
+                        updated_at: '2021-08-23T21:28:24.807Z'
+                        filterable: true
+                      relationships:
+                        option_values:
+                          data: []
+        '422':
+          description: invalid request
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: Name can't be blank and Presentation can't be blank
+                    errors:
+                      name:
+                      - can't be blank
+                      presentation:
+                      - can't be blank
+      requestBody:
+        content:
+          application/json:
+            schema:
+              "$ref": "#/components/schemas/option_types_params"
+  "/api/v2/platform/option_types/{id}":
+    get:
+      summary: Returns an OptionType
+      tags:
+      - OptionTypes
+      security:
+      - bearer_auth: []
+      parameters:
+      - name: id
+        in: path
+        required: true
+        schema:
+          type: string
+      - name: include
+        in: query
+        description: 'Select which associated resources you would like to fetch, see:
+          <a href="https://jsonapi.org/format/#fetching-includes">https://jsonapi.org/format/#fetching-includes</a>'
+        example: ''
+        schema:
+          type: string
+      responses:
+        '200':
+          description: Record found
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    data:
+                      id: '1'
+                      type: option_type
+                      attributes:
+                        name: foo-size-6
+                        presentation: Size
+                        position: 1
+                        created_at: '2021-08-23T21:28:24.829Z'
+                        updated_at: '2021-08-23T21:28:24.829Z'
+                        filterable: true
+                      relationships:
+                        option_values:
+                          data: []
+        '404':
+          description: Record not found
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: The resource you were looking for could not be found.
+        '401':
+          description: Authentication Failed
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: The access token is invalid
+    put:
+      summary: Updates an OptionType
+      tags:
+      - OptionTypes
+      security:
+      - bearer_auth: []
+      parameters:
+      - name: id
+        in: path
+        required: true
+        schema:
+          type: string
+      - name: include
+        in: query
+        description: 'Select which associated resources you would like to fetch, see:
+          <a href="https://jsonapi.org/format/#fetching-includes">https://jsonapi.org/format/#fetching-includes</a>'
+        example: ''
+        schema:
+          type: string
+      responses:
+        '200':
+          description: record updated
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    data:
+                      id: '1'
+                      type: option_type
+                      attributes:
+                        name: Size-X
+                        presentation: Size
+                        position: 1
+                        created_at: '2021-08-23T21:28:24.867Z'
+                        updated_at: '2021-08-23T21:28:24.871Z'
+                        filterable: true
+                      relationships:
+                        option_values:
+                          data: []
+        '422':
+          description: invalid request
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: Name can't be blank
+                    errors:
+                      name:
+                      - can't be blank
+        '404':
+          description: Record not found
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: The resource you were looking for could not be found.
+        '401':
+          description: Authentication Failed
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: The access token is invalid
+      requestBody:
+        content:
+          application/json:
+            schema:
+              "$ref": "#/components/schemas/option_types_params"
+    delete:
+      summary: Deletes an OptionType
+      tags:
+      - OptionTypes
+      security:
+      - bearer_auth: []
+      parameters:
+      - name: id
+        in: path
+        required: true
+        schema:
+          type: string
+      responses:
+        '204':
+          description: Record deleted
+        '404':
+          description: Record not found
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: The resource you were looking for could not be found.
+        '401':
+          description: Authentication Failed
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: The access token is invalid
+  "/api/v2/platform/option_values":
+    get:
+      summary: Returns a list of OptionValues
+      tags:
+      - OptionValues
+      security:
+      - bearer_auth: []
+      parameters:
+      - name: page
+        in: query
+        example: 1
+        schema:
+          type: integer
+      - name: per_page
+        in: query
+        example: 50
+        schema:
+          type: integer
+      - name: include
+        in: query
+        description: 'Select which associated resources you would like to fetch, see:
+          <a href="https://jsonapi.org/format/#fetching-includes">https://jsonapi.org/format/#fetching-includes</a>'
+        example: option_type
+        schema:
+          type: string
+      - name: filter
+        in: query
+        description: ''
+        example: option_type_id_eq=1&name_cont=M
+        schema:
+          type: string
+      responses:
+        '200':
+          description: Records returned
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    data:
+                    - id: '1'
+                      type: option_value
+                      attributes:
+                        position: 1
+                        name: Size-1
+                        presentation: S
+                        created_at: '2021-08-23T21:28:24.950Z'
+                        updated_at: '2021-08-23T21:28:24.950Z'
+                      relationships:
+                        option_type:
+                          data:
+                            id: '1'
+                            type: option_type
+                    - id: '2'
+                      type: option_value
+                      attributes:
+                        position: 1
+                        name: Size-2
+                        presentation: S
+                        created_at: '2021-08-23T21:28:24.952Z'
+                        updated_at: '2021-08-23T21:28:24.952Z'
+                      relationships:
+                        option_type:
+                          data:
+                            id: '2'
+                            type: option_type
+                    meta:
+                      count: 2
+                      total_count: 2
+                      total_pages: 1
+                    links:
+                      self: http://www.example.com/api/v2/platform/option_values?page=1&per_page=&include=&filter=
+                      next: http://www.example.com/api/v2/platform/option_values?include=&page=1&per_page=
+                      prev: http://www.example.com/api/v2/platform/option_values?include=&page=1&per_page=
+                      last: http://www.example.com/api/v2/platform/option_values?include=&page=1&per_page=
+                      first: http://www.example.com/api/v2/platform/option_values?include=&page=1&per_page=
+        '401':
+          description: Authentication Failed
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: The access token is invalid
+    post:
+      summary: Creates an OptionValue
+      tags:
+      - OptionValues
+      security:
+      - bearer_auth: []
+      parameters:
+      - name: include
+        in: query
+        description: 'Select which associated resources you would like to fetch, see:
+          <a href="https://jsonapi.org/format/#fetching-includes">https://jsonapi.org/format/#fetching-includes</a>'
+        example: option_type
+        schema:
+          type: string
+      responses:
+        '201':
+          description: record created
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    data:
+                      id: '1'
+                      type: option_value
+                      attributes:
+                        position: 1
+                        name: Size-5
+                        presentation: S
+                        created_at: '2021-08-23T21:28:24.988Z'
+                        updated_at: '2021-08-23T21:28:24.988Z'
+                      relationships:
+                        option_type:
+                          data:
+        '422':
+          description: invalid request
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: Name can't be blank and Presentation can't be blank
+                    errors:
+                      name:
+                      - can't be blank
+                      presentation:
+                      - can't be blank
+      requestBody:
+        content:
+          application/json:
+            schema:
+              "$ref": "#/components/schemas/option_values_params"
+  "/api/v2/platform/option_values/{id}":
+    get:
+      summary: Returns an OptionValue
+      tags:
+      - OptionValues
+      security:
+      - bearer_auth: []
+      parameters:
+      - name: id
+        in: path
+        required: true
+        schema:
+          type: string
+      - name: include
+        in: query
+        description: 'Select which associated resources you would like to fetch, see:
+          <a href="https://jsonapi.org/format/#fetching-includes">https://jsonapi.org/format/#fetching-includes</a>'
+        example: option_type
+        schema:
+          type: string
+      responses:
+        '200':
+          description: Record found
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    data:
+                      id: '1'
+                      type: option_value
+                      attributes:
+                        position: 1
+                        name: Size-6
+                        presentation: S
+                        created_at: '2021-08-23T21:28:25.015Z'
+                        updated_at: '2021-08-23T21:28:25.015Z'
+                      relationships:
+                        option_type:
+                          data:
+                            id: '1'
+                            type: option_type
+        '404':
+          description: Record not found
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: The resource you were looking for could not be found.
+        '401':
+          description: Authentication Failed
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: The access token is invalid
+    put:
+      summary: Updates an OptionValue
+      tags:
+      - OptionValues
+      security:
+      - bearer_auth: []
+      parameters:
+      - name: id
+        in: path
+        required: true
+        schema:
+          type: string
+      - name: include
+        in: query
+        description: 'Select which associated resources you would like to fetch, see:
+          <a href="https://jsonapi.org/format/#fetching-includes">https://jsonapi.org/format/#fetching-includes</a>'
+        example: option_type
+        schema:
+          type: string
+      responses:
+        '200':
+          description: record updated
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    data:
+                      id: '1'
+                      type: option_value
+                      attributes:
+                        position: 1
+                        name: M
+                        presentation: S
+                        created_at: '2021-08-23T21:28:25.052Z'
+                        updated_at: '2021-08-23T21:28:25.056Z'
+                      relationships:
+                        option_type:
+                          data:
+                            id: '1'
+                            type: option_type
+        '422':
+          description: invalid request
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: Name can't be blank
+                    errors:
+                      name:
+                      - can't be blank
+        '404':
+          description: Record not found
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: The resource you were looking for could not be found.
+        '401':
+          description: Authentication Failed
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: The access token is invalid
+      requestBody:
+        content:
+          application/json:
+            schema:
+              "$ref": "#/components/schemas/option_values_params"
+    delete:
+      summary: Deletes an OptionValue
+      tags:
+      - OptionValues
+      security:
+      - bearer_auth: []
+      parameters:
+      - name: id
+        in: path
+        required: true
+        schema:
+          type: string
+      responses:
+        '204':
+          description: Record deleted
+        '404':
+          description: Record not found
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: The resource you were looking for could not be found.
+        '401':
+          description: Authentication Failed
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: The access token is invalid
+  "/api/v2/platform/taxons":
+    get:
+      summary: Returns a list of Taxons
+      tags:
+      - Taxons
+      security:
+      - bearer_auth: []
+      parameters:
+      - name: page
+        in: query
+        example: 1
+        schema:
+          type: integer
+      - name: per_page
+        in: query
+        example: 50
+        schema:
+          type: integer
+      - name: include
+        in: query
+        description: 'Select which associated resources you would like to fetch, see:
+          <a href="https://jsonapi.org/format/#fetching-includes">https://jsonapi.org/format/#fetching-includes</a>'
+        example: taxonomy,parent,children
+        schema:
+          type: string
+      - name: filter
+        in: query
+        description: ''
+        example: taxonomy_id_eq=1&name_cont=Shirts
+        schema:
+          type: string
+      responses:
+        '200':
+          description: Records returned
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    data:
+                    - id: '1'
+                      type: taxon
+                      attributes:
+                        position: 0
+                        name: taxonomy_16
+                        permalink: taxonomy-16
+                        lft: 1
+                        rgt: 6
+                        description:
+                        created_at: '2021-08-23T21:28:25.145Z'
+                        updated_at: '2021-08-23T21:28:25.172Z'
+                        meta_title:
+                        meta_description:
+                        meta_keywords:
+                        depth: 0
+                        pretty_name: taxonomy_16
+                        seo_title: taxonomy_16
+                        is_root: true
+                        is_child: false
+                        is_leaf: false
+                      relationships:
+                        parent:
+                          data:
+                        taxonomy:
+                          data:
+                            id: '1'
+                            type: taxonomy
+                        children:
+                          data:
+                          - id: '2'
+                            type: taxon
+                          - id: '3'
+                            type: taxon
+                        image:
+                          data:
+                    - id: '2'
+                      type: taxon
+                      attributes:
+                        position: 0
+                        name: taxon_16
+                        permalink: taxonomy-16/taxon-16
+                        lft: 2
+                        rgt: 3
+                        description:
+                        created_at: '2021-08-23T21:28:25.156Z'
+                        updated_at: '2021-08-23T21:28:25.157Z'
+                        meta_title:
+                        meta_description:
+                        meta_keywords:
+                        depth: 1
+                        pretty_name: taxonomy_16 -> taxon_16
+                        seo_title: taxon_16
+                        is_root: false
+                        is_child: true
+                        is_leaf: true
+                      relationships:
+                        parent:
+                          data:
+                            id: '1'
+                            type: taxon
+                        taxonomy:
+                          data:
+                            id: '1'
+                            type: taxonomy
+                        children:
+                          data: []
+                        image:
+                          data:
+                            id: '1'
+                            type: taxon_image
+                    - id: '3'
+                      type: taxon
+                      attributes:
+                        position: 0
+                        name: taxon_17
+                        permalink: taxonomy-16/taxon-17
+                        lft: 4
+                        rgt: 5
+                        description:
+                        created_at: '2021-08-23T21:28:25.167Z'
+                        updated_at: '2021-08-23T21:28:25.168Z'
+                        meta_title:
+                        meta_description:
+                        meta_keywords:
+                        depth: 1
+                        pretty_name: taxonomy_16 -> taxon_17
+                        seo_title: taxon_17
+                        is_root: false
+                        is_child: true
+                        is_leaf: true
+                      relationships:
+                        parent:
+                          data:
+                            id: '1'
+                            type: taxon
+                        taxonomy:
+                          data:
+                            id: '1'
+                            type: taxonomy
+                        children:
+                          data: []
+                        image:
+                          data:
+                            id: '2'
+                            type: taxon_image
+                    meta:
+                      count: 3
+                      total_count: 3
+                      total_pages: 1
+                    links:
+                      self: http://www.example.com/api/v2/platform/taxons?page=1&per_page=&include=&filter=
+                      next: http://www.example.com/api/v2/platform/taxons?include=&page=1&per_page=
+                      prev: http://www.example.com/api/v2/platform/taxons?include=&page=1&per_page=
+                      last: http://www.example.com/api/v2/platform/taxons?include=&page=1&per_page=
+                      first: http://www.example.com/api/v2/platform/taxons?include=&page=1&per_page=
+        '401':
+          description: Authentication Failed
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: The access token is invalid
+    post:
+      summary: Creates a Taxon
+      tags:
+      - Taxons
+      security:
+      - bearer_auth: []
+      parameters:
+      - name: include
+        in: query
+        description: 'Select which associated resources you would like to fetch, see:
+          <a href="https://jsonapi.org/format/#fetching-includes">https://jsonapi.org/format/#fetching-includes</a>'
+        example: taxonomy,parent,children
+        schema:
+          type: string
+      responses:
+        '201':
+          description: record created
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    data:
+                      id: '2'
+                      type: taxon
+                      attributes:
+                        position: 0
+                        name: taxon_20
+                        permalink: taxonomy-18/taxon-20
+                        lft: 2
+                        rgt: 3
+                        description:
+                        created_at: '2021-08-23T21:28:25.251Z'
+                        updated_at: '2021-08-23T21:28:25.254Z'
+                        meta_title:
+                        meta_description:
+                        meta_keywords:
+                        depth: 1
+                        pretty_name: taxonomy_18 -> taxon_20
+                        seo_title: taxon_20
+                        is_root: false
+                        is_child: true
+                        is_leaf: true
+                      relationships:
+                        parent:
+                          data:
+                            id: '1'
+                            type: taxon
+                        taxonomy:
+                          data:
+                            id: '1'
+                            type: taxonomy
+                        children:
+                          data: []
+                        image:
+                          data:
+        '422':
+          description: invalid request
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: Name can't be blank and Taxonomy can't be blank
+                    errors:
+                      name:
+                      - can't be blank
+                      taxonomy:
+                      - can't be blank
+      requestBody:
+        content:
+          application/json:
+            schema:
+              "$ref": "#/components/schemas/taxons_params"
+  "/api/v2/platform/taxons/{id}":
+    get:
+      summary: Returns a Taxon
+      tags:
+      - Taxons
+      security:
+      - bearer_auth: []
+      parameters:
+      - name: id
+        in: path
+        required: true
+        schema:
+          type: string
+      - name: include
+        in: query
+        description: 'Select which associated resources you would like to fetch, see:
+          <a href="https://jsonapi.org/format/#fetching-includes">https://jsonapi.org/format/#fetching-includes</a>'
+        example: taxonomy,parent,children
+        schema:
+          type: string
+      responses:
+        '200':
+          description: Record found
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    data:
+                      id: '2'
+                      type: taxon
+                      attributes:
+                        position: 0
+                        name: taxon_21
+                        permalink: taxonomy-19/taxon-21
+                        lft: 2
+                        rgt: 3
+                        description:
+                        created_at: '2021-08-23T21:28:25.291Z'
+                        updated_at: '2021-08-23T21:28:25.293Z'
+                        meta_title:
+                        meta_description:
+                        meta_keywords:
+                        depth: 1
+                        pretty_name: taxonomy_19 -> taxon_21
+                        seo_title: taxon_21
+                        is_root: false
+                        is_child: true
+                        is_leaf: true
+                      relationships:
+                        parent:
+                          data:
+                            id: '1'
+                            type: taxon
+                        taxonomy:
+                          data:
+                            id: '1'
+                            type: taxonomy
+                        children:
+                          data: []
+                        products:
+                          data: []
+                        image:
+                          data:
+                            id: '1'
+                            type: taxon_image
+        '404':
+          description: Record not found
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: The resource you were looking for could not be found.
+        '401':
+          description: Authentication Failed
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: The access token is invalid
+    put:
+      summary: Updates a Taxon
+      tags:
+      - Taxons
+      security:
+      - bearer_auth: []
+      parameters:
+      - name: id
+        in: path
+        required: true
+        schema:
+          type: string
+      - name: include
+        in: query
+        description: 'Select which associated resources you would like to fetch, see:
+          <a href="https://jsonapi.org/format/#fetching-includes">https://jsonapi.org/format/#fetching-includes</a>'
+        example: taxonomy,parent,children
+        schema:
+          type: string
+      responses:
+        '200':
+          description: record updated
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    data:
+                      id: '2'
+                      type: taxon
+                      attributes:
+                        position: 0
+                        name: T-Shirts
+                        permalink: taxonomy-21/taxon-23
+                        lft: 2
+                        rgt: 3
+                        description:
+                        created_at: '2021-08-23T21:28:25.371Z'
+                        updated_at: '2021-08-23T21:28:25.383Z'
+                        meta_title:
+                        meta_description:
+                        meta_keywords:
+                        depth: 1
+                        pretty_name: taxonomy_21 -> T-Shirts
+                        seo_title: T-Shirts
+                        is_root: false
+                        is_child: true
+                        is_leaf: true
+                      relationships:
+                        parent:
+                          data:
+                            id: '1'
+                            type: taxon
+                        taxonomy:
+                          data:
+                            id: '1'
+                            type: taxonomy
+                        children:
+                          data: []
+                        image:
+                          data:
+                            id: '1'
+                            type: taxon_image
+        '422':
+          description: invalid request
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: Name can't be blank
+                    errors:
+                      name:
+                      - can't be blank
+        '404':
+          description: Record not found
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: The resource you were looking for could not be found.
+        '401':
+          description: Authentication Failed
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: The access token is invalid
+      requestBody:
+        content:
+          application/json:
+            schema:
+              "$ref": "#/components/schemas/taxons_params"
+    delete:
+      summary: Deletes a Taxon
+      tags:
+      - Taxons
+      security:
+      - bearer_auth: []
+      parameters:
+      - name: id
+        in: path
+        required: true
+        schema:
+          type: string
+      responses:
+        '204':
+          description: Record deleted
+        '404':
+          description: Record not found
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: The resource you were looking for could not be found.
+        '401':
+          description: Authentication Failed
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: The access token is invalid
+  "/api/v2/platform/users":
+    get:
+      summary: Returns a list of Users
+      tags:
+      - Users
+      security:
+      - bearer_auth: []
+      parameters:
+      - name: page
+        in: query
+        example: 1
+        schema:
+          type: integer
+      - name: per_page
+        in: query
+        example: 50
+        schema:
+          type: integer
+      - name: include
+        in: query
+        description: 'Select which associated resources you would like to fetch, see:
+          <a href="https://jsonapi.org/format/#fetching-includes">https://jsonapi.org/format/#fetching-includes</a>'
+        example: ship_address,bill_address
+        schema:
+          type: string
+      - name: filter
+        in: query
+        description: ''
+        example: user_id_eq=1&email_cont=spree@example.com
+        schema:
+          type: string
+      responses:
+        '200':
+          description: Records returned
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    data:
+                    - id: '1'
+                      type: user
+                      attributes:
+                        email: vernetta@huels.co.uk
+                        created_at: '2021-08-23T21:28:25.546Z'
+                        updated_at: '2021-08-23T21:28:25.546Z'
+                        average_order_value: []
+                        lifetime_value: []
+                        store_credits: []
+                      relationships:
+                        bill_address:
+                          data:
+                        ship_address:
+                          data:
+                    - id: '2'
+                      type: user
+                      attributes:
+                        email: pansy_hirthe@smitham.us
+                        created_at: '2021-08-23T21:28:25.549Z'
+                        updated_at: '2021-08-23T21:28:25.549Z'
+                        average_order_value: []
+                        lifetime_value: []
+                        store_credits: []
+                      relationships:
+                        bill_address:
+                          data:
+                        ship_address:
+                          data:
+                    - id: '3'
+                      type: user
+                      attributes:
+                        email: carmen.kerluke@kossschulist.com
+                        created_at: '2021-08-23T21:28:25.550Z'
+                        updated_at: '2021-08-23T21:28:25.550Z'
+                        average_order_value: []
+                        lifetime_value: []
+                        store_credits: []
+                      relationships:
+                        bill_address:
+                          data:
+                        ship_address:
+                          data:
+                    meta:
+                      count: 3
+                      total_count: 3
+                      total_pages: 1
+                    links:
+                      self: http://www.example.com/api/v2/platform/users?page=1&per_page=&include=&filter=
+                      next: http://www.example.com/api/v2/platform/users?include=&page=1&per_page=
+                      prev: http://www.example.com/api/v2/platform/users?include=&page=1&per_page=
+                      last: http://www.example.com/api/v2/platform/users?include=&page=1&per_page=
+                      first: http://www.example.com/api/v2/platform/users?include=&page=1&per_page=
+        '401':
+          description: Authentication Failed
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: The access token is invalid
+    post:
+      summary: Creates an User
+      tags:
+      - Users
+      security:
+      - bearer_auth: []
+      parameters:
+      - name: include
+        in: query
+        description: 'Select which associated resources you would like to fetch, see:
+          <a href="https://jsonapi.org/format/#fetching-includes">https://jsonapi.org/format/#fetching-includes</a>'
+        example: ship_address,bill_address
+        schema:
+          type: string
+      responses:
+        '201':
+          description: record created
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    data:
+                      id: '2'
+                      type: user
+                      attributes:
+                        email: marx_feil@borer.info
+                        created_at: '2021-08-23T21:28:25.597Z'
+                        updated_at: '2021-08-23T21:28:25.597Z'
+                        average_order_value: []
+                        lifetime_value: []
+                        store_credits: []
+                      relationships:
+                        bill_address:
+                          data:
+                        ship_address:
+                          data:
+        '422':
+          description: invalid request
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: Bill address belongs to other user
+                    errors:
+                      bill_address_id:
+                      - belongs to other user
+      requestBody:
+        content:
+          application/json:
+            schema:
+              "$ref": "#/components/schemas/users_params"
+  "/api/v2/platform/users/{id}":
+    get:
+      summary: Returns an User
+      tags:
+      - Users
+      security:
+      - bearer_auth: []
+      parameters:
+      - name: id
+        in: path
+        required: true
+        schema:
+          type: string
+      - name: include
+        in: query
+        description: 'Select which associated resources you would like to fetch, see:
+          <a href="https://jsonapi.org/format/#fetching-includes">https://jsonapi.org/format/#fetching-includes</a>'
+        example: ship_address,bill_address
+        schema:
+          type: string
+      responses:
+        '200':
+          description: Record found
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    data:
+                      id: '2'
+                      type: user
+                      attributes:
+                        email: stefany@leannon.biz
+                        created_at: '2021-08-23T21:28:25.626Z'
+                        updated_at: '2021-08-23T21:28:25.626Z'
+                        average_order_value: []
+                        lifetime_value: []
+                        store_credits: []
+                      relationships:
+                        bill_address:
+                          data:
+                        ship_address:
+                          data:
+        '404':
+          description: Record not found
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: The resource you were looking for could not be found.
+        '401':
+          description: Authentication Failed
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: The access token is invalid
+    put:
+      summary: Updates an User
+      tags:
+      - Users
+      security:
+      - bearer_auth: []
+      parameters:
+      - name: id
+        in: path
+        required: true
+        schema:
+          type: string
+      - name: include
+        in: query
+        description: 'Select which associated resources you would like to fetch, see:
+          <a href="https://jsonapi.org/format/#fetching-includes">https://jsonapi.org/format/#fetching-includes</a>'
+        example: ship_address,bill_address
+        schema:
+          type: string
+      responses:
+        '200':
+          description: record updated
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    data:
+                      id: '2'
+                      type: user
+                      attributes:
+                        email: john@example.com
+                        created_at: '2021-08-23T21:28:25.669Z'
+                        updated_at: '2021-08-23T21:28:25.673Z'
+                        average_order_value: []
+                        lifetime_value: []
+                        store_credits: []
+                      relationships:
+                        bill_address:
+                          data:
+                        ship_address:
+                          data:
+        '422':
+          description: invalid request
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: Bill address belongs to other user
+                    errors:
+                      bill_address_id:
+                      - belongs to other user
+        '404':
+          description: Record not found
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: The resource you were looking for could not be found.
+        '401':
+          description: Authentication Failed
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: The access token is invalid
+      requestBody:
+        content:
+          application/json:
+            schema:
+              "$ref": "#/components/schemas/users_params"
+    delete:
+      summary: Deletes an User
+      tags:
+      - Users
+      security:
+      - bearer_auth: []
+      parameters:
+      - name: id
+        in: path
+        required: true
+        schema:
+          type: string
+      responses:
+        '204':
+          description: Record deleted
+        '404':
+          description: Record not found
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: The resource you were looking for could not be found.
+        '401':
+          description: Authentication Failed
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: The access token is invalid
+servers:
+- url: https://{defaultHost}
+  variables:
+    defaultHost:
+      default: localhost:3000
+components:
+  securitySchemes:
+    bearer_auth:
+      type: http
+      scheme: bearer
+  schemas:
+    address_params:
+      type: object
+      properties:
+        country_id:
+          type: string
+        state_id:
+          type: string
+        state_name:
+          type: string
+        address1:
+          type: string
+        city:
+          type: string
+        zipcode:
+          type: string
+        phone:
+          type: string
+        alternative_phone:
+          type: string
+        firstname:
+          type: string
+        lastname:
+          type: string
+        label:
+          type: string
+        company:
+          type: string
+        user_id:
+          type: string
+    classification_params:
+      type: object
+      properties:
+        product_id:
+          type: string
+        taxon_id:
+          type: string
+        position:
+          type: integer
+    option_type_params:
+      type: object
+      properties:
+        name:
+          type: string
+        presentation:
+          type: string
+      required:
+      - name
+      - presentation
+    option_value_params:
+      type: object
+      properties:
+        name:
+          type: string
+        presentation:
+          type: string
+        option_values_attributes:
+          type: string
+      required:
+      - name
+      - presentation
+    product_params:
+      type: object
+      properties:
+        name:
+          type: string
+        description:
+          type: string
+        available_on:
+          type: string
+        discontinue_on:
+          type: string
+        permalink:
+          type: string
+        meta_description:
+          type: string
+        meta_keywords:
+          type: string
+        price:
+          type: string
+        sku:
+          type: string
+        deleted_at:
+          type: string
+        prototype_id:
+          type: string
+        option_values_hash:
+          type: string
+        weight:
+          type: string
+        height:
+          type: string
+        width:
+          type: string
+        depth:
+          type: string
+        shipping_category_id:
+          type: string
+        tax_category_id:
+          type: string
+        cost_currency:
+          type: string
+        cost_price:
+          type: string
+        compare_at_price:
+          type: string
+        option_type_ids:
+          type: string
+        taxon_ids:
+          type: string
+      required:
+      - name
+      - price
+      - shipping_category_id
+    user_params:
+      type: object
+      properties:
+        email:
+          type: string
+        password:
+          type: string
+        password_confirmation:
+          type: string
+        ship_address_id:
+          type: string
+        bill_address_id:
+          type: string
+      required:
+      - email
+      - password
+      - password_confirmation
+    taxon_params:
+      type: object
+      properties:
+        taxonomy_id:
+          type: string
+        parent_id:
+          type: string
+        name:
+          type: string
+      required:
+      - name
+      - taxonomy_id
+    menu_params:
+      type: object
+      properties:
+        name:
+          type: string
+        location:
+          type: string
+        locale:
+          type: string
+      required:
+      - name
+      - location
+      - locale
+    menu_item_params:
+      type: object
+      properties:
+        name:
+          type: string
+        code:
+          type: string
+        subtitle:
+          type: string
+        destination:
+          type: string
+        new_window:
+          type: boolean
+        item_type:
+          type: string
+        linked_resource_type:
+          type: string
+        linked_resource_id:
+          type: integer
+      required:
+      - name
+    menu_item_reposition_params:
+      type: object
+      properties:
+        new_parent_id:
+          type: integer
+        new_position_idx:
+          type: integer
+      required:
+      - name
+    resources_list:
+      type: object
+      properties:
+        data:
+          type: array
+          items:
+            allOf:
+            - "$ref": "#/components/schemas/resource_properties"
+        meta:
+          type: object
+          properties:
+            count:
+              type: integer
+            total_count:
+              type: integer
+            total_pages:
+              type: integer
+          required:
+          - count
+          - total_count
+          - total_pages
+        links:
+          type: object
+          properties:
+            self:
+              type: string
+            next:
+              type: string
+            prev:
+              type: string
+            last:
+              type: string
+            first:
+              type: string
+          required:
+          - self
+          - next
+          - prev
+          - last
+          - first
+      required:
+      - data
+      - meta
+      - links
+    resource_properties:
+      type: object
+      properties:
+        id:
+          type: string
+        type:
+          type: string
+        attributes:
+          type: object
+        relationships:
+          type: object
+      required:
+      - id
+      - type
+      - attributes
+      - relationships
+    resource:
+      type: object
+      properties:
+        data:
+          "$ref": "#/components/schemas/resource_properties"
+      required:
+      - data
+    error:
+      type: object
+      properties:
+        error:
+          type: string
+      required:
+      - error
+    validation_errors:
+      type: object
+      properties:
+        error:
+          type: string
+        errors:
+          type: object
+      required:
+      - error
+      - errors