thanks for the reply, Tony can I just clarify something : you said " *you should have unique numbers for all operationId values*" , so does that mean a guid / uuid would be acceptable ? If so, how do you *name* the endpoint ?
This is perhaps where my confusion is coming from. I completely understand the requirement for operationId to be unique, but is there a name / nickname / alias property I can use to name the method ? I've only seen an operationid containing a "meaningful" (ie getPet) value rather than a number / id / guid etc Thanks On Tuesday, 27 September 2016 03:08:56 UTC+1, tony tam wrote: > > Hi, you should have unique numbers for all operationId values. If the > tools work, it doesn’t make it right—it just means they’re being lenient. > They could throw errors but the authors have decided to gracefully handle > the error in the spec. > > On Sep 24, 2016, at 11:05 AM, jmls <[email protected] <javascript:>> wrote: > > Hey all > > Been looking through the v2 specification ( > http://swagger.io/specification/) , and came across this statement: > > *operationId: 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.* > > I am slightly confused about this : > > if I have 2 models (Customer and Order) does this mean that a "*find*" > method must be unique across both, or just within the model ? (ie is the > API the model or all models ? ) > > So I tried an experiment: I have 2 operationId's of "find" : 1 on the > customer and one on the order > > I then ran swagger codegen and it didn't complain about uniqueness. > > I then added *another* "find" to the Customer model, and this time codegen > *did* complain about non-unique operationid's - and renamed it to find_1 > > So - is swagger-codegen wrong, or are operationId's unique within a model > and not the whole API ? > > Thanks > > -- > You received this message because you are subscribed to the Google Groups > "Swagger" group. > To unsubscribe from this group and stop receiving emails from it, send an > email to [email protected] <javascript:>. > For more options, visit https://groups.google.com/d/optout. > > > -- You received this message because you are subscribed to the Google Groups "Swagger" group. To unsubscribe from this group and stop receiving emails from it, send an email to [email protected]. For more options, visit https://groups.google.com/d/optout.
