SuperAwesomes API

Værd at vide

• Ruten understøtter ikke sideinddeling eller filtrering.
• Spillerruter returnerer Cache-Control: no-store.

En tom liste; dette endpoint tilbyder endnu ikke en oversigt over spillere.

[]

Værd at vide

• Omfatter rollerne admin, seniormod, developer, mod, support og bygger. CONSOLE er udeladt.
• Skjult onlinestatus vises som offline. Cache-Control: no-store.
• Ruten har ingen særskilt statuskode for en mislykket databaselæsning; svaret kan være null.

En liste over teammedlemmer.

[
  {
    "username": "ExampleStaff",
    "uuid": "22222222-2222-4222-8222-222222222222",
    "role": "support",
    "status": "offline"
  }
]

Parametre

Værd at vide

• Brugernavne matches på en del af navnet; UUID'er skal matche præcist. Et præcist brugernavnsmatch vises først, derefter sorteres efter status og brugernavn.
• Søgeteksten bruger LIKE-matching: % og _ fungerer som jokertegn.
• Skjult onlinestatus vises som status: offline og currentServer: null. Cache-Control: no-store.
• Et tomt resultat giver ikke 404 og kan også forekomme, hvis en databaselæsning mislykkes.

Op til otte resultater. En manglende, for kort eller for lang query returnerer [].

[
  {
    "username": "ExamplePlayer",
    "uuid": "11111111-1111-4111-8111-111111111111",
    "role": "default",
    "status": "online",
    "currentServer": "Example-SMP"
  }
]

Værd at vide

• value måles i sekunder for playtime, point for playerPoints/lobbyPoints og en vægtet score for ratings. rank starter ved 1.
• Alle perioder returneres under playtimePeriods; ruten accepterer ikke parametrene period eller limit.
• Spilletiden fra en enkelt session begrænses til syv dage. Kun en gyldig, aktuel og åben session kan fortsætte med at optjene spilletid.
• Totaler opdateres normalt hvert 300. sekund. Under en opdatering eller en midlertidig fejl kan svaret være op til 900 sekunder gammelt; tjek updatedAt.
• Skjulte spillere udelades ved hver forespørgsel, også når ranglistens totaler hentes fra cache. HTTP-svaret bruger Cache-Control: no-store.

Alle ranglister i et samlet svar med op til 100 spillere på hver rangliste.

{
  "updatedAt": "2026-10-01T10:00:00.000Z",
  "refreshIntervalSeconds": 300,
  "leaderboards": {
    "playtime": [
      {
        "rank": 1,
        "username": "ExamplePlayer",
        "uuid": "11111111-1111-4111-8111-111111111111",
        "role": "default",
        "value": 7200
      }
    ],
    "playerPoints": [
      {
        "rank": 1,
        "username": "ExamplePlayer",
        "uuid": "11111111-1111-4111-8111-111111111111",
        "role": "default",
        "value": 20
      }
    ],
    "lobbyPoints": [
      {
        "rank": 1,
        "username": "ExamplePlayer",
        "uuid": "11111111-1111-4111-8111-111111111111",
        "role": "default",
        "value": 5
      }
    ],
    "ratings": [
      {
        "rank": 1,
        "username": "ExamplePlayer",
        "uuid": "11111111-1111-4111-8111-111111111111",
        "role": "default",
        "value": 4,
        "ratings": {
          "positive": 4,
          "negative": 0,
          "neutral": 0,
          "total": 4
        }
      }
    ]
  },
  "playtimePeriods": {
    "30": [
      {
        "rank": 1,
        "username": "ExamplePlayer",
        "uuid": "11111111-1111-4111-8111-111111111111",
        "role": "default",
        "value": 7200
      }
    ],
    "90": [
      {
        "rank": 1,
        "username": "ExamplePlayer",
        "uuid": "11111111-1111-4111-8111-111111111111",
        "role": "default",
        "value": 7200
      }
    ],
    "180": [
      {
        "rank": 1,
        "username": "ExamplePlayer",
        "uuid": "11111111-1111-4111-8111-111111111111",
        "role": "default",
        "value": 7200
      }
    ],
    "365": [
      {
        "rank": 1,
        "username": "ExamplePlayer",
        "uuid": "11111111-1111-4111-8111-111111111111",
        "role": "default",
        "value": 7200
      }
    ]
  }
}

Parametre

Værd at vide

• activity indeholder antal sessioner og spilletid pr. dag fra starten af dagen for 182 dage siden. favoriteServers og recentSessions indeholder hver op til otte resultater.
• Spilletid måles i sekunder, og hver session begrænses til syv dage. Den aktuelle loginStreak beregnes ud fra datoerne for i dag og i går i tidszonen Europe/Copenhagen.
• Når aktivitet er skjult, er activityVisible false og status offline, mens felterne for aktuel server og seneste aktivitet er null. Spilletid, votes og loginStreak nulstilles i svaret; aktivitet, favoritservere, seneste sessioner og boosts er tomme.
• Badges og venner kan stadig vises, men deres aktivitetsdatoer er null, når profilen skjuler aktivitet. Vennernes onlinestatus følger også deres egne valg om synlighed.
• favoriteServers indeholder name, status, category, version, motdFavicon, sessions, playtimeSeconds og lastSeen. recentSessions indeholder name, type, joinedAt, leftAt og playtimeSeconds.
• ownedServers indeholder name, status, category, version, created, descriptionLong, motdFavicon, players og maxPlayers. badges indeholder name, description, color, symbol, active og created.
• serverBoosts indeholder name og since. friends indeholder username, uuid, role, friendsSince, status og currentServer.
• cached er false; cachedAt er svartidspunktet. Spillerruter bruger Cache-Control: no-store. Profilruten har ikke en ensartet statuskode for databasefejl.

En offentlig spillerprofil. Nogle felter kan være null, og aktivitet kan være skjult.

{
  "username": "ExamplePlayer",
  "uuid": "11111111-1111-4111-8111-111111111111",
  "role": "default",
  "rankLabel": null,
  "rankDisplayName": null,
  "rankColor": null,
  "vipDays": 0,
  "proDays": 0,
  "lobbyPoints": 5,
  "playerPoints": 20,
  "created": "2026-10-01T10:00:00.000Z",
  "activityVisible": true,
  "lastJoined": "2026-10-01T10:00:00.000Z",
  "lastSeen": "2026-10-01T10:00:00.000Z",
  "status": "offline",
  "currentServer": null,
  "banStatus": {
    "banned": false,
    "global": false,
    "lobby": false
  },
  "playtime": {
    "totalSeconds": 0,
    "last7DaysSeconds": 0,
    "last30DaysSeconds": 0,
    "sessions": 0,
    "serversPlayed": 0,
    "averageSessionSeconds": 0,
    "firstSession": null,
    "lastSession": null
  },
  "ratings": {
    "score": 0,
    "total": 0,
    "positive": 0,
    "negative": 0,
    "neutral": 0
  },
  "votes": {
    "total": 0,
    "last30Days": 0
  },
  "loginStreak": {
    "current": 0,
    "longest": 0,
    "totalDays": 0,
    "activeToday": false,
    "startedDate": null,
    "lastLoginDate": null
  },
  "activity": [],
  "favoriteServers": [],
  "recentSessions": [],
  "ownedServers": [],
  "badges": [],
  "serverBoosts": [],
  "friends": [],
  "cached": false,
  "cachedAt": "2026-10-01T10:00:00.000Z"
}

Parametre

Værd at vide

• Et opslag uden resultater returnerer HTTP 200 med {"error":"Spilleren blev ikke fundet"}, ikke HTTP 404. En mislykket datalæsning kan også returnere denne fejl.
• Med type=discord er et vellykket svar en liste af spillerobjekter uden cached og cachedAt. Eksempel: /players/123456789012345678?type=discord.
• rates indeholder username, uuid, role, points, type og created for hver spiller, der har givet en vurdering. rate er summen af point. lobbyAccess er en liste over lobbynavne.
• badges indeholder name, color, symbol, active og created; serverBoosts indeholder name og since. servers viser ejede servere med name, status og version.
• Hvis spilleren ikke ejer servere, kan servers indeholde et objekt med null-felter i stedet for en tom liste.
• Skjult onlinestatus vises som offline med null i lastSeen/currentServer. Boosts skjules, og aktivitetsdatoer i badges/vurderinger er null. Cache-Control: no-store.

Et spillerobjekt ved et normalt opslag, en liste ved type=discord eller et fejlobjekt, hvis spilleren ikke findes.

