GET Hent butiksaktiviteter · TCGM API v1

GETHent butiksaktiviteter

Henter butikkens aktiviteter og godkendelsesstatus. Ændrer ingen data.

Endpoint

GEThttps://www.tcgm.dk/api/v1/store/events

Autorisation

Bearer-nøgle medstore:events:read

Query-parametre

organizationstring · påkrævet: Organisationens id fra /api/v1/access. Trimmes før validering. Mindst 1 tegn. Højst 200 tegn.; query.organization (påkrævet)
storestring · påkrævet: Butikkens id fra /api/v1/access. Trimmes før validering. Mindst 1 tegn. Højst 200 tegn.; query.store (påkrævet)
statestring · valgfri: Aktive, slettede eller alle aktiviteter. Tilladte værdier: "active", "deleted", "all". Standard: "active".; query.state (valgfri)
limitinteger · valgfri: Antal aktiviteter pr. side. Standard: 25. Minimum: 1. Maksimum: 100.; query.limit (valgfri)
afterstring · valgfri: Brug nextCursor fra forrige svar uændret. Trimmes før validering. Mindst 1 tegn. Højst 200 tegn.; query.after (valgfri)

Headers

Authorizationstring · påkrævet: Bearer <api-nøgle>. Nøglen oprettes af en owner/admin på organisationens API-side.; header.Authorization (påkrævet)
Gemmes kun i denne sides hukommelse.

Response · 200

En side aktiviteter; nextCursor er null på sidste side.

Response · 200

Cache-Control: no-store

{
  events: Array<{
    id: string;
    storeId: string;
    slug: string;
    title: string;
    description: string | null;
    category: "PLAY" | "TOURNAMENT" | "PRERELEASE" | "RELEASE" | "LEARN_TO_PLAY" | "TRADE_DAY" | "COMMUNITY" | "STORE_EVENT";
    tcgBrandId: string | null;
    url: string | null;
    startsAt: string;
    endsAt: string;
    timezone: string;
    repeat: "once" | "weekly" | "even" | "odd" | "monthly-date" | "monthly-weekday";
    status: "DRAFT" | "PENDING" | "APPROVED";
    approvedAt: string | null;
    createdAt: string;
    updatedAt: string;
    deletedAt: string | null;
  }>;
  nextCursor: string | null;
}

Statuskoder

200: En side aktiviteter; nextCursor er null på sidste side.
400: Ugyldigt input: invalid_request.
401: Manglende eller ugyldig Bearer-nøgle: invalid_credential.
403: Adgang nægtet: nøgle, scope, ejerskab eller godkendelse er ikke længere gyldig.
404: Aktiviteten findes ikke i den valgte butik: event_not_found.
503: Lager eller behandling er utilgængelig. Ingen interne fejl eller skemadetaljer udleveres i produktion.
405: HTTP-metoden understøttes ikke.

Headers og fejlfelter

Response · 400, 403, 404, 503

Cache-Control: no-store

{
  error: string;
}

Response · 401

Cache-Control: no-store
WWW-Authenticate: Bearer

{
  error: string;
}

Adfærd og genforsøg

Sorteret efter id. Send after=nextCursor for næste side. Listen indeholder også kladder og aktiviteter, der afventer godkendelse; standarden udelader aktiviteter, hvor sletning er startet.

{ "events": [ { "id": "store_ev_example", "storeId": "store_example", "slug": "kortspil-i-butikken", "title": "Kortspil i butikken", "description": null, "category": "STORE_EVENT", "tcgBrandId": null, "url": null, "startsAt": "2026-12-04T17:00:00.000Z", "endsAt": "2026-12-04T20:00:00.000Z", "timezone": "Europe/Copenhagen", "repeat": "once", "status": "PENDING", "approvedAt": null, "createdAt": "2026-11-13T12:00:00.000Z", "updatedAt": "2026-11-13T12:00:00.000Z", "deletedAt": null } ], "nextCursor": null }

Cache-Control: no-store { events: Array<{ id: string; storeId: string; slug: string; title: string; description: string | null; category: "PLAY" | "TOURNAMENT" | "PRERELEASE" | "RELEASE" | "LEARN_TO_PLAY" | "TRADE_DAY" | "COMMUNITY" | "STORE_EVENT"; tcgBrandId: string | null; url: string | null; startsAt: string; endsAt: string; timezone: string; repeat: "once" | "weekly" | "even" | "odd" | "monthly-date" | "monthly-weekday"; status: "DRAFT" | "PENDING" | "APPROVED"; approvedAt: string | null; createdAt: string; updatedAt: string; deletedAt: string | null; }>; nextCursor: string | null; }