DELETEStart sletning af en butiksaktivitet
Starter sletning af en aktivitet, som endnu ikke er startet. Igangværende og afsluttede aktiviteter kan ikke slettes.
Endpoint
https://www.tcgm.dk/api/v1/store/events/{eventid}Autorisation
Bearer-nøgle medstore:events:delete
Path-parametre
eventidstring · påkrævet- Butiksaktivitetens TCGM-id (store_ev_…) fra oprettelse eller aktivitetslisten. Ikke et api_ev_-behandlings-id eller butikkens id. Trimmes før validering. Mindst 1 tegn. Højst 200 tegn.
Headers
Authorizationstring · påkrævet- Bearer <api-nøgle>. Nøglen oprettes af en owner/admin på organisationens API-side.
Gemmes kun i denne sides hukommelse.
Idempotency-Keystring · påkrævet- 1–200 synlige ASCII-tegn uden mellemrum. Genbrug ved genforsøg; ny nøgle til en ny handling. Mindst 1 tegn. Højst 200 tegn. Mønster: ^[\x21-\x7e]+$
Genbrug nøglen ved genforsøg. “Ny handling” opretter en ny nøgle.
Content-Typestring · påkrævet- JSON-body, højst 256 KiB. Fast værdi: "application/json".
Request-body
application/json · påkrævet
Ukendte felter afvises.
organizationstring · påkrævet- Trimmes før validering. Mindst 1 tegn. Højst 200 tegn.
storestring · påkrævet- Butikkens id fra /api/v1/access. Mindst 1 tegn. Højst 200 tegn.
dataobject · valgfri- Ukendte felter afvises.
Underfelter kræves kun, når det overordnede objekt sendes.
Response · 200
Sletning startet, eller allerede startet med changed=false.
Cache-Control: no-store
{
event: {
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;
};
changed: boolean;
}Statuskoder
- 200
- Sletning startet, eller allerede startet med changed=false.
- 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.
- 409
- Aktiviteten er startet: event_started. Genbrug af en nøgle med andet indhold giver idempotency_conflict.
- 413
- JSON-body overstiger 256 KiB.
- 415
- Content-Type skal være application/json.
- 503
- Lager eller behandling er utilgængelig. Ingen interne fejl eller skemadetaljer udleveres i produktion.
- 405
- HTTP-metoden understøttes ikke.
Headers og fejlfelter
Cache-Control: no-store
{
error: string;
}Cache-Control: no-store
WWW-Authenticate: Bearer
{
error: string;
}Adfærd og genforsøg
JSON-body må højst fylde 256 KiB. Ukendte bodyfelter afvises. Identiske genforsøg med samme Idempotency-Key returnerer det oprindelige resultat; ændret indhold giver 409. Genbrug nøglen ved usikkert udfald.
Adgang og ejerskab kontrolleres også ved genforsøg og før beskyttet baggrundsarbejde. En senere fejl fortryder ikke automatisk allerede gennemførte ændringer.
Aktiviteten skjules, når sletningen starter. En senere POST-opdatering på samme adresse annullerer sletningen; data: {} er nok. Brug en ny idempotensnøgle. Aktiviteten indsendes til godkendelse igen.
Starttidspunktet skal være senere end serverens aktuelle tidspunkt; ellers returneres 409 med error: event_started. Det gælder også gentagende aktiviteter fra deres første start. data kan udelades eller være {}. Der registreres intet forbrug.
Et identisk genforsøg henter kvitteringen for den oprindelige handling. Det starter ikke sletning igen, hvis den senere er annulleret.