HammerTime Beta

API Zugriff

Erstellen Sie Zeitstempel und ändern Sie die Einstellungen Ihrer App über Ihre eigenen Programme. Jeder Endpunkt entspricht einem App-Befehl, und die Anfragen richten sich nach den Einstellungen des Discord-Kontos, für das der Schlüssel erstellt wurde.

API-Schlüssel

Melden Sie sich an, um API-Schlüssel zu erstellen. Die Schlüssel fungieren als eines der mit Ihrem Profil verknüpften Discord-Konten.

Verwendung der API

Senden Sie Ihren Schlüssel als „Bearer-Token“ im „Authorization“-Header jeder Anfrage.

Dies gibt den Zeitstempel für heute um 18:30 Uhr in Ihrer gespeicherten Zeitzone zurück. Der Schlüssel in den Beispielen ist frei erfunden, verwenden Sie Ihren eigenen:

curl https://api.hammertime.cyou/at \
  -H "Authorization: Bearer 42|htk_qqXmIwpKxbAe3zYntwsLqK83wcKzbjD34M0yjsV9a698cb93" \
  -H "Content-Type: application/json" \
  -d '{"hour": 18, "minute": 30}'

Berechtigungen

Ein Schlüssel verfügt über die Berechtigungen, mit denen er erstellt wurde, und im weiteren Verlauf dieser Seite wird unter Verwendung dieser Codes auf diesen Bezug genommen.

Jeder Schlüssel kann unabhängig von seinen Berechtigungen die Funktion GET/me aufrufen, um herauszufinden, über welche Berechtigungen er verfügt.

BerechtigungErmöglicht
timestamps:createErstellung von Zeitstempeln mithilfe des Zeitstempel-Endpunkts und der MCP-Tools, wobei der Schlüssel als Discord-Konto fungiert.
settings:readLesen der App-Einstellungen dieses Kontos.
settings:writeÄndern der App-Einstellungen dieses Kontos, nur die gesendeten Felder.

Die Anzahl der Anfragen pro Schlüssel ist begrenzt. Die „RateLimit“-Header jeder Antwort geben Auskunft über den aktuellen Status, und eine 429-Antwort enthält einen „Retry-After“-Header.

Läufe werden wie App-Befehle gezählt, und in der Antwort wird angegeben, um welchen Lauf es sich handelte, sofern Sie die Telemetrie nicht in Ihren App-Einstellungen deaktiviert haben.

Endpunktreferenz

Jeder Endpunkt mit den von ihm akzeptierten Feldern und den von ihm zurückgegebenen Antworten. Diese Informationen werden aus der OpenAPI-Spezifikation des API-Servers ausgelesen, sodass sie stets mit der aktuell ausgeführten Version übereinstimmen.

Basis-URL

In Zwischenablage kopierenhttps://api.hammertime.cyou
Interactive referenceOpenAPI specification

Fehler

Jede Fehlerantwort enthält diesen Textkörper. Der Statuscode gibt an, um welche Art von Fehler es sich handelt, und „error.code“ nennt den genauen Grund.

{
"error": {object
"code": "commands.at.responses.hourRange",stringMachine-readable reason. For rejected command input this is the bot's locale key, e.g. commands.at.responses.hourRange
"message": "When a meridiem is not specified, hour must be a number between 0 and 23",stringEnglish explanation, the same text the Discord bot replies with
"params": {},objectoptionalValues interpolated into the message
"issues": [object[]optionalFor invalid_request: what is wrong with which field
{
"path": "string",string
"message": "string"string
}
]
}
}

timestamps

Bot commands as endpoints

settings

The bot settings of the account

keys

About the API key in use

server info

Service status

Verwendung des MCP-Servers

Der MCP-Server nutzt den Streamable-HTTP-Transport und dieselben Schlüssel. Er bietet pro Befehl ein Tool sowie entsprechende Einstellungen an, und zwar ausschließlich die Tools, für die die Berechtigungen Ihres Schlüssels gelten.

Server URL

In Zwischenablage kopierenhttps://api.hammertime.cyou/mcp
Der Schlüssel in den folgenden Beispielen ist frei erfunden und funktioniert nicht. Ersetzen Sie ihn durch einen Ihrer eigenen Schlüssel.

Zu Claude Code hinzufügen mit:

claude mcp add --transport http hammertime https://api.hammertime.cyou/mcp \
  --header "Authorization: Bearer 42|htk_qqXmIwpKxbAe3zYntwsLqK83wcKzbjD34M0yjsV9a698cb93"

Andere Clients verwenden eine ähnliche Konfiguration mit der URL und einem „Authorization“-Header:

{
  "mcpServers": {
    "hammertime": {
      "type": "http",
      "url": "https://api.hammertime.cyou/mcp",
      "headers": {
        "Authorization": "Bearer 42|htk_qqXmIwpKxbAe3zYntwsLqK83wcKzbjD34M0yjsV9a698cb93"
      }
    }
  }
}