Zurückgeben eines Arrays von Objekten, das die SDK-Antwort richtig definiert

Question

Ich habe einen typischen RESTful-Endpunkt, der eine Auflistung von Modellen zurückgibt, aber das generierte Ruby SDK gibt ein neues Modell Matters anstelle eines Arrays von Modellen zurück. Ich kann den erzeugten Quellcode hacken, um Array<Matter> zurückzugeben, aber das ist ein Maintenance-Kopfschmerz. Wie gebe ich an, dass ich in der YAML Array<Matter> zurückgeben möchte?

paths: 
    /matters: 
    get: 
    ... 
    responses: 
     200: 
     schema: 
      $ref: "#/definitions/Matters" 
... 
definitions: 
    Matter: 
    type: "object" 
    properties: 
     id: 
     type: "string" 
     description: "Database identifier of the object." 
     caseId: 
     type: "string" 
     description: "Database identifier of the Case object." 
     clientMatterNumber: 
     type: "string" 
     description: "Client/matter billing code." 
     judge: 
     type: "string" 
     description: "Initials of the presiding judge." 
     caseNumber: 
     type: "string" 
     description: "Canonical case number." 
     caseTitle: 
     type: "string" 
     description: "Canonical case title." 
     natureOfSuit: 
     type: "string" 
     description: "Judicial Conference designation of the case." 
     docketEntries: 
     type: "integer" 
     description: "The count of docket entries in the case." 
     activityAt: 
     type: "string" 
     format: "date-time" 
     description: "The time of last activity in the case. " 
    Matters: 
    description: "A collection of matters" 
    type: "array" 
    items: 
     $ref: "#/definitions/Matter" 

Answer 1

es heraus ...

responses: 
    200: 
     description: "200 response" 
     schema: 
     type: "array" 
     items: 
      $ref: "#/definitions/Matter"