{
  "username": "ExamplePlayer",
  "uuid": "11111111-1111-4111-8111-111111111111",
  "role": "default",
  "vipDays": 0,
  "proDays": 0,
  "lastSeen": "2026-10-01T10:00:00.000Z",
  "discordID": null,
  "lobbyPoints": 5,
  "playerPoints": 20,
  "status": "offline",
  "currentServer": null,
  "banned": false,
  "lobbyAccess": [],
  "rates": [],
  "badges": [],
  "serverBoosts": [],
  "servers": [
    {
      "name": "Example-SMP",
      "status": "offline",
      "version": "1.21.4"
    }
  ],
  "rate": 0,
  "cached": false,
  "cachedAt": "2026-10-01T10:00:00.000Z"
}

Parametre

Værd at vide

• Cache-Control: no-store. X-Has-More er teksten true/false og er eksponeret via CORS; næste side findes kun når den er true.
• vip, pro og whitelist er databaseflags (typisk 0/1). players og maxPlayers er tal; serverPoints og rate normaliseres til tal. rate er summen af +1 for positive og -2 for negative vurderinger.
• descriptionLong, ejerfelter, MOTD-felter og playersData kan være null. playersData er ellers et array med username, uuid, vip og pro; rates er et array med username, uuid, role, points, type og created.
• Antallet af online-spillere og playersData udelader skjulte spillere (vanish) og spillere uden offentlig tilstedeværelse. Et lavt antal betyder derfor ikke nødvendigvis få faktiske spillere.
• query bruges som SQL LIKE-mønster; % og _ kan også fungere som wildcards. Der returneres ikke et samlet antal sider.

Array af servere; [] når siden ikke har resultater.

[
  {
    "name": "EksempelSMP",
    "version": "1.21.4",
    "descriptionLong": "En hyggelig survival-server.",
    "vip": 1,
    "pro": 0,
    "maxPlayers": 50,
    "status": "online",
    "serverOwner": "123e4567-e89b-42d3-a456-426614174000",
    "serverOwnerName": "EksempelEjer",
    "category": "Survival",
    "whitelist": 0,
    "players": 1,
    "playersData": [
      {
        "username": "EksempelSpiller",
        "uuid": "123e4567-e89b-42d3-a456-426614174001",
        "vip": 0,
        "pro": 0
      }
    ],
    "serverPoints": 120,
    "rates": [
      {
        "username": "EksempelSpiller",
        "uuid": "123e4567-e89b-42d3-a456-426614174001",
        "role": "player",
        "points": 1,
        "type": "positive",
        "created": "2026-10-01T12:00:00.000Z"
      }
    ],
    "motdLine1": "§6EksempelSMP",
    "motdLine2": "§aVelkommen!",
    "motdFavicon": null,
    "rate": 1
  }
]

Værd at vide

• Ingen sti- eller forespørgselsparametre. Et tomt datasæt er []. players kan være [] ved manglende eller ulæselige ældre statistikdata.
• Dette er den ældre samlede statistikform; brug /servers/stats/{serverName} for history, topPlayers og votes i et valgt tidsrum.

Array med serverName, serverOwnerUUID, serverOwner, maxPlayers og players. players knytter Unix-tidsstempler i sekunder til spillerantal.

[
  {
    "serverName": "EksempelSMP",
    "serverOwnerUUID": "123e4567-e89b-42d3-a456-426614174000",
    "serverOwner": "EksempelEjer",
    "maxPlayers": 50,
    "players": {
      "1790856000": 3,
      "1790856060": 5
    }
  }
]

Værd at vide

• Ingen forespørgselsparametre. Servere uden målinger/ejer er ikke med; players kan være [] ved ulæselige data.
• Brug /montly, ikke /monthly. Den faste montly-rute vælges før det dynamiske serverName-segment.

Samme objektform som døgnstatistikken; nøglerne i players er Unix-sekunder for de daglige målinger.

[
  {
    "serverName": "EksempelSMP",
    "serverOwnerUUID": "123e4567-e89b-42d3-a456-426614174000",
    "serverOwner": "EksempelEjer",
    "maxPlayers": 50,
    "players": {
      "1790769600": 4,
      "1790856000": 6
    }
  }
]

Parametre

Værd at vide

• history er kronologisk stigende. timestamp er Unix-sekunder, ikke millisekunder. Daglige players kan være et gennemsnit med decimaler; minutmålinger bruger samme antal til minPlayers/maxPlayers.
• maxPlayers er serverens eksplicit gemte kapacitet eller 0; dette endpoint bruger ikke VIP/PRO-standardkapaciteten fra serverlisten.
• topPlayers har username, uuid, sessions, playtimeSeconds og lastSeen. Kun sessioner startet inden for intervallet tælles, og hver session begrænses til højst syv dage. lastSeen viser seneste registrerede aktivitet, ikke om spilleren er online nu.
• Cache-Control: public, max-age=60, stale-while-revalidate=240. API-processen kan genbruge samme serversvar for det valgte tidsrum i fem minutter.
• En eksisterende server uden aktivitet returnerer tomme arrays og votes med 0; den samlede stats-router er monteret før /servers/{name}.

serverName/range er tekststrenge, maxPlayers er et tal, history og topPlayers er arrays, og votes indeholder total og uniqueVoters.

{
  "serverName": "EksempelSMP",
  "range": "7d",
  "maxPlayers": 50,
  "history": [
    {
      "timestamp": 1790856000,
      "players": 5.5,
      "minPlayers": 1,
      "maxPlayers": 10
    }
  ],
  "topPlayers": [
    {
      "username": "EksempelSpiller",
      "uuid": "123e4567-e89b-42d3-a456-426614174001",
      "sessions": 3,
      "playtimeSeconds": 7200,
      "lastSeen": "2026-10-01T12:00:00.000Z"
    }
  ],
  "votes": {
    "total": 12,
    "uniqueVoters": 8
  }
}

Parametre

Værd at vide

• Manglende server returnerer {"error":"Server not found."} med HTTP 200. Cache-Control: no-store.
• Grundfelter og datatyper følger serverlisten. Derudover: created/lastOnline er datostreng|null, websiteURL/discordURL string|null, stemmetal er tal, og serverBoosts er array|null med uuid, username og since.
• dailyVotes bruger database-dagen; weeklyVotes bruger den aktuelle database-uge/år; monthlyVotes er de seneste 30 dage. serverPoints dækker den seneste måned, mens totalVotes dækker alle stemmer.
• Spillerlisten respekterer samme offentlige tilstedeværelse/vanish-filtrering som serverlisten. MOTD kan indeholde Minecraft-formateringskoder.

Serverobjekt, eller et fejlobjekt med error når navnet ikke findes. Manglende server bruger HTTP 200.

{
  "name": "EksempelSMP",
  "version": "1.21.4",
  "descriptionLong": "En hyggelig survival-server.",
  "vip": 1,
  "pro": 0,
  "maxPlayers": 50,
  "status": "online",
  "serverOwner": "123e4567-e89b-42d3-a456-426614174000",
  "serverOwnerName": "EksempelEjer",
  "category": "Survival",
  "whitelist": 0,
  "players": 1,
  "playersData": [
    {
      "username": "EksempelSpiller",
      "uuid": "123e4567-e89b-42d3-a456-426614174001",
      "vip": 0,
      "pro": 0
    }
  ],
  "serverPoints": 120,
  "rates": [
    {
      "username": "EksempelSpiller",
      "uuid": "123e4567-e89b-42d3-a456-426614174001",
      "role": "player",
      "points": 1,
      "type": "positive",
      "created": "2026-10-01T12:00:00.000Z"
    }
  ],
  "motdLine1": "§6EksempelSMP",
  "motdLine2": "§aVelkommen!",
  "motdFavicon": null,
  "rate": 1,
  "created": "2026-01-01T12:00:00.000Z",
  "lastOnline": "2026-10-01T12:00:00.000Z",
  "websiteURL": "https://example.com",
  "discordURL": null,
  "serverBoosts": [
    {
      "uuid": "123e4567-e89b-42d3-a456-426614174001",
      "username": "EksempelSpiller",
      "since": "2026-10-01T12:00:00.000Z"
    }
  ],
  "dailyVotes": 2,
  "weeklyVotes": 10,
  "monthlyVotes": 35,
  "totalVotes": 120
}

Parametre

Værd at vide

• Manglende server: {"error":"Server not found."}. Manglende ikon: {"error":"No favicon found."}. Kontroller Content-Type før du fortolker svarindholdet.
• API-processen kan gemme standardikonet i sin cache i fem minutter; det er ikke en garanteret HTTP-cacheperiode for hele endpointet.

Binært PNG når serveren og et ikon findes.

Parametre

Værd at vide

