Recreate the OAI/Swagger pet store example about mill HOT 4 CLOSED

The petstore example can't be fully integrated and written in Mill syntax because it has a lot of non-Vimeo-like API examples that Mill isn't able to document yet (like POST body objects).

Instead, I'm going to convert the response I built for my movie showtimes library into some controllers and representations instead and call it a day.

from mill.

I would be curious to know more about the features that mill can't document. Don't we support POST body objects in our API?

from mill.

The http://petstore.swagger.io/#!/pet/addPet endpoint, for example, the POST body is:

{
  "id": 0,
  "category": {
    "id": 0,
    "name": "string"
  },
  "name": "doggie",
  "photoUrls": [
    "string"
  ],
  "tags": [
    {
      "id": 0,
      "name": "string"
    }
  ],
  "status": "available"
}

Mill currently does not have support for object parameters like category.id and category.name. It also does not have support, so far, for signifying that tags is an array of objects in the format of id and name.

from mill.

Sorry, I'm wrong. Mill supports category.id and category.name with the following syntax:

@api-param:public {integer} category.id Category ID
@api-param:public {integer} category.name Category name

Mill definitely doesn't yet support describing contents of array params though.

from mill.