Lightyear Developer

Hi Ben, The tool generates a complete client that includes the object model, and classes for making request/responses. The pagination metadata is not in the swagger that we can see. For example the GET /ledger_accounts request is defined in the swagger as having the following response: "responses": { "200": { "description": "Returns all Ledger Accounts", "schema": { "type": "array", "items": { "$ref": "#/definitions/LedgerAccount" } } } } i.e. it says an array of LedgerAccount objects are returned: "LedgerAccount": { "type": "object", "properties": { "id": { "type": "string", "description": "The unique identifier for the item" }, "displayed_as": { "type": "string", "description": "The name of the resource" }, ...the rest of the LedgerAccount properties... } If we tweak the swagger and add a 'page' object based on what we see returned by the actual endpoint and update the /ledger_accounts request to reference that rather than an array of LedgerAccount then it all works as expected. As an aside is the paging meta data described anywhere in the documentation - at the minute we are calling the endpoint until the '$next' property in the paging meta data is null which seems to work.

Hi, We have generated a Java client from the Account API Swagger using OpenAPI Tools. The Java client successfully generates and compiles but we are having problems calling endpoints that return lists of objects. For example if we call the GET /ledger_accounts endpoint the Java client blows up because the JSON object returned doesn't match what is defined in the Swagger. The endpoint is documented here as returning an array like this: [ { "id": "5135bf0b019049c099cedc1a0771cb3a", "displayed_as": "Bank Account (1200)", "$path": "/ledger_accounts/5135bf0b019049c099cedc1a0771cb3a" }, { "id": "6f9ff4f0662944379d64e9c544eac6ad", "displayed_as": "Cash (1210)", "$path": "/ledger_accounts/6f9ff4f0662944379d64e9c544eac6ad" } ] This looks to match what is in the Swagger and the Java client generated from it. What is actually returned is this: { "$total": 124, "$page": 1, "$next": "/ledger_accounts?page=2&items_per_page=20", "$back": null, "$itemsPerPage": 20, "$items": [ { "id": "5135bf0b019049c099cedc1a0771cb3a", "displayed_as": "Bank Account (1200)", "$path": "/ledger_accounts/5135bf0b019049c099cedc1a0771cb3a" }, { "id": "6f9ff4f0662944379d64e9c544eac6ad", "displayed_as": "Cash (1210)", "$path": "/ledger_accounts/6f9ff4f0662944379d64e9c544eac6ad" } ] } The documented array is embedded in a 'page' object. The 'page' object isn't described in the documentation for this endpoint or the Swagger file. I suppose the question I have is, are we maybe not supposed to use the Swagger to generate clients i.e. it is only for documentation purposes?