• Ukendt server returnerer HTTP 200 med {"error":"Server not found."}. Cache-Control: no-store, så købernes aktuelle privatlivsindstilling respekteres.
• categories har uid/name/imageURL. products har uid/type/name/price/priceDKK/intervals/volumeDiscounts/description/duration/categoryUID/imageURL/automaticDiscount/priceQuote. Billed-URL og prisfelter kan være null; imageUID udelades fra JSON.
• Produkttype er eksempelvis standard, bulk, subscription eller upgrade. Abonnementets duration angiver antal dage; øvrige produkters duration kan være null.
• volumeDiscounts er {minimumQuantity,discountPercent}[] og er [] for produkter der ikke er bulk. automaticDiscount er null eller {discountPercent,label}. priceQuote er null uden en gyldig EMS-pris.
• priceQuote har unitPrice, quantity, subtotal, discountPercent, discountAmount, total (tal), nextTier (rabattrin|null), discountSource (volume|automatic|code|null), discountLabel og discountCode (string|null). Bulk-overslaget bruger intervals; øvrige produkter bruger 1. Rabatter kombineres ikke: den største konkrete besparelse vælges.
• showBuyers er boolean. false giver tomme topBuyers/recentBuyers. Ellers vises højst fem topkøbere og seks forskellige nylige købere blandt de seneste 30 køb. Kun accepterede EMS-ordrer medtages, udbetalinger udelades, og spillerne skal være offentligt synlige og ikke skjult via vanish.
• Katalogets prisoverslag inkluderer mængde- og automatiske rabatter, men ikke en brugerindtastet rabatkode.

Katalogobjekt eller {error} ved ukendt server. checkout.currency er EMS; produkternes price/priceDKK kan være database-decimalstrenge, men priceQuote bruger tal.

{
  "checkout": {
    "version": 1,
    "currency": "EMS",
    "idempotency": true
  },
  "showBuyers": true,
  "topBuyers": [
    {
      "username": "EksempelSpiller",
      "uuid": "123e4567-e89b-42d3-a456-426614174001",
      "orders": 4,
      "items": 256,
      "spent": 720,
      "spentCurrency": "EMS",
      "lastPurchasedAt": "2026-10-01T12:00:00.000Z"
    }
  ],
  "recentBuyers": [
    {
      "username": "EksempelSpiller",
      "uuid": "123e4567-e89b-42d3-a456-426614174001",
      "productName": "Diamanter",
      "amount": 180,
      "currency": "EMS",
      "purchasedAt": "2026-10-01T12:00:00.000Z"
    }
  ],
  "categories": [
    {
      "uid": "resources",
      "name": "Ressourcer",
      "imageURL": null
    }
  ],
  "products": [
    {
      "uid": "diamonds",
      "name": "Diamanter",
      "type": "bulk",
      "duration": null,
      "intervals": 8,
      "price": "3.125",
      "priceDKK": null,
      "volumeDiscounts": [
        {
          "minimumQuantity": 64,
          "discountPercent": 10
        },
        {
          "minimumQuantity": 128,
          "discountPercent": 15
        }
      ],
      "description": "Diamanter til dine byggeprojekter.",
      "categoryUID": "resources",
      "imageURL": null,
      "automaticDiscount": null,
      "priceQuote": {
        "unitPrice": 3.125,
        "quantity": 8,
        "subtotal": 25,
        "discountPercent": 0,
        "discountAmount": 0,
        "total": 25,
        "nextTier": {
          "minimumQuantity": 64,
          "discountPercent": 10
        },
        "discountSource": null,
        "discountLabel": null,
        "discountCode": null
      }
    }
  ]
}

Værd at vide

• Oplysningerne opdateres normalt hvert minut. Hvis flere MOTD'er er aktive, kan en anden vælges ved næste opdatering.
• players er det samlede antal konti markeret som online, ikke antallet af offentligt synlige profiler.
• totalJoins tæller registrerede tilslutninger til servere og lobbyer, ikke unikke spillere.
• ip er null i den nuværende implementering. favicon, totalJoins, line1 og line2 starter som null; players starter ved 0.
• Hvis en opdatering mislykkes, kan de tidligere oplysninger fortsat være tilgængelige. Svaret indeholder ikke et opdateringstidspunkt.

Et øjebliksbillede af netværksinformationen. Felter kan være null ved opstart, eller når data ikke er tilgængelige.

{
  "favicon": null,
  "ip": null,
  "players": 12,
  "totalJoins": 12000,
  "line1": "Velkommen til Example-netværket",
  "line2": "Spil med dine venner"
}

Værd at vide

• Reglerne hentes fra den fælles dokumentkilde og gemmes i cache i fem minutter efter en vellykket hentning.
• Hvis hentningen mislykkes, indeholder svaret tidligere HTML eller html: null med HTTP 200. Fejl hos dokumentkilden har ingen særskilt statuskode.
• Svaret er application/json, selvom html-feltet indeholder et HTML-dokument.

html er en HTML-streng eller null, hvis reglerne endnu ikke er hentet.

{
  "html": "<html><body><h1>Eksempel på regler</h1><p>Vis respekt for andre spillere.</p></body></html>"
}

Værd at vide

• Ingen parametre kræves. Serveren er fast shoppylobby. Svaret omfatter begge handelsretninger; ruten har intet filter for item eller plot.
• B/buyPrice er prisen, spilleren betaler butikken. S/sellPrice er beløbet, butikken betaler spilleren. Prisen gælder amount items; divider nøjagtigt for at beregne prisen pr. item.
• Priser er decimalstrenge. null betyder, at handelsretningen ikke findes; 0 er et reelt tilbud. itemVariantKey er et fingeraftryk af itemet, ikke en billed-URL eller nødvendigvis itemId i historikruten.
• SOLD/RESELL og ikke-udløbne RENTED-regioner kan medtages. Kan ejerens UUID ikke kobles entydigt til en spiller, er playerID/username null, mens den gyldige ejer-UUID bevares.
• HTTP-svaret bruger Cache-Control: no-store. Backend genbruger normalt kataloget i 30 sekunder og kontrollerer udløb ved hvert kald. Spejlede data garanterer ikke, at varen er på lager.

Et katalog med server, hentetidspunkt og butikker.

{
  "server": "shoppylobby",
  "fetchedAt": "2030-06-01T12:00:00.000Z",
  "shops": [
    {
      "id": "3333333333333333333333333333333333333333333333333333333333333333",
      "server": "shoppylobby",
      "world": "world",
      "regionName": "example_plot",
      "regionType": "RENT",
      "owner": {
        "playerID": 42,
        "uuid": "00000000-0000-4000-8000-000000000001",
        "username": "ExamplePlayer"
      },
      "expiresAt": "2030-06-10T12:00:00.000Z",
      "min": {
        "x": 0,
        "y": 0,
        "z": 0
      },
      "max": {
        "x": 15,
        "y": 255,
        "z": 15
      },
      "syncedAt": "2030-06-01T11:00:00.000Z",
      "listings": [
        {
          "id": "4444444444444444444444444444444444444444444444444444444444444444",
          "server": "shoppylobby",
          "world": "world",
          "regionName": "example_plot",
          "x": 5,
          "y": 64,
          "z": 5,
          "item": "Coal",
          "itemMaterial": "COAL",
          "itemKey": "minecraft:coal",
          "itemJson": {
            "schemaVersion": 1,
            "id": "minecraft:coal",
            "material": "COAL",
            "iconKey": "coal",
            "amount": 64
          },
          "itemVariantKey": "2222222222222222222222222222222222222222222222222222222222222222",
          "amount": 64,
          "buyPrice": "8.00000000",
          "sellPrice": "4.00000000",
          "syncedAt": "2030-06-01T11:00:00.000Z"
        }
      ]
    }
  ]
}

Parametre

Værd at vide

• Kun direction og range accepteres som query-parametre; hver skal være en enkelt streng. Ukendte og gentagne parametre afvises.
• Historikjobbet kontrollerer hver 6. time og gemmer første pris samt ændringer i enhedsprisen. Ejer- eller mængdeskift til samme enhedspris giver ikke et nyt punkt.
• points kan være tomt. Første punkt kan være en tidligere måling lige før den valgte periode; dens recordedAt ændres ikke. from er null ved all.
• through går kun til sidste kendte historikopdatering. lastCheckedAt kan være null. Et bortfaldet tilbud er ikke et nul-prispunkt og dokumenterer ikke lager eller løbende tilgængelighed.
• price/amount beskriver den oprindelige handel. numerator/denominator angiver den præcise enhedspris som heltalsstrenge; undgå floating-point ved sammenligning.
• Der returneres højst 2.001 punkter, inklusive en mulig måling før perioden. Store perioder udvælger første, sidste, laveste og højeste ændring i kronologiske grupper over hele perioden; sampled/totalChanges beskriver udvalget.
• HTTP: Cache-Control: no-store. Backend kan genbruge det samme historiksvar i 120 sekunder. Alle tidsfelter er UTC.

Prishistorik med målegrænse og eventuelle registrerede prisændringer.

