Sovereign_Map_Federated_Learning/docs/api/openapi.tokenomics.yaml at main · rwilliamspbg-ops/Sovereign_Map_Federated_Learning · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
openapi: 3.0.3
info:
  title: Sovereign Map Tokenomics Metrics Exporter API
  version: 1.0.0
  description: API exposed by tokenomics_metrics_exporter.py
servers:
  - url: http://localhost:9105
    description: Local tokenomics exporter

tags:
  - name: Tokenomics

paths:
  /health:
    get:
      tags: [Tokenomics]
      summary: Health check
      operationId: getTokenomicsHealth
      responses:
        '200':
          description: Exporter health
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    example: healthy
                  source_file:
                    type: string

  /metrics:
    get:
      tags: [Tokenomics]
      summary: Prometheus metrics endpoint
      operationId: getTokenomicsMetrics
      responses:
        '200':
          description: Prometheus exposition text
          content:
            text/plain:
              schema:
                type: string

  /event/tokenomics:
    post:
      tags: [Tokenomics]
      summary: Ingest tokenomics payload event
      operationId: postTokenomicsEvent
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        '200':
          description: Event ingested
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    example: ok
        '400':
          description: Invalid payload
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    example: error
                  error:
                    type: string