feat(#53): Show combined-ledger daily trade profit and margin

docs/mammon-api.yml

@@ -960,7 +960,7 @@ paths:
     get:
       tags:
       - profit
-      summary: Get the daily profit series for a single ledger
+      summary: Get the daily profit series for a single or combined ledger
       operationId: profitPerDayInLedger
       parameters:
       - name: ledgerId
@@ -972,8 +972,8 @@ paths:
           format: uuid
       responses:
         "200":
-          description: "Daily profit for the ledger, ascending by date, only for days\
-            \ with ISK activity"
+          description: "Daily profit for the ledger, ascending by date. For a combined\
+            \ ledger, per-date values are merged across its covered main ledgers."
           content:
             '*/*':
               schema:
@@ -981,14 +981,15 @@ paths:
                 items:
                   $ref: "#/components/schemas/DailyProfitResponse"
         "400":
-          description: The ledger is the system ledger or a combined ledger
+          description: The ledger is the system ledger
         "404":
           description: No ledger with this id
   /ledgers/{ledgerId}/margin:
     get:
       tags:
       - profit
-      summary: Get the daily FIFO-realized margin series for a single ledger
+      summary: Get the daily FIFO-realized margin series for a single or combined
+        ledger
       operationId: marginPerDayInLedger
       parameters:
       - name: ledgerId
@@ -1000,10 +1001,11 @@ paths:
           format: uuid
       responses:
         "200":
-          description: "Daily FIFO-realized margin for the ledger, ascending by date,\
-            \ only for days with a consumption. iskIn is the sum of that day's profitable\
-            \ consumptions, iskOut is the sum of that day's losing consumptions (as\
-            \ a positive deficit); profit is iskIn minus iskOut."
+          description: "Daily FIFO-realized margin for the ledger, ascending by date.\
+            \ iskIn is the sum of that day's profitable consumptions, iskOut is the\
+            \ sum of that day's losing consumptions (as a positive deficit); profit\
+            \ is iskIn minus iskOut. For a combined ledger, per-date values are merged\
+            \ across its covered main ledgers."
           content:
             '*/*':
               schema:
@@ -1011,7 +1013,7 @@ paths:
                 items:
                   $ref: "#/components/schemas/DailyProfitResponse"
         "400":
-          description: The ledger is the system ledger or a combined ledger
+          description: The ledger is the system ledger
         "404":
           description: No ledger with this id
   /ledgers/{ledgerId}/balance:
@@ -1071,8 +1073,7 @@ paths:
     get:
       tags:
       - corporation
-      summary: "Resolve public information for several corporation ids at once, silently\
-        \ omitting ids ESI cannot resolve"
+      summary: Resolve public information for several corporation ids at once
       operationId: findCorporations
       parameters:
       - name: ids
@@ -1086,13 +1087,15 @@ paths:
             format: int64
       responses:
         "200":
-          description: The corporations that resolved; unknown ids are omitted
+          description: The resolved corporations
           content:
             '*/*':
               schema:
                 type: array
                 items:
                   $ref: "#/components/schemas/CorporationResponse"
+        "404":
+          description: Returned when no corporation exists for one of the given ids
   /corporations/{corporationId}:
     get:
       tags:
@@ -1116,7 +1119,7 @@ paths:
               schema:
                 $ref: "#/components/schemas/CorporationResponse"
         "404":
-          description: Returned when ESI has no corporation with the given id
+          description: Returned when no corporation exists with the given id
   /characters:
     get:
       tags:
@@ -1149,17 +1152,27 @@ paths:
     get:
       tags:
       - acquisition
-      summary: "Find the caller's acquisitions, optionally filtered by ledger, market\
+      summary: "Find the caller's acquisitions, optionally filtered by ledgers, market\
         \ type and consumption state"
       operationId: findAllAcquisitions
       parameters:
       - name: ledgerId
         in: query
-        description: Only return acquisitions held in this ledger
+        description: "Only return acquisitions held in this ledger (deprecated, use\
+          \ ledgerIds)"
         required: false
         schema:
           type: string
           format: uuid
+      - name: ledgerIds
+        in: query
+        description: Only return acquisitions held in these ledgers
+        required: false
+        schema:
+          type: array
+          items:
+            type: string
+            format: uuid
       - name: marketTypeId
         in: query
         description: Only return acquisitions of this market type