class ApiSpec::Spec

  endpoint 'Page Attachments' do |pa|

    pa.method('Index') do |method|
      method.synopsis = "Returns a list of a page's file attachments"
      method.http_method = "GET"
      method.uri = "/sites/:site_slug/pages/:page_slug/attachments"

      method.parameter('site_slug') do |p|
        p.required = 'Y'
        p.type = 'string'
        p.description = 'The slug of the site the page lives on'
      end

      method.parameter('page_slug') do |p|
        p.required = 'Y'
        p.default = '1'
        p.type = 'string'
        p.description = 'The page\'s slug'
      end

      method.parameter('__token') do |p|
        p.required = 'N'
        p.type = 'string'
        p.description = 'pagination token'
      end

      method.parameter('__nonce') do |p|
        p.required = 'N'
        p.type = 'string'
        p.description = 'pagination nonce'
      end

      method.parameter('limit') do |p|
        p.required = 'N'
        p.default = '10'
        p.type = 'int'
        p.description = 'maximum number of results to return'
      end
    end

    pa.method('Show') do |method|
      method.synopsis = "Creates a new file attachment for a page"
      method.http_method = "GET"
      method.uri = "/sites/:site_slug/pages/:page_slug/attachments/:id"

      method.parameter('site_slug') do |p|
        p.required = 'Y'
        p.type = 'string'
        p.description = 'The slug of the site the page lives on'
      end

      method.parameter('page_slug') do |p|
        p.required = 'Y'
        p.default = '1'
        p.type = 'string'
        p.description = 'The page\'s slug'
      end

      method.parameter('id') do |p|
        p.required = 'Y'
        p.type = 'int'
        p.description = 'The ID of the page attachment'
      end
    end

    pa.method('Create') do |method|
      method.synopsis = "Creates a new file attachment for a page"
      method.http_method = "POST"
      method.uri = "/sites/:site_slug/pages/:page_slug/attachments"

      method.parameter('site_slug') do |p|
        p.required = 'Y'
        p.type = 'string'
        p.description = 'The slug of the site the page lives on'
      end

      method.parameter('page_slug') do |p|
        p.required = 'Y'
        p.default = '1'
        p.type = 'string'
        p.description = 'The page\'s slug'
      end

      method.parameter('body') do |p|
        p.required = 'Y'
        p.default = '{}'
        p.type = 'json'
        p.description = 'A JSON representation of the attachment'
      end
    end

    pa.method('Destroy') do |method|
      method.synopsis = "Destroys a file attachment for a page"
      method.http_method = "DELETE"
      method.uri = "/sites/:site_slug/pages/:page_slug/attachments/:id"

      method.parameter('site_slug') do |p|
        p.required = 'Y'
        p.type = 'string'
        p.description = 'The slug of the site the page lives on'
      end

      method.parameter('page_slug') do |p|
        p.required = 'Y'
        p.default = '1'
        p.type = 'string'
        p.description = 'The page\'s slug'
      end

      method.parameter('id') do |p|
        p.required = 'Y'
        p.type = 'int'
        p.description = 'The ID of the page attachment'
      end
    end

  end

end