{
  "server": "shoppylobby",
  "itemId": "1111111111111111111111111111111111111111111111111111111111111111",
  "direction": "sell",
  "range": "1m",
  "fetchedAt": "2030-06-01T12:30:00.000Z",
  "from": "2030-05-01T12:30:00.000Z",
  "through": "2030-06-01T12:00:00.000Z",
  "lastCheckedAt": "2030-06-01T12:00:00.000Z",
  "sampled": false,
  "totalChanges": 1,
  "points": [
    {
      "recordedAt": "2030-06-01T06:00:00.000Z",
      "price": "8.00000000",
      "amount": 64,
      "numerator": "1",
      "denominator": "8",
      "owner": {
        "playerID": 42,
        "uuid": "00000000-0000-4000-8000-000000000001",
        "username": "ExamplePlayer"
      },
      "world": "world",
      "regionName": "example_plot"
    }
  ]
}

Parametre

Værd at vide

• API-nøglen bestemmer serveren. Disse ruter håndhæver ingen IP-begrænsning. Opbevar nøglen i serverkode.
• amount er ordretotalen; product.price er total/quantity. Bevar totalens værdi uden unødig floating-point-afrunding.
• Modtagerens uuid bruges til levering. Listen omfatter alle ventende ordrer for serveren; den har ingen parametre til sideinddeling eller datofiltrering.
• Brug kaldet fra serverintegrationen. Undgå browser/CDN-caching og automatiske linkvisninger: dette GET kan ændre saldi og abonnementsstatus.
• Items og kommandoer leveres af serverintegrationen; svaret bekræfter ikke i sig selv levering.

Ventende køb for nøglens server; product er et JSON-objekt.

[
  {
    "id": "EXAMPLE_ORDER_UID",
    "amount": "100.00",
    "uuid": "00000000-0000-4000-8000-000000000001",
    "product": {
      "type": "bulk",
      "id": "example_product",
      "name": "Eksempelpakke",
      "price": 25,
      "quantity": 4,
      "duration": null
    }
  }
]

Parametre

Værd at vide

• API-nøglen bestemmer serveren. Disse ruter håndhæver ingen IP-begrænsning. Opbevar nøglen i serverkode.
• Flere fejl returneres med HTTP 200 som JSON eller tekst. Kontroller svarindholdet, også når HTTP-status er 200.
• Der er intet idempotency-key-felt. Et allerede behandlet køb afvises med Purchase is not pending; en gentagelse returnerer ikke endnu en success-bekræftelse.
• Ruten leverer ikke selv Minecraft-items. Den kan ikke behandle udbetalingsordrer (payout) eller DKK-betalinger.

Content-Type: application/json

curl --request PUT 'https://api.superawesome.dk/storeapi/v2/purchases' \
  --header 'Accept: application/json' \
  --header 'Authorization: DIN_SERVER_API_NOGLE' \
  --header 'Content-Type: application/json' \
  --data-raw '{"purchase":"EXAMPLE_ORDER_UID"}'

Ordren blev behandlet.

success

Parametre

Værd at vide

• API-nøglen bestemmer serveren. Disse ruter håndhæver ingen IP-begrænsning. Opbevar nøglen i serverkode.
• Flere fejl returneres med HTTP 200 som JSON eller tekst. Kontroller svarindholdet, også når HTTP-status er 200.
• Tilbagebetalingen kommer fra den ventende ordres reserverede saldo. Udbetalingsordrer, DKK-ordrer og allerede behandlede ordrer afvises.
• Brug kun eksempel-id'er ved læsning af dokumentationen. Et rigtigt purchase-id påvirker en rigtig ordre og saldo.

Content-Type: application/json

curl --request PUT 'https://api.superawesome.dk/storeapi/purchases/decline' \
  --header 'Accept: application/json' \
  --header 'Authorization: DIN_SERVER_API_NOGLE' \
  --header 'Content-Type: application/json' \
  --data-raw '{"purchase":"EXAMPLE_ORDER_UID","reason":"Eksempel: varen kunne ikke leveres"}'

Ordren blev behandlet.

success

Parametre

Værd at vide

• API-nøglen bestemmer serveren. Disse ruter håndhæver ingen IP-begrænsning. Opbevar nøglen i serverkode.
• Flere fejl returneres med HTTP 200 som JSON eller tekst. Kontroller svarindholdet, også når HTTP-status er 200.
• Serverejerens aktive global/temp-ban blokerer udbetalingen; ejeren skal have tilstrækkelig saldo.
• Ruten har ingen idempotency-key eller beskyttelse mod gentagne kald. Gentagelse af et vellykket kald kan overføre penge igen.
• JSON-indholdet i eksemplet er opdigtet. Udfør kun kaldet som en tilsigtet udbetaling fra en betroet serverintegration.

Content-Type: application/json

curl --request POST 'https://api.superawesome.dk/storeapi/pay' \
  --header 'Accept: application/json' \
  --header 'Authorization: DIN_SERVER_API_NOGLE' \
  --header 'Content-Type: application/json' \
  --data-raw '{"target":"00000000-0000-4000-8000-000000000001","amount":10,"title":"Eksempeludbetaling","description":"Opdigtet eksempel uden rigtig udbetaling"}'

Udbetalingen blev gennemført.

success

Parametre

Værd at vide

• API-nøglen bestemmer serveren. Disse ruter håndhæver ingen IP-begrænsning. Opbevar nøglen i serverkode.
• Dagens stemmer og stemmer fra den seneste time medtages. Dagsgrænsen følger databasens dato. Feltet date i svaret er et Unix-tidspunkt i millisekunder.
• Dette GET markerer ikke stemmer som behandlet. Brug PUT /storeapi/v2/votes, efter serveren har givet belønningen.

Liste med stemme-id'er, spillere og tidspunkter.

[
  {
    "id": "EXAMPLE_VOTE_UID",
    "username": "ExamplePlayer",
    "uuid": "00000000-0000-4000-8000-000000000001",
    "date": 1893499200000
  }
]

Parametre

Værd at vide

• API-nøglen bestemmer serveren. Disse ruter håndhæver ingen IP-begrænsning. Opbevar nøglen i serverkode.
• Flere fejl returneres med HTTP 200 som JSON eller tekst. Kontroller svarindholdet, også når HTTP-status er 200.
• Votes fra andre servere ændres ikke. Ukendte id'er kan stadig give success: true, fordi affectedRows ikke kontrolleres.

Content-Type: application/json

curl --request PUT 'https://api.superawesome.dk/storeapi/v2/votes' \
  --header 'Accept: application/json' \
  --header 'Authorization: DIN_SERVER_API_NOGLE' \
  --header 'Content-Type: application/json' \
  --data-raw '{"votes":["EXAMPLE_VOTE_UID"]}'

Opdateringen blev udført; svaret angiver ikke antallet af resultater.

{
  "success": true
}

Parametre

Værd at vide

• API-nøglen bestemmer serveren. Disse ruter håndhæver ingen IP-begrænsning. Opbevar nøglen i serverkode.
• date er et Unix-tidspunkt i millisekunder. Der er ingen garanteret sortering eller parameter til at afgrænse historikken.

Stemmelisten.

[
  {
    "id": "EXAMPLE_VOTE_UID",
    "username": "ExamplePlayer",
    "uuid": "00000000-0000-4000-8000-000000000001",
    "date": 1893499200000
  }
]

Parametre

Værd at vide

• API-nøglen bestemmer serveren. Disse ruter håndhæver ingen IP-begrænsning. Opbevar nøglen i serverkode.
• Dagens stemmer og stemmer fra den seneste time medtages. Dagsgrænsen følger databasens dato. Feltet date i svaret er et Unix-tidspunkt i millisekunder.
• Ved flere resultater returneres en stemme uden garanteret sortering. Svaret markerer den ikke som behandlet; en ukendt servernøgle kan give No pending votes.

En matchende stemme.

{
  "id": "EXAMPLE_VOTE_UID",
  "username": "ExamplePlayer",
  "uuid": "00000000-0000-4000-8000-000000000001",
  "date": 1893499200000
}

Parametre

Værd at vide

• API-nøglen bestemmer serveren. Disse ruter håndhæver ingen IP-begrænsning. Opbevar nøglen i serverkode.
• Dagens stemmer og stemmer fra den seneste time medtages. Dagsgrænsen følger databasens dato. Feltet date i svaret er et Unix-tidspunkt i millisekunder.
• Svaret angiver ikke, om en belønning er leveret, eller om stemmen er behandlet.

Stemmestatus.

{
  "hasVoted": true
}

Værd at vide

• Opret appen i /dashboard/apps. Før produktionsgodkendelse kan kun app-ejeren give adgang til sine egne tilknyttede spillere. Nye scopes kræver app-godkendelse og nyt brugersamtykke.
• Alle OAuth-svar bruger Cache-Control: no-store. Maksimum er 120 OAuth-kald pr. IP i samme minut; ved 429 er Retry-After 60 sekunder.

Scope-katalog med ID, kategori og brugerrettet beskrivelse.

