feat(#41): Resolve corporation names in CorporationLabel

docs/mammon-api.yml

@@ -955,6 +955,56 @@ paths:
                 $ref: "#/components/schemas/BalanceResponse"
         "404":
           description: No ledger with this id
+  /corporations:
+    get:
+      tags:
+      - corporation
+      summary: "Resolve public information for several corporation ids at once, silently\
+        \ omitting ids ESI cannot resolve"
+      operationId: findCorporations
+      parameters:
+      - name: ids
+        in: query
+        description: "Corporation ids to resolve, e.g. ids=98000001,98000002"
+        required: true
+        schema:
+          type: array
+          items:
+            type: integer
+            format: int64
+      responses:
+        "200":
+          description: The corporations that resolved; unknown ids are omitted
+          content:
+            '*/*':
+              schema:
+                type: array
+                items:
+                  $ref: "#/components/schemas/CorporationResponse"
+  /corporations/{corporationId}:
+    get:
+      tags:
+      - corporation
+      summary: "Resolve public information (name, ticker, alliance) for a corporation\
+        \ id"
+      operationId: findCorporation
+      parameters:
+      - name: corporationId
+        in: path
+        description: "Corporation id to resolve, e.g. 98000001"
+        required: true
+        schema:
+          type: integer
+          format: int64
+      responses:
+        "200":
+          description: The resolved corporation
+          content:
+            '*/*':
+              schema:
+                $ref: "#/components/schemas/CorporationResponse"
+        "404":
+          description: Returned when ESI has no corporation with the given id
   /characters:
     get:
       tags:
@@ -1998,6 +2048,33 @@ components:
       required:
       - quantity
       - typeId
+    CorporationResponse:
+      type: object
+      description: An EVE Online corporation.
+      properties:
+        corporationId:
+          type: integer
+          format: int64
+          description: EVE corporation id.
+          example: 98000001
+        name:
+          type: string
+          description: Corporation name.
+          example: Center for Advanced Studies
+        ticker:
+          type: string
+          description: Corporation ticker.
+          example: CAS
+        allianceId:
+          type: integer
+          format: int64
+          description: "EVE alliance id, null when the corporation is not in an alliance."
+          example: 99000001
+      required:
+      - allianceId
+      - corporationId
+      - name
+      - ticker
     SseEmitter:
       type: object
       properties: