HammerTime Beta

APIアクセス

タイムスタンプの生成とアプリの設定の変更を自分のプログラムで行うための機能です。各アプリコマンドに対応するエンドポイントが提供されており、リクエストはキーを作成したDiscordアカウントの設定に従って処理されます。

APIキー

APIキーを作成するにはログインが必要です。キーはあなたのプロフィールにリンクした一つのDiscordアカウントとして機能します。

APIの使い方

AuthorizationヘッダーにBearerトークンとしてキーを含めてリクエストを送信してください。

下記の例では、保存されたタイムゾーンにおける今日の18:30のタイムスタンプが返ります。例の中のキーは架空のものであり、実際にはご自身のキーを使用する必要があります。

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

権限

キーには作成時に付与された権限を保有しており、このページではこれ以降以下のコードによって各権限を表現します。

すべてのキーはGET/meを呼び出すことで自身の持つ権限を確認でき、これは権限に関係なく実行可能です。

権限許可する内容
timestamps:createタイムスタンプエンドポイントとMCPツールを用いたタイムスタンプの生成を可能にします。このときキーがDiscordアカウントとして機能し、生成はこのアカウントとして行われます。
settings:readそのアカウントのアプリ設定の読み取りを可能にします。
settings:writeそのアカウントのアプリ設定の変更を可能にします。ここで、変更は送信されたフィールドにのみ適用されます。

リクエストにはキー単位で速度制限が適用されています。各レスポンスのRateLimitヘッダーでは現在の状態が、429レスポンスではRetry-Afterヘッダーが提供されます。

実行回数はアプリコマンドと同様に計上され、アプリの設定でテレメトリをオフにしていない限り、応答メッセージに何回目の実行であったかが表示されます。

エンドポイントの仕様書

全エンドポイントと、それぞれが要求するフィールド・与えるレスポンスの一覧です。これはAPIサーバーのOpenAPI仕様書から読みこまれているため、実行中のバージョンと常に一致しているはずです。

ベースURL

クリップボードにコピーhttps://api.hammertime.cyou
インタラクティブな仕様書OpenAPI形式の仕様書

エラー

すべてのエラーは以下の形式の本文を持ちます。ステータスコードはエラーの種類を、error.code は具体的な理由を示します。

{
"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": {},object任意Values interpolated into the message
"issues": [object[]任意For 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

MCPサーバーの使い方

MCPサーバーではStreamable HTTPトランスポートおよび共通のキーを使用します。コマンドごとに一つのツールと設定が提供され、キーの権限で許可されているツールのみが利用可能です。

サーバーURL

クリップボードにコピーhttps://api.hammertime.cyou/mcp
下記の中のキーは架空のものであり、実際には機能しません。ご自身のキーに置き換えてください。

Claude Codeに追加するコマンドの例：

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

その他のクライアントも同様の構成を使用しており、以下の形式のURLとAuthorizationヘッダーを使用しています。

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