Outdoorsy Parks API

openapi: 3.2.0
info:
  title: Outdoorsy Parks API
  version: 0.0.1
  description: 'Operations tagged parks across 2 of this provider''s published API definitions: outdoorsy-parks-api-openapi.yml, outdoorsy-search-openapi-original.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.outdoorsy.com/v0
  description: Base URL declared by the provider in apis.yml (roadmap#122).
security:
- Bearer:
  - '[]'
tags:
- name: parks
paths:
  /parks:
    get:
      description: Search performs search on parks
      tags:
      - parks
      operationId: searchParks
      responses:
        '200':
          $ref: '#/components/responses/jsonApiRentalsResponse'
    servers:
    - url: https://api.outdoorsy.com/v0
      description: Base URL declared by the provider in apis.yml (roadmap#122).
  /parks/homepage:
    get:
      description: Get parks for Outdoorsy homepage
      tags:
      - parks
      operationId: parks
      responses:
        '200':
          $ref: '#/components/responses/jsonApiHomepageParks'
    servers:
    - url: https://api.outdoorsy.com/v0
      description: Base URL declared by the provider in apis.yml (roadmap#122).
  /parks/nearby-for-rental/{rental_id}:
    get:
      description: Searches nearby parks for given rental with rental_id
      tags:
      - parks
      operationId: searchParks
      responses:
        '200':
          $ref: '#/components/responses/jsonApiRentalsResponse'
    servers:
    - url: https://api.outdoorsy.com/v0
      description: Base URL declared by the provider in apis.yml (roadmap#122).
  /parks/popular:
    get:
      description: Searches 6 national parks near location with images
      tags:
      - parks
      operationId: searchParks
      responses:
        '200':
          $ref: '#/components/responses/jsonApiRentalsResponse'
    servers:
    - url: https://api.outdoorsy.com/v0
      description: Base URL declared by the provider in apis.yml (roadmap#122).
  /parks/{id}:
    get:
      description: Get park by id
      tags:
      - parks
      operationId: getPark
      parameters:
      - x-go-name: ID
        name: id
        in: path
        required: true
        schema:
          type: integer
          format: int64
      responses:
        '200':
          $ref: '#/components/responses/jsonApiRentalsResponse'
    servers:
    - url: https://api.outdoorsy.com/v0
      description: Base URL declared by the provider in apis.yml (roadmap#122).
components:
  schemas:
    Resource:
      description: 'Note that any of the optional keys will be omitted if a value is not provided.


        For more information, see the specification at:


        http://jsonapi.org/format/#document-resource-object


        http://jsonapi.org/format/#document-resource-identifier-objects'
      type: object
      title: 'Resource represents a JSON API resource identifier or resource object.

        Each valid JSON API resource object must contain at least the "id" and "type" keys,

        and may contain the optional "attributes", "relationships", "links" and "meta" keys.'
      properties:
        attributes:
          type: object
          additionalProperties: {}
          x-go-name: Attributes
        id:
          type: string
          x-go-name: ID
        links:
          $ref: '#/components/schemas/Links'
        meta:
          type: object
          additionalProperties: {}
          x-go-name: Meta
        relationships:
          $ref: '#/components/schemas/Relationships'
        type:
          type: string
          x-go-name: Type
      x-go-package: github.com/smotes/jsonapi
    Relationships:
      description: http://jsonapi.org/format/#document-resource-object-relationships
      type: object
      title: Relationships represents a JSON API relationships object
      additionalProperties:
        $ref: '#/components/schemas/Relationship'
      x-go-package: github.com/smotes/jsonapi
    Links:
      description: http://jsonapi.org/format/#document-links
      type: object
      title: Links represents a JSON API links object, which can include JSON API link objects or strings representing links.
      additionalProperties: {}
      x-go-package: github.com/smotes/jsonapi
    Relationship:
      type: object
      title: Relationship represents a member of the JSON API relationships object.
      properties:
        data:
          type: object
          x-go-name: Data
        links:
          $ref: '#/components/schemas/Links'
        meta:
          type: object
          additionalProperties: {}
          x-go-name: Meta
      x-go-package: github.com/smotes/jsonapi
  responses:
    jsonApiRentalsResponse:
      description: ''
      content:
        application/vnd.api+json:
          schema:
            type: array
            items:
              $ref: '#/components/schemas/Resource'
        application/json:
          schema:
            type: array
            items:
              $ref: '#/components/schemas/Resource'
    jsonApiHomepageParks:
      description: ''
      content:
        application/vnd.api+json:
          schema:
            type: array
            items:
              $ref: '#/components/schemas/Resource'
        application/json:
          schema:
            type: array
            items:
              $ref: '#/components/schemas/Resource'
  securitySchemes:
    Bearer:
      type: apiKey
      name: Authorization
      in: header
x-refined-from:
- outdoorsy-parks-api-openapi.yml
- outdoorsy-search-openapi-original.json