[
  {
    "id": "player:profile",
    "category": "Profil",
    "description": "Se dit UUID og brugernavn"
  },
  {
    "id": "player:balance",
    "category": "Profil",
    "description": "Se din emerald-balance"
  },
  {
    "id": "servers:read",
    "category": "Servere",
    "description": "Se dine servere"
  },
  {
    "id": "emeralds:transfer:request",
    "category": "Emeralds",
    "description": "Anmode om overførsler af dine emeralds, som du godkender enkeltvis"
  },
  {
    "id": "store:purchases:request",
    "category": "SA Store",
    "description": "Anmode om køb i SA Store med dine emeralds, som du godkender enkeltvis"
  },
  {
    "id": "shoppy:plots:read",
    "category": "Shoppy",
    "description": "Se dine Shoppy-plots"
  },
  {
    "id": "shoppy:chestshops:read",
    "category": "Shoppy",
    "description": "Se dine chestshops og priser i Shoppy"
  },
  {
    "id": "advertisements:read",
    "category": "Reklamer",
    "description": "Se dine reklamer, deres status og visninger"
  },
  {
    "id": "transporter:items:read",
    "category": "Transporter",
    "description": "Se dine items og antal i din transporter"
  },
  {
    "id": "mcmmo:read",
    "category": "MCMMO",
    "description": "Se dine MCMMO-levels og erfaring"
  }
]

Parametre

Værd at vide

• Efter godkendelse sendes code og state til den registrerede redirect_uri. Koden kan bruges én gang og udløber efter 60 sekunder. Ved afvisning sendes error=access_denied og state. Et forberedt samtykke udløber efter 10 minutter.
• Registrerede redirects kræver HTTPS, uden fragment eller brugeroplysninger. HTTP er kun tilladt på localhost, 127.0.0.1 og [::1]. Der bruges præcist match, uden jokertegn.
• Dette er OAuth 2.0 med fortrolige klienter og PKCE. Tokenudveksling kræver appens secret på backend. Der udstedes ikke et OpenID Connect ID-token.
• Alle OAuth-svar bruger Cache-Control: no-store. Maksimum er 120 OAuth-kald pr. IP i samme minut; ved 429 er Retry-After 60 sekunder.

Browseren sendes til SuperAwesomes samtykkeside. Query-parametrene følger med; klient, redirect og scopes valideres i flowet på siden.

Parametre

Værd at vide

• Send application/x-www-form-urlencoded. JSON understøttes også. HTTP Basic bruger base64 af URL-encoded client_id + ':' + URL-encoded client_secret; body-godkendelse er et alternativ.
• Access tokens lever højst 900 sekunder. Refresh-token og adgang udløber 90 dage efter det oprindelige samtykke; rotation forlænger ikke perioden. expires_in kan være kortere tæt på dette udløb.
• Gem det nye refresh-token atomisk og undgå samtidige refresh-kald. Gentag ikke blindt en forbrugt kode eller et refresh-token ved en netværksfejl; genbrug kan tilbagekalde adgangen.
• Alle OAuth-svar bruger Cache-Control: no-store. Maksimum er 120 OAuth-kald pr. IP i samme minut; ved 429 er Retry-After 60 sekunder.

Content-Type: application/x-www-form-urlencoded

curl --request POST 'https://api.superawesome.dk/oauth/token' \
  --header 'Accept: application/json' \
  --user 'DIT_CLIENT_ID:DIT_CLIENT_SECRET' \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data-urlencode 'grant_type=authorization_code' \
  --data-urlencode 'code=KODEN_FRA_CALLBACK' \
  --data-urlencode 'redirect_uri=https://example.com/oauth/callback' \
  --data-urlencode 'code_verifier=DIN_GEMTE_PKCE_VERIFIER_PAA_MINDST_43_TEGN_12345'

Nye opaque tokens. expires_in er access-tokenets resterende levetid i sekunder; ingen ID-token.

{
  "access_token": "DIT_NYE_ACCESS_TOKEN",
  "refresh_token": "DIT_NYE_REFRESH_TOKEN",
  "token_type": "Bearer",
  "expires_in": 900,
  "scope": "player:profile player:balance"
}

Parametre

Værd at vide

• Send application/x-www-form-urlencoded; JSON understøttes også. Spilleren kan også tilbagekalde adgang i kontrolpanelet.
• Alle OAuth-svar bruger Cache-Control: no-store. Maksimum er 120 OAuth-kald pr. IP i samme minut; ved 429 er Retry-After 60 sekunder.

Content-Type: application/x-www-form-urlencoded

curl --request POST 'https://api.superawesome.dk/oauth/revoke' \
  --header 'Accept: application/json' \
  --user 'DIT_CLIENT_ID:DIT_CLIENT_SECRET' \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data-urlencode 'token=DIT_ACCESS_ELLER_REFRESH_TOKEN'

Tomt JSON-objekt. Ukendte eller andre apps' tokens giver også 200 uden at ændre deres adgang.

{}

Værd at vide

• Brug et OAuth access token i Authorization: Bearer ACCESS_TOKEN. Tokenet gælder kun den Minecraft-spiller, brugeren valgte ved samtykke; der er intet player_id-parameter til at skifte spiller.
• Access tokens lever højst 15 minutter. En adgang kan tilbagekaldes af spilleren eller ved ændret app-godkendelse, mistet kontotilknytning eller rotation af appens secret.
• En godkendt app kan ansøge om flere scopes i /dashboard/apps. En sådan godkendelse bevarer eksisterende tokens med deres oprindelige rettigheder; nye scopes kræver et nyt OAuth-flow og spillerens samtykke.
• Alle OAuth-svar bruger Cache-Control: no-store. Maksimum er 120 OAuth-kald pr. IP i samme minut; ved 429 er Retry-After 60 sekunder.

Profil med player:profile alene. balance er udeladt.

{
  "id": "123",
  "uuid": "11111111-1111-4111-8111-111111111111",
  "username": "ExamplePlayer"
}

Værd at vide

• Brug et OAuth access token i Authorization: Bearer ACCESS_TOKEN. Tokenet gælder kun den Minecraft-spiller, brugeren valgte ved samtykke; der er intet player_id-parameter til at skifte spiller.
• Access tokens lever højst 15 minutter. En adgang kan tilbagekaldes af spilleren eller ved ændret app-godkendelse, mistet kontotilknytning eller rotation af appens secret.
• En godkendt app kan ansøge om flere scopes i /dashboard/apps. En sådan godkendelse bevarer eksisterende tokens med deres oprindelige rettigheder; nye scopes kræver et nyt OAuth-flow og spillerens samtykke.
• Alle OAuth-svar bruger Cache-Control: no-store. Maksimum er 120 OAuth-kald pr. IP i samme minut; ved 429 er Retry-After 60 sekunder.

Den valgte spillers balance.

{
  "balance": 1250
}

Parametre

Værd at vide

• Der returneres ingen servernøgler eller adgangsoplysninger. Listen omfatter både ejede servere og subuser-adgang; is_owner viser forskellen.
• Kun limit og offset accepteres. Ukendte parametre, gentagne værdier, decimaler og værdier uden for intervallet giver invalid_request.
• has_more viser, om der var flere resultater ved opslaget. Øg offset med limit for næste side. Datoer er ISO 8601 i UTC eller null; utilgængelige felter kan være null.
• Brug et OAuth access token i Authorization: Bearer ACCESS_TOKEN. Tokenet gælder kun den Minecraft-spiller, brugeren valgte ved samtykke; der er intet player_id-parameter til at skifte spiller.
• Access tokens lever højst 15 minutter. En adgang kan tilbagekaldes af spilleren eller ved ændret app-godkendelse, mistet kontotilknytning eller rotation af appens secret.
• En godkendt app kan ansøge om flere scopes i /dashboard/apps. En sådan godkendelse bevarer eksisterende tokens med deres oprindelige rettigheder; nye scopes kræver et nyt OAuth-flow og spillerens samtykke.
• Alle OAuth-svar bruger Cache-Control: no-store. Maksimum er 120 OAuth-kald pr. IP i samme minut; ved 429 er Retry-After 60 sekunder.

En side af spillerens servere, sorteret efter server-ID.

{
  "data": [
    {
      "id": "42",
      "name": "Example-SMP",
      "status": "online",
      "type": "survival",
      "version": "1.21.4",
      "is_owner": true,
      "created_at": "2026-10-07T12:00:00.000Z",
      "last_online_at": "2026-10-07T12:00:00.000Z",
      "motd": {
        "line1": "Velkommen",
        "line2": null
      }
    }
  ],
  "pagination": {
    "limit": 50,
    "offset": 0,
    "has_more": false
  }
}

Parametre

Værd at vide

