HammerTime Beta

Доступ через API

Генерируйте временные метки и изменяйте настройки приложения из ваших собственных программ. Каждая конечная точка соответствует команде приложения, а запросы обрабатываются в соответствии с настройками учетной записи Discord, для которой был создан ключ.

Ключи API

Войдите в систему, чтобы создать ключи API. Эти ключи выступают в качестве одной из учетных записей Discord, привязанных к вашему профилю.

Использование API

Отправляйте свой ключ в виде токена «bearer» в заголовке «Authorization» каждого запроса.

Эта команда возвращает временную метку, соответствующую 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Генерация временных меток с помощью конечных точек timestamp и инструментов MCP, при этом ключ выступает в качестве учетной записи Discord.
settings:readСчитывание настроек приложения для данной учетной записи.
settings:writeИзменение настроек приложения для этой учетной записи, только поля, которые будут отправлены.

Количество запросов ограничено для каждого ключа. Заголовки RateLimit в каждом ответе показывают, на каком этапе вы находитесь, а ответ с кодом 429 содержит заголовок Retry-After.

Запуски учитываются так же, как команды приложения, и в ответе указывается, какой именно запуск имел место, если только вы не отключили телеметрию в настройках приложения.

Endpoint reference

Каждый конечный пункт с перечнем принимаемых им полей и возвращаемых ответов. Эта информация извлекается из спецификации OpenAPI сервера API, поэтому она всегда соответствует текущей версии.

Базовый 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 использует HTTP-транспорт Streamable и те же ключи. Он предоставляет по одному инструменту на каждую команду, а также настройки, причём доступны только те инструменты, которые разрешены правами вашего ключа.

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"
      }
    }
  }
}