operationID not unique

[barnaclebarnes]

The operationId being output is currently the action name of the controller. According to the docs:

"operationId: string - Unique string used to identify the operation. The id MUST be unique among all operations described in the API. Tools and libraries MAY use the operationId to uniquely identify an operation, therefore, it is RECOMMENDED to follow common programming naming conventions."

As multiple controllers may have index, show methods, etc. then this outputs duplicate operationID's. It would be good if:

1. The default was #{controller_name}_#{action}
2. You could set this in the api call

[barnaclebarnes]

I realised I can do self[:operationId] = "show_app" in the api block so no need for number 2 on that list. 1 though should default to creating a unique name.

[zhandao]

You're right, I will consider that.

[zhandao]

Hi, I updated the changes.
Number 1 became the default, and you can do number 2 by the param keyword id of the api method, like: api :index, id: :show_all, ...

Thanks you.

[barnaclebarnes]

@zhandao Thanks for that. I would potentially make it like this to make it bit nicer to read:

# ControllerNameAction
"#{@doc_info[:tag][:name]}#{action.capitalize}"

Not a critical though.

[zhandao]

OK, I'll make that in next commit.

[zhandao]

Done.