POSTOpret en butiksaktivitet
Opretter en butiksaktivitet og indsender den til godkendelse. Kræver en offentlig butik.
Endpoint
https://www.tcgm.dk/api/v1/store/eventsAutorisation
Bearer-nøgle medstore:events:create
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- Trimmes før validering. Mindst 1 tegn. Højst 200 tegn.
dataobject · påkrævet- Ukendte felter afvises.
data.titlestring · påkrævet- Skal give en gyldig slug; opret og tcgm er reserverede. Mindst 1 tegn. Højst 200 tegn.
data.descriptionstring · valgfri- Valgfri tekst. Tom streng betyder ingen beskrivelse; normaliseres ved lagring. Standard: "". Højst 10000 tegn.
data.categorystring · påkrævet- Tilladte værdier: "PLAY", "TOURNAMENT", "PRERELEASE", "RELEASE", "LEARN_TO_PLAY", "TRADE_DAY", "COMMUNITY", "STORE_EVENT".
data.tcgBrandIdstring · valgfri- Et eksisterende, ikke slettet spil kræves undtagen ved STORE_EVENT, som ikke gemmer et spil. Standard: "". Højst 200 tegn.
data.urlstring · valgfri- Gyldig HTTPS-adresse eller tom streng. Standard: "". Højst 2000 tegn.
data.startsAtstring · påkrævet- Lokal dato og tid som YYYY-MM-DDTHH:mm i den angivne timezone. Ugyldige lokale tidspunkter afvises. Mønster: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}$
data.endsAtstring · påkrævet- Lokal dato og tid som YYYY-MM-DDTHH:mm i den angivne timezone. Ugyldige lokale tidspunkter afvises. Skal ligge efter startsAt. Mønster: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}$
data.timezonestring · valgfri- Dansk tidszone. Kun Europe/Copenhagen understøttes. Fast værdi: "Europe/Copenhagen". Standard: "Europe/Copenhagen".
data.repeatstring · valgfri- once: én dato. weekly: hver uge. even/odd: lige/ulige ISO-uger. monthly-date: samme dato hver måned. monthly-weekday: samme ugedagsplacering, fx første fredag. startsAt forankrer gentagelsen; måneder uden datoen eller ugedagsplaceringen springes over. Tidspunktet bevares i Europe/Copenhagen, også ved sommertid. Tilladte værdier: "once", "weekly", "even", "odd", "monthly-date", "monthly-weekday". Standard: "once".
Underfelter kræves kun, når det overordnede objekt sendes.
Response · 201
Oprettet og indsendt til godkendelse.
Cache-Control: no-store
{
id: string;
slug: string;
status: "PENDING" | "APPROVED";
}Statuskoder
- 201
- Oprettet og indsendt til godkendelse.
- 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
- Ressourcen findes ikke eller er ikke tilgængelig.
- 409
- Konflikt: fx idempotency_conflict, external_id_conflict eller order_closed. Samme nøgle med andet valideret indhold afvises.
- 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.
Gentagelse gemmes efter de eksisterende aktivitetsregler. Ingen workflow eller polling er nødvendig. Der registreres intet forbrug.