• Omfatter SOLD og RESELL samt RENTED, hvor lejen ikke er udløbet. expires_at er kun udfyldt for leje; resell_price kun ved videresalg. Priser er decimaltekst eller null.
• Kun limit og offset accepteres. Ukendte parametre, gentagne værdier, decimaler og værdier uden for intervallet giver invalid_request.
• has_more viser, om der var flere resultater ved opslaget. Øg offset med limit for næste side. Datoer er ISO 8601 i UTC eller null; utilgængelige felter kan være null.
• Brug et OAuth access token i Authorization: Bearer ACCESS_TOKEN. Tokenet gælder kun den Minecraft-spiller, brugeren valgte ved samtykke; der er intet player_id-parameter til at skifte spiller.
• Access tokens lever højst 15 minutter. En adgang kan tilbagekaldes af spilleren eller ved ændret app-godkendelse, mistet kontotilknytning eller rotation af appens secret.
• En godkendt app kan ansøge om flere scopes i /dashboard/apps. En sådan godkendelse bevarer eksisterende tokens med deres oprindelige rettigheder; nye scopes kræver et nyt OAuth-flow og spillerens samtykke.
• Alle OAuth-svar bruger Cache-Control: no-store. Maksimum er 120 OAuth-kald pr. IP i samme minut; ved 429 er Retry-After 60 sekunder.

En side af aktive plots, sorteret efter world og region_name.

{
  "data": [
    {
      "server": "shoppylobby",
      "world": "world",
      "region_name": "shop_12",
      "type": "rent",
      "state": "RENTED",
      "min": {
        "x": 10,
        "y": 60,
        "z": 10
      },
      "max": {
        "x": 20,
        "y": 80,
        "z": 20
      },
      "expires_at": "2026-10-07T12:00:00.000Z",
      "price": "100.00",
      "rent_duration_ms": 604800000,
      "reselling": false,
      "resell_price": null,
      "synced_at": "2026-10-07T12:00:00.000Z"
    }
  ],
  "pagination": {
    "limit": 50,
    "offset": 0,
    "has_more": false
  }
}

Parametre

Værd at vide

• Ejerskab følger chestshoppens skilt; spilleren behøver ikke eje plottet. Kun butikker i aktive plots medtages. Rå item-data, YAML og skiltlinjer returneres ikke.
• buy_price og sell_price er decimaltekst eller null. null betyder, at en gyldig pris ikke er tilgængelig for den retning.
• Kun limit og offset accepteres. Ukendte parametre, gentagne værdier, decimaler og værdier uden for intervallet giver invalid_request.
• has_more viser, om der var flere resultater ved opslaget. Øg offset med limit for næste side. Datoer er ISO 8601 i UTC eller null; utilgængelige felter kan være null.
• Brug et OAuth access token i Authorization: Bearer ACCESS_TOKEN. Tokenet gælder kun den Minecraft-spiller, brugeren valgte ved samtykke; der er intet player_id-parameter til at skifte spiller.
• Access tokens lever højst 15 minutter. En adgang kan tilbagekaldes af spilleren eller ved ændret app-godkendelse, mistet kontotilknytning eller rotation af appens secret.
• En godkendt app kan ansøge om flere scopes i /dashboard/apps. En sådan godkendelse bevarer eksisterende tokens med deres oprindelige rettigheder; nye scopes kræver et nyt OAuth-flow og spillerens samtykke.
• Alle OAuth-svar bruger Cache-Control: no-store. Maksimum er 120 OAuth-kald pr. IP i samme minut; ved 429 er Retry-After 60 sekunder.

En side af chestshops, sorteret efter world, region og skiltets koordinater.

{
  "data": [
    {
      "server": "shoppylobby",
      "world": "world",
      "region_name": "shop_12",
      "position": {
        "x": 12,
        "y": 64,
        "z": 14
      },
      "item": "DIAMOND",
      "item_material": "DIAMOND",
      "item_key": "minecraft:diamond",
      "item_json": null,
      "amount": 1,
      "buy_price": "100.00",
      "sell_price": "80.00",
      "admin_shop": false,
      "synced_at": "2026-10-07T12:00:00.000Z"
    }
  ],
  "pagination": {
    "limit": 50,
    "offset": 0,
    "has_more": false
  }
}

Parametre

Værd at vide

• remaining_views er max(0, total_views − views), eller null når tællerne ikke er tilgængelige. image indeholder kun ID, afvisningsårsag og datoer; ingen billedfil.
• Kun limit og offset accepteres. Ukendte parametre, gentagne værdier, decimaler og værdier uden for intervallet giver invalid_request.
• has_more viser, om der var flere resultater ved opslaget. Øg offset med limit for næste side. Datoer er ISO 8601 i UTC eller null; utilgængelige felter kan være null.
• Brug et OAuth access token i Authorization: Bearer ACCESS_TOKEN. Tokenet gælder kun den Minecraft-spiller, brugeren valgte ved samtykke; der er intet player_id-parameter til at skifte spiller.
• Access tokens lever højst 15 minutter. En adgang kan tilbagekaldes af spilleren eller ved ændret app-godkendelse, mistet kontotilknytning eller rotation af appens secret.
• En godkendt app kan ansøge om flere scopes i /dashboard/apps. En sådan godkendelse bevarer eksisterende tokens med deres oprindelige rettigheder; nye scopes kræver et nyt OAuth-flow og spillerens samtykke.
• Alle OAuth-svar bruger Cache-Control: no-store. Maksimum er 120 OAuth-kald pr. IP i samme minut; ved 429 er Retry-After 60 sekunder.

En side af reklamer, nyeste først. Statusværdier returneres som tekst; image er metadata eller null.

{
  "data": [
    {
      "id": "33333333-3333-4333-8333-333333333333",
      "title": "Spil på Example-SMP",
      "text": "Kom og byg med os",
      "draft": false,
      "status": "approved",
      "denial_reason": null,
      "created_at": "2026-10-07T12:00:00.000Z",
      "total_views": 1000,
      "views": 250,
      "remaining_views": 750,
      "server": {
        "name": "Example-SMP",
        "status": "online"
      },
      "image": null
    }
  ],
  "pagination": {
    "limit": 50,
    "offset": 0,
    "has_more": false
  }
}

Parametre

Værd at vide

• Hver række indeholder material og amount. amount er et positivt heltal inden for JavaScripts sikre heltalsinterval eller null, hvis den gemte værdi er ugyldig. Utilgængelige material-værdier vises som null. Kaldet viser spillerens beholdning og kan ikke flytte items.
• material er det gemte item-ID, normalt med små bogstaver som diamond; ældre aliases bevares. amount tæller enkelte items, ikke stacks.
• Beholdningen caches i Redis i højst 30 sekunder fra observationen og kan derfor være op til 30 sekunder gammel. Sider caches særskilt for den valgte spiller, limit og offset. Hvis Redis er utilgængelig, hentes data fra databasen.
• Token, tilbagekaldelse, scopes og adgang til den valgte spiller kontrolleres ved hvert kald, også når data hentes fra cache. HTTP-svaret bruger fortsat Cache-Control: no-store. Der returneres ingen cache-tidsstempler.
• Kun limit og offset accepteres. Ukendte parametre, gentagne værdier, decimaler og værdier uden for intervallet giver invalid_request.
• has_more viser, om der var flere resultater ved opslaget. Øg offset med limit for næste side. Datoer er ISO 8601 i UTC eller null; utilgængelige felter kan være null.
• Brug et OAuth access token i Authorization: Bearer ACCESS_TOKEN. Tokenet gælder kun den Minecraft-spiller, brugeren valgte ved samtykke; der er intet player_id-parameter til at skifte spiller.
• Access tokens lever højst 15 minutter. En adgang kan tilbagekaldes af spilleren eller ved ændret app-godkendelse, mistet kontotilknytning eller rotation af appens secret.
• En godkendt app kan ansøge om flere scopes i /dashboard/apps. En sådan godkendelse bevarer eksisterende tokens med deres oprindelige rettigheder; nye scopes kræver et nyt OAuth-flow og spillerens samtykke.
• Alle OAuth-svar bruger Cache-Control: no-store. Maksimum er 120 OAuth-kald pr. IP i samme minut; ved 429 er Retry-After 60 sekunder.

En side af transporter-items med positive gemte antal, sorteret efter material.

{
  "data": [
    {
      "material": "diamond",
      "amount": 64
    }
  ],
  "pagination": {
    "limit": 50,
    "offset": 0,
    "has_more": false
  }
}

Værd at vide

