заинтересовал swagger. С чего начать

[mstdmstd]

Всем привет,
Подскажите заинтересовал swagger для документирования и отладки REST API написаной на php с использованием IDE PhpStorm 2016.2.1 под Kubuntu
Я посмотрел некотрые обзоры на youtube - что swagger можно устанавливать локально и пользовать онлайновую версию
А что по - вашему удобнее ?
Я Открыл http://editor.swagger.io и нескажу что все сразу было понятно
Это какой-то демо проект загружен ?

Uber API
Move your app forward with the Uber API
Version 1.0.0
...

там нужно регистрироваться чтобы сохранить свою сессию?
Ткните пожалуйста на пошаговую иснтрукцию как пользоваться этим редактором, можно на русском... На ютубе заблудился в обзорах и сравнении аналогичных систем...



Спасибо!

 

[AmdY]

Берёшь копипастишь и правишь пример, всё элементарно, можно даже без курения доки догадаться что для чего.

 

[mstdmstd]

Пытаюсь разобраться на лету
Я поменял лейблы и ввел урл
http://imgur.com/a/ng2l4

но как
1) Вести в 1ом месте урл сайта а в остальных случаях относительный урл - как это обычно делается на сайтах?

2) Что за параметр Size of array и как его посчитать ?

3) Справа вверху я вижу сообщение "All Changes saved"? но я не логинился в систему и не вижу где логиниться...
File->"Import Url" "Import file", "Download Yaml", "Download JSON"?
Это что для сохранения настроек у себя у потом загузить их в этот редактор?

В нете описания что я находил обьясняются на примере pet-базы, как начать свою бпазу я не нашел...

 

[AmdY]

Бог ты мой. Откуда вы это взяли, зайдите по своей ссылке и посмотрите что там
Ваш домен
host: api.uber.com

А остальное прописывается в path без него

# this is an example of the Uber API
# as a demonstration of an API spec in YAML
swagger: '2.0'
info:
  title: Uber API
  description: Move your app forward with the Uber API
  version: "1.0.0"
# the domain of the service
host: api.uber.com
# array of all schemes that your API supports
schemes:
  - https
# will be prefixed to all paths
basePath: /v1
produces:
  - application/json
paths:
  /products:
    get:
      summary: Product Types
      description: |
        The Products endpoint returns information about the *Uber* products
        offered at a given location. The response includes the display name
        and other details about each product, and lists the products in the
        proper display order.
      parameters:
        - name: latitude
          in: query
          description: Latitude component of location.
          required: true
          type: number
          format: double
        - name: longitude
          in: query
          description: Longitude component of location.
          required: true
          type: number
          format: double
      tags:
        - Products
      responses:
        200:
          description: An array of products
          schema:
            type: array
            items:
              $ref: '#/definitions/Product'
        default:
          description: Unexpected error
          schema:
            $ref: '#/definitions/Error'

>>2) Что за параметр Size of array и как его посчитать ?
Вы же сами его добавили и задали что он должен быть в строке запроса ( in: query)