HammerTime Beta

API Erişimi

Kendi programlarınız üzerinden zaman damgaları oluşturun ve uygulama ayarlarınızı değiştirin. Her uç noktası bir uygulama komutuna karşılık gelir ve istekler, anahtarın oluşturulduğu Discord hesabının ayarlarına göre işlenir.

API Anahtarları

API anahtarları oluşturmak için giriş yapın. Bu anahtarlar, profilinize bağlı Discord hesaplarından biri adına işlem yapar.

API Kullanımı

Her isteğin Authorization başlığında anahtarınızı Bearer token olarak gönderin.

Bu örnek, kayıtlı saat diliminize göre bugün saat 18.30 için bir zaman damgası döndürür. Örneklerdeki anahtar gerçek değildir, kendi anahtarınızı kullanın:

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

İzinler

Her anahtar, oluşturulurken verilen izinlere sahiptir. Bu sayfanın geri kalanında bu izinler aşağıdaki kodlarla belirtilir.

Her anahtar, izinlerinden bağımsız olarak sahip olduğu izinleri öğrenmek için GET/me uç noktasını kullanabilir.

İzinSağladığı Yetki
timestamps:createAnahtarın işlem yaptığı Discord hesabı adına, zaman damgası uç noktaları ve MCP araçları aracılığıyla zaman damgaları oluşturma.
settings:readİlgili hesabın uygulama ayarlarını görüntüleme.
settings:writeİlgili hesabın uygulama ayarlarını değiştirme. Yalnızca istekte gönderilen alanlar değiştirilir.

İstekler, her anahtar için ayrı ayrı hız sınırına tabidir. Her yanıtın RateLimit başlıkları, mevcut hız sınırı durumunuzu gösterir. 429 durum koduyla dönen yanıtlarda ise ne kadar süre beklemeniz gerektiğini belirten bir Retry-After başlığı bulunur.

Çalıştırmalar, uygulama komutları gibi sayılır ve uygulama ayarlarınızdan telemetriyi devre dışı bırakmadığınız sürece yanıtta bunun kaçıncı çalıştırma olduğu belirtilir.

Uç nokta referansı

Her uç noktanın kabul ettiği alanlar ve döndürdüğü yanıtlar burada listelenir. Bu bilgiler doğrudan API sunucusunun OpenAPI spesifikasyonundan alındığı için her zaman çalışan sürümle uyumludur.

Ana URL

Panoya kopyalahttps://api.hammertime.cyou
Etkileşimli dokümantasyonOpenAPI spesifikasyonu

Hatalar

Her hata yanıtı bu yapıya sahiptir. Durum kodu hatanın türünü, error.code ise tam nedenini belirtir.

{
"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": {},objectisteğe bağlıValues interpolated into the message
"issues": [object[]isteğe bağlı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 sunucusunu kullanma

MCP sunucusu, Streamable HTTP iletişim yöntemini ve aynı anahtarları kullanır. Her komut ve ayarlar için ayrı bir araç sunar. Yalnızca anahtarınızın izin verdiği araçlara erişebilirsiniz.

Sunucu Adresi

Panoya kopyalahttps://api.hammertime.cyou/mcp
Aşağıdaki örneklerde kullanılan anahtar gerçek değildir ve çalışmayacaktır. Bu anahtarı kendi anahtarlarınızdan biriyle değiştirin.

Claude Code'a şu komutla ekleyin:

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

Diğer istemciler de URL ve Authorization başlığını içeren benzer bir yapılandırma kullanır:

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