• skills indeholder gemte levels for 17 færdigheder samt det gemte total. experience indeholder gemt XP optjent på det nuværende level for de samme 17 færdigheder. total hentes fra den gemte værdi og beregnes ikke af API’et.
• Hvis spillerens MCMMO-bruger mangler, er begge sektioner null. Hvis en skills- eller experience-datarække mangler, er den pågældende sektion null; manglende data erstattes ikke med nulværdier.
• En feltværdi er et ikke-negativt sikkert heltal eller null, hvis den gemte værdi er ugyldig. Svaret indeholder kun skills og experience. Kaldet tager ingen query-parametre og har ingen sideinddeling.
• Brug et OAuth access token i Authorization: Bearer ACCESS_TOKEN. Tokenet gælder kun den Minecraft-spiller, brugeren valgte ved samtykke; der er intet player_id-parameter til at skifte spiller.
• Access tokens lever højst 15 minutter. En adgang kan tilbagekaldes af spilleren eller ved ændret app-godkendelse, mistet kontotilknytning eller rotation af appens secret.
• En godkendt app kan ansøge om flere scopes i /dashboard/apps. En sådan godkendelse bevarer eksisterende tokens med deres oprindelige rettigheder; nye scopes kræver et nyt OAuth-flow og spillerens samtykke.
• Alle OAuth-svar bruger Cache-Control: no-store. Maksimum er 120 OAuth-kald pr. IP i samme minut; ved 429 er Retry-After 60 sekunder.

Gemte levels i skills og gemt XP på færdighedens nuværende level i experience. Alle felter i en tilgængelig sektion medtages.

{
  "skills": {
    "taming": 1,
    "mining": 2,
    "woodcutting": 3,
    "repair": 4,
    "unarmed": 5,
    "herbalism": 6,
    "excavation": 7,
    "archery": 8,
    "swords": 9,
    "axes": 10,
    "acrobatics": 11,
    "fishing": 12,
    "alchemy": 13,
    "crossbows": 14,
    "tridents": 15,
    "maces": 16,
    "spears": 17,
    "total": 153
  },
  "experience": {
    "taming": 100,
    "mining": 200,
    "woodcutting": 300,
    "repair": 400,
    "unarmed": 500,
    "herbalism": 600,
    "excavation": 700,
    "archery": 800,
    "swords": 900,
    "axes": 1000,
    "acrobatics": 1100,
    "fishing": 1200,
    "alchemy": 1300,
    "crossbows": 1400,
    "tridents": 1500,
    "maces": 1600,
    "spears": 1700
  }
}

Parametre

Værd at vide

• Send JSON. Ved retry skal samme idempotency_key, modtager, beløb, trimmet beskrivelse og expires_in bruges. Svaret bevarer det oprindelige ID og udløb, også hvis anmodningen allerede er besluttet eller udløbet. Brug en ny nøgle til en ny betaling.
• Anmodningen gælder den præcise OAuth-adgang og valgte spiller. Den kan kun hentes med et aktuelt token for samme adgang; en ny login-adgang får ikke adgang til gamle anmodninger.
• expiresAt er det tidligste af oprettelsestid + expires_in og adgangens oprindelige 90-dages udløb. En pending anmodning vises som expired efter udløb; approved og rejected bevarer deres status.
• Redirect spilleren til approval_url. Spilleren skal logge ind og godkende beløb, modtager og beskrivelse, før emeralds overføres. Status aflæses via GET; der er ingen callback-URL eller webhook for denne anmodning.
• Brug et OAuth access token i Authorization: Bearer ACCESS_TOKEN. Tokenet gælder kun den Minecraft-spiller, brugeren valgte ved samtykke; der er intet player_id-parameter til at skifte spiller.
• Access tokens lever højst 15 minutter. En adgang kan tilbagekaldes af spilleren eller ved ændret app-godkendelse, mistet kontotilknytning eller rotation af appens secret.
• En godkendt app kan ansøge om flere scopes i /dashboard/apps. En sådan godkendelse bevarer eksisterende tokens med deres oprindelige rettigheder; nye scopes kræver et nyt OAuth-flow og spillerens samtykke.
• Alle OAuth-svar bruger Cache-Control: no-store. Maksimum er 120 OAuth-kald pr. IP i samme minut; ved 429 er Retry-After 60 sekunder.

Content-Type: application/json

curl --request POST 'https://api.superawesome.dk/oauth/v1/emerald-transfers' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer DIT_OAUTH_ACCESS_TOKEN' \
  --header 'Content-Type: application/json' \
  --data-raw '{"recipient_uuid":"22222222-2222-4222-8222-222222222222","amount":100,"description":"Betaling for en Shoppy-handel","expires_in":900,"idempotency_key":"order-2026-0001"}'

Ny anmodning eller den eksisterende anmodning ved et identisk retry. Beløb returneres som tekst.

{
  "id": "EXAMPLE_TRANSFER_ID_REPLACE_WITH_RESPONSE_ID",
  "app": {
    "name": "ExampleApp",
    "logoUrl": "https://example.com/logo.png"
  },
  "sender": {
    "uuid": "11111111-1111-4111-8111-111111111111",
    "username": "ExamplePlayer"
  },
  "recipient": {
    "uuid": "22222222-2222-4222-8222-222222222222",
    "username": "ExampleRecipient"
  },
  "amount": "100",
  "description": "Betaling for en Shoppy-handel",
  "expiresAt": "2026-10-07T12:15:00.000Z",
  "status": "pending",
  "approval_url": "https://superawesome.dk/oauth/transfer/EXAMPLE_TRANSFER_ID_REPLACE_WITH_RESPONSE_ID"
}

Parametre

Værd at vide

• Et udløbet eller tilbagekaldt OAuth-token giver 401, selvom anmodningen stadig findes. Godkendelsessiden kan afvise ved udløb, manglende saldo, spillerban eller modtagerens saldoloft; spilleren ser fejlen dér, og anmodningen godkendes ikke.
• Anmodningen gælder den præcise OAuth-adgang og valgte spiller. Den kan kun hentes med et aktuelt token for samme adgang; en ny login-adgang får ikke adgang til gamle anmodninger.
• expiresAt er det tidligste af oprettelsestid + expires_in og adgangens oprindelige 90-dages udløb. En pending anmodning vises som expired efter udløb; approved og rejected bevarer deres status.
• Redirect spilleren til approval_url. Spilleren skal logge ind og godkende beløb, modtager og beskrivelse, før emeralds overføres. Status aflæses via GET; der er ingen callback-URL eller webhook for denne anmodning.
• Brug et OAuth access token i Authorization: Bearer ACCESS_TOKEN. Tokenet gælder kun den Minecraft-spiller, brugeren valgte ved samtykke; der er intet player_id-parameter til at skifte spiller.
• Access tokens lever højst 15 minutter. En adgang kan tilbagekaldes af spilleren eller ved ændret app-godkendelse, mistet kontotilknytning eller rotation af appens secret.
• En godkendt app kan ansøge om flere scopes i /dashboard/apps. En sådan godkendelse bevarer eksisterende tokens med deres oprindelige rettigheder; nye scopes kræver et nyt OAuth-flow og spillerens samtykke.
• Alle OAuth-svar bruger Cache-Control: no-store. Maksimum er 120 OAuth-kald pr. IP i samme minut; ved 429 er Retry-After 60 sekunder.

Anmodningens aktuelle status og oprindelige oplysninger. approved betyder, at overførslen er gennemført.

{
  "id": "EXAMPLE_TRANSFER_ID_REPLACE_WITH_RESPONSE_ID",
  "app": {
    "name": "ExampleApp",
    "logoUrl": "https://example.com/logo.png"
  },
  "sender": {
    "uuid": "11111111-1111-4111-8111-111111111111",
    "username": "ExamplePlayer"
  },
  "recipient": {
    "uuid": "22222222-2222-4222-8222-222222222222",
    "username": "ExampleRecipient"
  },
  "amount": "100",
  "description": "Betaling for en Shoppy-handel",
  "expiresAt": "2026-10-07T12:15:00.000Z",
  "status": "approved",
  "approval_url": "https://superawesome.dk/oauth/transfer/EXAMPLE_TRANSFER_ID_REPLACE_WITH_RESPONSE_ID"
}

Parametre

Værd at vide

