printing-press-library/library/media-and-entertainment/dice-fm/spec.yaml at main · Rowdy/printing-press-library · 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
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
name: dice-fm
display_name: DICE
description: DICE Partners API — query and export your event ticket, order, fan, and revenue data.
cli_description: Every ticket, fan, and pound of revenue from your DICE events — queryable, exportable, and joinable across shows.
version: "0.1.0"
category: media-and-entertainment
base_url: https://partners-endpoint.dice.fm
graphql_endpoint_path: /graphql
spec_source: docs

auth:
  type: bearer_token
  header: Authorization
  in: header
  env_vars:
    - DICE_FM_TOKEN
  # doctor POSTs this small viewer query to validate the token (2xx + no errors).
  verify_query: "query { viewer { id name } }"

resources:
  events:
    description: Events on your DICE account (scheduling, state, venues, ticket types)
    endpoints:
      list:
        method: POST
        path: /graphql
        description: List your events
        params:
          - name: state
            type: string
            description: "Filter by event state: APPROVED, ARCHIVED, CANCELLED, DECLINED, DRAFT, REVIEW, SUBMITTED"
        response:
          type: array
          item: Event
        pagination:
          type: cursor
          limit_param: first
          cursor_param: after
      get:
        method: POST
        path: /graphql
        description: Get a single event by ID
        params:
          - name: id
            type: string
            required: true
            positional: true
            description: Event ID
        response:
          type: object
          item: Event

  tickets:
    description: Sold tickets with holder details, pricing, and claim status
    endpoints:
      list:
        method: POST
        path: /graphql
        description: List sold tickets (filter by event)
        params:
          - name: event
            type: string
            description: Filter by event ID
          - name: fan-phone
            type: string
            description: Filter by fan phone number
        response:
          type: array
          item: Ticket
        pagination:
          type: cursor
          limit_param: first
          cursor_param: after

  orders:
    description: Ticket purchase orders with financial and geographic data
    endpoints:
      list:
        method: POST
        path: /graphql
        description: List orders (filter by event)
        params:
          - name: event
            type: string
            description: Filter by event ID
        response:
          type: array
          item: Order
        pagination:
          type: cursor
          limit_param: first
          cursor_param: after

  returns:
    description: Ticket returns and refunds
    endpoints:
      list:
        method: POST
        path: /graphql
        description: List returns (filter by event)
        params:
          - name: event
            type: string
            description: Filter by event ID
        response:
          type: array
          item: Return
        pagination:
          type: cursor
          limit_param: first
          cursor_param: after

  transfers:
    description: Ticket transfers between fans
    endpoints:
      list:
        method: POST
        path: /graphql
        description: List ticket transfers (filter by event)
        params:
          - name: event
            type: string
            description: Filter by event ID
        response:
          type: array
          item: TicketTransfer
        pagination:
          type: cursor
          limit_param: first
          cursor_param: after

  extras:
    description: Extras and add-ons sold with tickets
    endpoints:
      list:
        method: POST
        path: /graphql
        description: List extras (filter by event)
        params:
          - name: event
            type: string
            description: Filter by event ID
          - name: separate-barcode
            type: boolean
            description: Filter to extras that have a separate access barcode
        response:
          type: array
          item: Extra
        pagination:
          type: cursor
          limit_param: first
          cursor_param: after

  genres:
    description: Event genre types and their child genres
    endpoints:
      list:
        method: POST
        path: /graphql
        description: List genre types
        response:
          type: array
          item: GenreType
        pagination:
          type: cursor
          limit_param: first
          cursor_param: after

# Hand-written commands declared so SKILL.md / README can document them
# alongside the spec-driven resources. The generator emits NO code for these —
# they are authored in internal/cli/ and recorded in .printing-press-patches.json.
extra_commands:
  - name: capacity
    description: Cross-event sold-vs-capacity headroom rollup from the local store
  - name: capacity pools
    description: Per-ticket-pool allocation breakdown (pool-sum vs event total) from the local store
  - name: tier-performance
    description: Per price-tier redemptions and share-of-sales rate from the local store
  - name: normalize
    description: Normalize raw ticket-type and venue names into canonical, structured form
  - name: normalize stats
    description: Print normalized entity counts per axis from the local attribute tables
  - name: normalize recommend
    description: Profile the local store and emit a starter normalization config