• Send JSON. Identiske retries returnerer 201 med oprindeligt ID og udløb samt aktuel quote, status og udløb, også efter godkendelse, afvisning eller udløb. Spillerens ændring af rabatkoden ændrer ikke den oprindelige payloads idempotens. En ændret payload med samme nøgle giver 409 idempotency_conflict. Brug en ny nøgle til et nyt køb.
• quote indeholder tal, ikke decimalstrenge. subtotal er unitPrice × quantity; discountAmount og total følger SA Stores prisberegning. discountSource er volume, automatic, code eller null; rabatter kombineres ikke. Saldo kontrolleres ved spillerens godkendelse, ikke ved oprettelsen.
• Find serverens navn og produktets uid, type og intervals i GET /servers/{name}/store. quantity er 1 for standard, subscription og upgrade. For bulk skal quantity følge produktets intervals og købsgrænser.
• Den valgte OAuth-spiller betaler og modtager produktet. Appen kan ikke vælge en anden betaler/modtager, en egen pris eller DKK. Prisen beregnes af SA Store med gældende mængde-, automatiske og eventuelle kode-rabatter.
• Anmodningen er knyttet til den præcise OAuth-adgang og valgte spiller. Et aktuelt token fra en anden adgang kan ikke læse den. expiresAt er det tidligste af oprettelse + expires_in og adgangens oprindelige 90-dages udløb.
• Redirect spilleren til approval_url. Spilleren kan indtaste eller fjerne en rabatkode og se en opdateret quote, før produkt, antal, pris og beskrivelse godkendes. Abonnementer viser periodens pris og automatiske fornyelse, som fortsætter indtil annullering i spillerens abonnementer.
• discountCode er den aktuelt valgte kode; quote.discountCode er den kode, som faktisk giver rabatten, eller null når en bedre mængde- eller automatisk rabat vælges. quote_revision stiger ved opdatering af pris eller kode. Et GET eller et identisk retry kan derfor vise spillerens seneste quote.
• Ved godkendelse kontrolleres produkt, pris, rabatter, kontotilknytning, ban, saldo og købsgrænser igen. Produktvilkår, som er ændret, kræver en ny anmodning. En ændret pris kan spilleren opdatere og gennemse på godkendelsessiden. Den viste quote ændres ikke automatisk, og en ældre side kan ikke godkende en nyere quote.
• approved betyder, at en SA Store-ordre er oprettet og emeralds reserveret. order.state viser pending, accepted eller denied. accepted betyder, at serveren har accepteret ordren; det garanterer ikke i sig selv levering af items/kommandoer. SA Store håndterer afvisning og tilbagebetaling.
• Status aflæses via GET; der er ingen callback eller webhook. En udløbet pending anmodning vises som expired. Godkendelse kan gentages uden en ekstra ordre eller ekstra debitering; den eksisterende ordre returneres.
• Brug et OAuth access token i Authorization: Bearer ACCESS_TOKEN. Tokenet gælder kun den Minecraft-spiller, brugeren valgte ved samtykke; der er intet player_id-parameter til at skifte spiller.
• Access tokens lever højst 15 minutter. En adgang kan tilbagekaldes af spilleren eller ved ændret app-godkendelse, mistet kontotilknytning eller rotation af appens secret.
• En godkendt app kan ansøge om flere scopes i /dashboard/apps. En sådan godkendelse bevarer eksisterende tokens med deres oprindelige rettigheder; nye scopes kræver et nyt OAuth-flow og spillerens samtykke.
• Alle OAuth-svar bruger Cache-Control: no-store. Maksimum er 120 OAuth-kald pr. IP i samme minut; ved 429 er Retry-After 60 sekunder.

Content-Type: application/json

curl --request POST 'https://api.superawesome.dk/oauth/v1/store-purchases' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer DIT_OAUTH_ACCESS_TOKEN' \
  --header 'Content-Type: application/json' \
  --data-raw '{"server_name":"EksempelSMP","product_uid":"diamonds","quantity":16,"description":"16 diamanter til dit byggeprojekt","expires_in":900,"idempotency_key":"store-order-2026-0001"}'

Ny anmodning eller identisk retry med oprindeligt ID og udløb samt aktuel quote. order er null indtil godkendelse.

{
  "id": "EXAMPLE_STORE_PURCHASE_ID_REPLACE_WITH_RESPONSE_ID",
  "app": {
    "name": "ExampleApp",
    "logoUrl": "https://example.com/logo.png"
  },
  "player": {
    "uuid": "11111111-1111-4111-8111-111111111111",
    "username": "ExamplePlayer"
  },
  "server": {
    "name": "EksempelSMP"
  },
  "product": {
    "uid": "diamonds",
    "name": "Diamanter",
    "type": "bulk",
    "duration": null,
    "intervals": 8
  },
  "quantity": 16,
  "currency": "EMS",
  "discountCode": null,
  "quote_revision": 1,
  "quote": {
    "unitPrice": 3.125,
    "quantity": 16,
    "subtotal": 50,
    "discountPercent": 10,
    "discountAmount": 5,
    "total": 45,
    "nextTier": null,
    "discountSource": "volume",
    "discountLabel": "Mængderabat",
    "discountCode": null
  },
  "description": "16 diamanter til dit byggeprojekt",
  "expiresAt": "2026-10-07T12:15:00.000Z",
  "status": "pending",
  "approval_url": "https://superawesome.dk/oauth/store-purchase/EXAMPLE_STORE_PURCHASE_ID_REPLACE_WITH_RESPONSE_ID",
  "order": null
}

Parametre

Værd at vide

• Find serverens navn og produktets uid, type og intervals i GET /servers/{name}/store. quantity er 1 for standard, subscription og upgrade. For bulk skal quantity følge produktets intervals og købsgrænser.
• Den valgte OAuth-spiller betaler og modtager produktet. Appen kan ikke vælge en anden betaler/modtager, en egen pris eller DKK. Prisen beregnes af SA Store med gældende mængde-, automatiske og eventuelle kode-rabatter.
• Anmodningen er knyttet til den præcise OAuth-adgang og valgte spiller. Et aktuelt token fra en anden adgang kan ikke læse den. expiresAt er det tidligste af oprettelse + expires_in og adgangens oprindelige 90-dages udløb.
• Redirect spilleren til approval_url. Spilleren kan indtaste eller fjerne en rabatkode og se en opdateret quote, før produkt, antal, pris og beskrivelse godkendes. Abonnementer viser periodens pris og automatiske fornyelse, som fortsætter indtil annullering i spillerens abonnementer.
• discountCode er den aktuelt valgte kode; quote.discountCode er den kode, som faktisk giver rabatten, eller null når en bedre mængde- eller automatisk rabat vælges. quote_revision stiger ved opdatering af pris eller kode. Et GET eller et identisk retry kan derfor vise spillerens seneste quote.
• Ved godkendelse kontrolleres produkt, pris, rabatter, kontotilknytning, ban, saldo og købsgrænser igen. Produktvilkår, som er ændret, kræver en ny anmodning. En ændret pris kan spilleren opdatere og gennemse på godkendelsessiden. Den viste quote ændres ikke automatisk, og en ældre side kan ikke godkende en nyere quote.
• approved betyder, at en SA Store-ordre er oprettet og emeralds reserveret. order.state viser pending, accepted eller denied. accepted betyder, at serveren har accepteret ordren; det garanterer ikke i sig selv levering af items/kommandoer. SA Store håndterer afvisning og tilbagebetaling.
• Status aflæses via GET; der er ingen callback eller webhook. En udløbet pending anmodning vises som expired. Godkendelse kan gentages uden en ekstra ordre eller ekstra debitering; den eksisterende ordre returneres.
• Brug et OAuth access token i Authorization: Bearer ACCESS_TOKEN. Tokenet gælder kun den Minecraft-spiller, brugeren valgte ved samtykke; der er intet player_id-parameter til at skifte spiller.
• Access tokens lever højst 15 minutter. En adgang kan tilbagekaldes af spilleren eller ved ændret app-godkendelse, mistet kontotilknytning eller rotation af appens secret.
• En godkendt app kan ansøge om flere scopes i /dashboard/apps. En sådan godkendelse bevarer eksisterende tokens med deres oprindelige rettigheder; nye scopes kræver et nyt OAuth-flow og spillerens samtykke.
• Alle OAuth-svar bruger Cache-Control: no-store. Maksimum er 120 OAuth-kald pr. IP i samme minut; ved 429 er Retry-After 60 sekunder.

Aktuel status og quote. Her er købet godkendt, mens ordren afventer serverens behandling.

{
  "id": "EXAMPLE_STORE_PURCHASE_ID_REPLACE_WITH_RESPONSE_ID",
  "app": {
    "name": "ExampleApp",
    "logoUrl": "https://example.com/logo.png"
  },
  "player": {
    "uuid": "11111111-1111-4111-8111-111111111111",
    "username": "ExamplePlayer"
  },
  "server": {
    "name": "EksempelSMP"
  },
  "product": {
    "uid": "diamonds",
    "name": "Diamanter",
    "type": "bulk",
    "duration": null,
    "intervals": 8
  },
  "quantity": 16,
  "currency": "EMS",
  "discountCode": null,
  "quote_revision": 1,
  "quote": {
    "unitPrice": 3.125,
    "quantity": 16,
    "subtotal": 50,
    "discountPercent": 10,
    "discountAmount": 5,
    "total": 45,
    "nextTier": null,
    "discountSource": "volume",
    "discountLabel": "Mængderabat",
    "discountCode": null
  },
  "description": "16 diamanter til dit byggeprojekt",
  "expiresAt": "2026-10-07T12:15:00.000Z",
  "status": "approved",
  "approval_url": "https://superawesome.dk/oauth/store-purchase/EXAMPLE_STORE_PURCHASE_ID_REPLACE_WITH_RESPONSE_ID",
  "order": {
    "uid": "EXAMPLE_ORDER_UID",
    "state": "pending",
    "currency": "EMS",
    "amount": 45,
    "quantity": 16,
    "productName": "Diamanter"
  }
}