HammerTime Beta

API hozzáférés

Időbélyegek létrehozása és az alkalmazás beállításainak módosítása a saját programjaidból. Minden végpont egy app parancshoz tartozik, és a kérések a kulcs létrehozásakor megadott Discord fiók beállításait követik.

API kulcsok

Jelentkezz be az API-kulcsok létrehozásához. Ezek a kulcsok a profilodhoz kapcsolt Discord-fiókok egyikeként működnek.

Az API használata

Minden kérésnél az Authorization header-ben kell küldened a kulcsodat.

Ez a mai nap 18:30-as időbélyegét adja vissza a mentett időzónádban. A példákban szereplő kulcs kitalált, használd a sajátodat:

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

Jogosultságok

Egy kulcs rendelkezik azokkal a jogosultságokkal, amelyekkel létrehozták, és az oldal további része ezekre a kódokra hivatkozik.

Bármelyik kulcs jogosultságaitól függetlenül meghívhatja a(z) GET/me végpontot, ami visszaadja, milyen jogosultságokkal rendelkezik.

JogosultságLehetővé tesz
timestamps:createIdőbélyegek létrehozása az időbélyeg-végpontok és az MCP tool-ok segítségével, a kulcs által képviselt Discord-fiók használatával.
settings:readAz adott fiók app beállításainak olvasása.
settings:writeA fiók app beállításainak módosítása, csak az elküldött mezők.

A lekérdezések kulcsanként korlátozottak. Minden válasz RateLimit header-jéből megtudhatod, hol tartasz, a 429-es válasz pedig Retry-After header-t tartalmaz.

A futtatásokat úgy számolja a rendszer, mint az app parancsait, és a válaszban szerepel, hogy melyik futtatásról van szó, kivéve, ha az alkalmazás beállításaiban kikapcsoltad a telemetriát.

Végpontok listája

Minden végpont a szükséges mezőkkel és a visszaadott válaszokkal együtt. Ezeket az API-kiszolgáló OpenAPI-specifikációjából olvassa be, így mindig megegyeznek a futó verzióval.

Alap URL

Vágólapra másoláshttps://api.hammertime.cyou
Interaktív kézikönyvOpenAPI specifikáció

Hibák

Minden hibaüzenetnek ilyen body-ja van. A státusz kód jelzi, hogy milyen típusú hibáról van szó, az error.code pedig a pontos okot.

{
"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": {},objectnem kötelezőValues interpolated into the message
"issues": [object[]nem kötelezőFor invalid_request: what is wrong with which field
{
"path": "string",string
"message": "string"string
}
]
}
}

timestamps

Bot commands as endpoints

Equivalent to the bot's /add command: the same options, and any option left out falls back to the account's saved settings.

Jogosultságtimestamps:create
Kérés body-ja (JSON)
{
"to": 0,numberThe UNIX timestamp in seconds
"years": 1,integernem kötelezőmin 1How many years to add to the specified timestamp
"months": 1,integernem kötelezőmin 1How many months to add to the specified timestamp
"days": 1,integernem kötelezőmin 1How many days to add to the specified timestamp
"hours": 1,integernem kötelezőmin 1How many hours to add to the specified timestamp
"minutes": 1,integernem kötelezőmin 1How many minutes to add to the specified timestamp
"seconds": 0.001,numbernem kötelezőmin 0.001How many seconds to add to the specified timestamp
"format": "d",stringnem kötelezőReturns only the specified format in the response(d (short date), f (date and time), t (short time), D (long date), F (weekday, date and time), s (short date and short time), S (short date and long time), R (relative), T (long time), all (all (default)))
"header": false,booleannem kötelezőDisplay the initial time (as interpreted by the bot) on top of the response
"columns": "both",stringnem kötelezőSpecify which columns to display in the returned response(both (both syntax and preview), preview (preview only), syntax (syntax only))
"ephemeral": falsebooleannem kötelezőWhen true the response will only be visible to you
}
Válaszok
  • 200 The timestamp, in every format or the requested one
    {
    "command": "at",string(add, ago, at, at12, in, iso, snowflake, subtract, unix)
    "unix": 1792773000,integerUNIX timestamp in seconds
    "timezone": "Europe/Budapest",string | nullThe timezone the input was interpreted in, null for commands that have none
    "header": "📅 2026-10-23 • 🕕 18:30:00 • 🌐 Europe/Budapest",string | nullThe exact time as interpreted, null when the header is turned off
    "content": "📅 2026-10-23 • 🕕 18:30:00 • 🌐 Europe/Budapest\n`<t:1792773000:d>` → **<t:1792773000:d>**\n`<t:1792773000:R>` → **<t:1792773000:R>**",stringThe reply the bot would send: the optional header and the syntax/preview rows
    "singleFormat": null,string | nullThe one format that was asked for (by option or setting), null when every format is listed
    "minimalReply": false,booleanTrue when only the preview of a single format is meant to be shown, which the formatMinimalReply setting asks for
    "usingAtHoursOnly": true,booleannem kötelezőOnly for at: the hour was given as a bare 24-hour value, which the at12 command or a meridiem makes unambiguous
    "formats": [object[]
    {
    "format": "d",stringDiscord timestamp style (d, D, t, T, f, F, s, S or R)
    "timestamp": "<t:1792773000:d>"stringMarkdown to paste into Discord, e.g. <t:1650802953:R>
    }
    ],
    "telemetry": {objectnem kötelezőPresent only when usage telemetry is enabled in the settings of the account the key acts as
    "executionNumber": 1234,integerHow many times the command has been run, across Discord and the API
    "command": "at",string
    "privacyPolicyUrl": "https://hammertime.cyou/en/legal#telemetry-statistics",string
    "note": "This is execution #1234 for the /at command (since we started counting). Thank you for contributing telemetry data, which helps the bot's future development."stringThe sentence the bot appends to its replies
    }
    }
  • 400 The input is invalid, see error.code
  • 401 The API key is missing, unknown, revoked or expired
  • 403 The API key does not have the scope this endpoint needs
  • 429 Too many requests for this key (or too many failed attempts from this address), wait the number of seconds in Retry-After. Every response carries RateLimit-Limit, RateLimit-Remaining and RateLimit-Reset.
  • 503 The service is read-only while it is being deployed, retry after the number of seconds in Retry-After

Equivalent to the bot's /ago command: the same options, and any option left out falls back to the account's saved settings.

Jogosultságtimestamps:create
Kérés body-ja (JSON)
{
"years": 1,integernem kötelezőmin 1How many years to subtract from the current time
"months": 1,integernem kötelezőmin 1How many months to subtract from the current time
"days": 1,integernem kötelezőmin 1How many days to subtract from the current time
"hours": 1,integernem kötelezőmin 1How many hours to subtract from the current time
"minutes": 1,integernem kötelezőmin 1How many minutes to subtract from the current time
"seconds": 0.001,numbernem kötelezőmin 0.001How many seconds to subtract from the current time
"format": "d",stringnem kötelezőReturns only the specified format in the response(d (short date), f (date and time), t (short time), D (long date), F (weekday, date and time), s (short date and short time), S (short date and long time), R (relative), T (long time), all (all (default)))
"header": false,booleannem kötelezőDisplay the initial time (as interpreted by the bot) on top of the response
"columns": "both",stringnem kötelezőSpecify which columns to display in the returned response(both (both syntax and preview), preview (preview only), syntax (syntax only))
"ephemeral": falsebooleannem kötelezőWhen true the response will only be visible to you
}
Válaszok
  • 200 The timestamp, in every format or the requested one
    {
    "command": "at",string(add, ago, at, at12, in, iso, snowflake, subtract, unix)
    "unix": 1792773000,integerUNIX timestamp in seconds
    "timezone": "Europe/Budapest",string | nullThe timezone the input was interpreted in, null for commands that have none
    "header": "📅 2026-10-23 • 🕕 18:30:00 • 🌐 Europe/Budapest",string | nullThe exact time as interpreted, null when the header is turned off
    "content": "📅 2026-10-23 • 🕕 18:30:00 • 🌐 Europe/Budapest\n`<t:1792773000:d>` → **<t:1792773000:d>**\n`<t:1792773000:R>` → **<t:1792773000:R>**",stringThe reply the bot would send: the optional header and the syntax/preview rows
    "singleFormat": null,string | nullThe one format that was asked for (by option or setting), null when every format is listed
    "minimalReply": false,booleanTrue when only the preview of a single format is meant to be shown, which the formatMinimalReply setting asks for
    "usingAtHoursOnly": true,booleannem kötelezőOnly for at: the hour was given as a bare 24-hour value, which the at12 command or a meridiem makes unambiguous
    "formats": [object[]
    {
    "format": "d",stringDiscord timestamp style (d, D, t, T, f, F, s, S or R)
    "timestamp": "<t:1792773000:d>"stringMarkdown to paste into Discord, e.g. <t:1650802953:R>
    }
    ],
    "telemetry": {objectnem kötelezőPresent only when usage telemetry is enabled in the settings of the account the key acts as
    "executionNumber": 1234,integerHow many times the command has been run, across Discord and the API
    "command": "at",string
    "privacyPolicyUrl": "https://hammertime.cyou/en/legal#telemetry-statistics",string
    "note": "This is execution #1234 for the /at command (since we started counting). Thank you for contributing telemetry data, which helps the bot's future development."stringThe sentence the bot appends to its replies
    }
    }
  • 400 The input is invalid, see error.code
  • 401 The API key is missing, unknown, revoked or expired
  • 403 The API key does not have the scope this endpoint needs
  • 429 Too many requests for this key (or too many failed attempts from this address), wait the number of seconds in Retry-After. Every response carries RateLimit-Limit, RateLimit-Remaining and RateLimit-Reset.
  • 503 The service is read-only while it is being deployed, retry after the number of seconds in Retry-After

Equivalent to the bot's /at command: the same options, and any option left out falls back to the account's saved settings.

Jogosultságtimestamps:create
Kérés body-ja (JSON)
{
"year": 0,integernem kötelezőSpecify the year (defaults to current year)
"month": 1,integernem kötelezőmin 1, max 12Specify the month (defaults to current month)
"day": 1,integernem kötelezőmin 1, max 31Specify the day (defaults to current day)
"hour": "string",string | numbernem kötelezőSpecify the hour (defaults to current hour). A plain number is accepted and read as text.
"hour12": 1,integernem kötelezőmin 1, max 12Specify the hour using 12-hour clock (defaults to current hour)
"am": false,booleannem kötelezőWhen True, hour must be between 1 to 12 and will be interpreted as AM (ante meridiem)
"pm": false,booleannem kötelezőWhen True, hour must be between 1 to 12 and will be interpreted as PM (post meridiem)
"minute": 0,integernem kötelezőmin 0, max 59Specify the minute (defaults to current minute)
"second": 0,numbernem kötelezőmin 0, max 59.999Specify the second (defaults to 0)
"timezone": "string",stringnem kötelezőmin length 3Specify the timezone (defaults to GMT)
"format": "d",stringnem kötelezőReturns only the specified format in the response(d (short date), f (date and time), t (short time), D (long date), F (weekday, date and time), s (short date and short time), S (short date and long time), R (relative), T (long time), all (all (default)))
"header": false,booleannem kötelezőDisplay the initial time (as interpreted by the bot) on top of the response
"columns": "both",stringnem kötelezőSpecify which columns to display in the returned response(both (both syntax and preview), preview (preview only), syntax (syntax only))
"ephemeral": falsebooleannem kötelezőWhen true the response will only be visible to you
}
Válaszok
  • 200 The timestamp, in every format or the requested one
    {
    "command": "at",string(add, ago, at, at12, in, iso, snowflake, subtract, unix)
    "unix": 1792773000,integerUNIX timestamp in seconds
    "timezone": "Europe/Budapest",string | nullThe timezone the input was interpreted in, null for commands that have none
    "header": "📅 2026-10-23 • 🕕 18:30:00 • 🌐 Europe/Budapest",string | nullThe exact time as interpreted, null when the header is turned off
    "content": "📅 2026-10-23 • 🕕 18:30:00 • 🌐 Europe/Budapest\n`<t:1792773000:d>` → **<t:1792773000:d>**\n`<t:1792773000:R>` → **<t:1792773000:R>**",stringThe reply the bot would send: the optional header and the syntax/preview rows
    "singleFormat": null,string | nullThe one format that was asked for (by option or setting), null when every format is listed
    "minimalReply": false,booleanTrue when only the preview of a single format is meant to be shown, which the formatMinimalReply setting asks for
    "usingAtHoursOnly": true,booleannem kötelezőOnly for at: the hour was given as a bare 24-hour value, which the at12 command or a meridiem makes unambiguous
    "formats": [object[]
    {
    "format": "d",stringDiscord timestamp style (d, D, t, T, f, F, s, S or R)
    "timestamp": "<t:1792773000:d>"stringMarkdown to paste into Discord, e.g. <t:1650802953:R>
    }
    ],
    "telemetry": {objectnem kötelezőPresent only when usage telemetry is enabled in the settings of the account the key acts as
    "executionNumber": 1234,integerHow many times the command has been run, across Discord and the API
    "command": "at",string
    "privacyPolicyUrl": "https://hammertime.cyou/en/legal#telemetry-statistics",string
    "note": "This is execution #1234 for the /at command (since we started counting). Thank you for contributing telemetry data, which helps the bot's future development."stringThe sentence the bot appends to its replies
    }
    }
  • 400 The input is invalid, see error.code
  • 401 The API key is missing, unknown, revoked or expired
  • 403 The API key does not have the scope this endpoint needs
  • 429 Too many requests for this key (or too many failed attempts from this address), wait the number of seconds in Retry-After. Every response carries RateLimit-Limit, RateLimit-Remaining and RateLimit-Reset.
  • 503 The service is read-only while it is being deployed, retry after the number of seconds in Retry-After

Equivalent to the bot's /at12 command: the same options, and any option left out falls back to the account's saved settings.

Jogosultságtimestamps:create
Kérés body-ja (JSON)
{
"year": 0,integernem kötelezőSpecify the year (defaults to current year)
"month": 1,integernem kötelezőmin 1, max 12Specify the month (defaults to current month)
"day": 1,integernem kötelezőmin 1, max 31Specify the day (defaults to current day)
"hour": 1,integernem kötelezőmin 1, max 12Specify the hour (defaults to current hour)
"am": false,booleannem kötelezőWhen True, hour will be interpreted as am (ante meridiem, before noon)
"pm": false,booleannem kötelezőWhen True, hour will be interpreted as pm (post meridiem, after noon)
"minute": 0,integernem kötelezőmin 0, max 59Specify the minute (defaults to current minute)
"second": 0,numbernem kötelezőmin 0, max 59.999Specify the second (defaults to 0)
"timezone": "string",stringnem kötelezőmin length 3Specify the timezone (defaults to GMT)
"format": "d",stringnem kötelezőReturns only the specified format in the response(d (short date), f (date and time), t (short time), D (long date), F (weekday, date and time), s (short date and short time), S (short date and long time), R (relative), T (long time), all (all (default)))
"header": false,booleannem kötelezőDisplay the initial time (as interpreted by the bot) on top of the response
"columns": "both",stringnem kötelezőSpecify which columns to display in the returned response(both (both syntax and preview), preview (preview only), syntax (syntax only))
"ephemeral": falsebooleannem kötelezőWhen true the response will only be visible to you
}
Válaszok
  • 200 The timestamp, in every format or the requested one
    {
    "command": "at",string(add, ago, at, at12, in, iso, snowflake, subtract, unix)
    "unix": 1792773000,integerUNIX timestamp in seconds
    "timezone": "Europe/Budapest",string | nullThe timezone the input was interpreted in, null for commands that have none
    "header": "📅 2026-10-23 • 🕕 18:30:00 • 🌐 Europe/Budapest",string | nullThe exact time as interpreted, null when the header is turned off
    "content": "📅 2026-10-23 • 🕕 18:30:00 • 🌐 Europe/Budapest\n`<t:1792773000:d>` → **<t:1792773000:d>**\n`<t:1792773000:R>` → **<t:1792773000:R>**",stringThe reply the bot would send: the optional header and the syntax/preview rows
    "singleFormat": null,string | nullThe one format that was asked for (by option or setting), null when every format is listed
    "minimalReply": false,booleanTrue when only the preview of a single format is meant to be shown, which the formatMinimalReply setting asks for
    "usingAtHoursOnly": true,booleannem kötelezőOnly for at: the hour was given as a bare 24-hour value, which the at12 command or a meridiem makes unambiguous
    "formats": [object[]
    {
    "format": "d",stringDiscord timestamp style (d, D, t, T, f, F, s, S or R)
    "timestamp": "<t:1792773000:d>"stringMarkdown to paste into Discord, e.g. <t:1650802953:R>
    }
    ],
    "telemetry": {objectnem kötelezőPresent only when usage telemetry is enabled in the settings of the account the key acts as
    "executionNumber": 1234,integerHow many times the command has been run, across Discord and the API
    "command": "at",string
    "privacyPolicyUrl": "https://hammertime.cyou/en/legal#telemetry-statistics",string
    "note": "This is execution #1234 for the /at command (since we started counting). Thank you for contributing telemetry data, which helps the bot's future development."stringThe sentence the bot appends to its replies
    }
    }
  • 400 The input is invalid, see error.code
  • 401 The API key is missing, unknown, revoked or expired
  • 403 The API key does not have the scope this endpoint needs
  • 429 Too many requests for this key (or too many failed attempts from this address), wait the number of seconds in Retry-After. Every response carries RateLimit-Limit, RateLimit-Remaining and RateLimit-Reset.
  • 503 The service is read-only while it is being deployed, retry after the number of seconds in Retry-After

Equivalent to the bot's /in command: the same options, and any option left out falls back to the account's saved settings.

Jogosultságtimestamps:create
Kérés body-ja (JSON)
{
"years": 1,integernem kötelezőmin 1How many years to add to the current time
"months": 1,integernem kötelezőmin 1How many months to add to the current time
"days": 1,integernem kötelezőmin 1How many days to add to the current time
"hours": 1,integernem kötelezőmin 1How many hours to add to the current time
"minutes": 1,integernem kötelezőmin 1How many minutes to add to the current time
"seconds": 0.001,numbernem kötelezőmin 0.001How many seconds to add to the current time
"format": "d",stringnem kötelezőReturns only the specified format in the response(d (short date), f (date and time), t (short time), D (long date), F (weekday, date and time), s (short date and short time), S (short date and long time), R (relative), T (long time), all (all (default)))
"header": false,booleannem kötelezőDisplay the initial time (as interpreted by the bot) on top of the response
"columns": "both",stringnem kötelezőSpecify which columns to display in the returned response(both (both syntax and preview), preview (preview only), syntax (syntax only))
"ephemeral": falsebooleannem kötelezőWhen true the response will only be visible to you
}
Válaszok
  • 200 The timestamp, in every format or the requested one
    {
    "command": "at",string(add, ago, at, at12, in, iso, snowflake, subtract, unix)
    "unix": 1792773000,integerUNIX timestamp in seconds
    "timezone": "Europe/Budapest",string | nullThe timezone the input was interpreted in, null for commands that have none
    "header": "📅 2026-10-23 • 🕕 18:30:00 • 🌐 Europe/Budapest",string | nullThe exact time as interpreted, null when the header is turned off
    "content": "📅 2026-10-23 • 🕕 18:30:00 • 🌐 Europe/Budapest\n`<t:1792773000:d>` → **<t:1792773000:d>**\n`<t:1792773000:R>` → **<t:1792773000:R>**",stringThe reply the bot would send: the optional header and the syntax/preview rows
    "singleFormat": null,string | nullThe one format that was asked for (by option or setting), null when every format is listed
    "minimalReply": false,booleanTrue when only the preview of a single format is meant to be shown, which the formatMinimalReply setting asks for
    "usingAtHoursOnly": true,booleannem kötelezőOnly for at: the hour was given as a bare 24-hour value, which the at12 command or a meridiem makes unambiguous
    "formats": [object[]
    {
    "format": "d",stringDiscord timestamp style (d, D, t, T, f, F, s, S or R)
    "timestamp": "<t:1792773000:d>"stringMarkdown to paste into Discord, e.g. <t:1650802953:R>
    }
    ],
    "telemetry": {objectnem kötelezőPresent only when usage telemetry is enabled in the settings of the account the key acts as
    "executionNumber": 1234,integerHow many times the command has been run, across Discord and the API
    "command": "at",string
    "privacyPolicyUrl": "https://hammertime.cyou/en/legal#telemetry-statistics",string
    "note": "This is execution #1234 for the /at command (since we started counting). Thank you for contributing telemetry data, which helps the bot's future development."stringThe sentence the bot appends to its replies
    }
    }
  • 400 The input is invalid, see error.code
  • 401 The API key is missing, unknown, revoked or expired
  • 403 The API key does not have the scope this endpoint needs
  • 429 Too many requests for this key (or too many failed attempts from this address), wait the number of seconds in Retry-After. Every response carries RateLimit-Limit, RateLimit-Remaining and RateLimit-Reset.
  • 503 The service is read-only while it is being deployed, retry after the number of seconds in Retry-After

Equivalent to the bot's /iso command: the same options, and any option left out falls back to the account's saved settings.

Jogosultságtimestamps:create
Kérés body-ja (JSON)
{
"value": "string",stringmin length 10, max length 25The ISO 8601 standard timestamp
"timezone": "string",stringnem kötelezőmin length 3Specify the timezone (defaults to GMT)
"format": "d",stringnem kötelezőReturns only the specified format in the response(d (short date), f (date and time), t (short time), D (long date), F (weekday, date and time), s (short date and short time), S (short date and long time), R (relative), T (long time), all (all (default)))
"header": false,booleannem kötelezőDisplay the initial time (as interpreted by the bot) on top of the response
"columns": "both",stringnem kötelezőSpecify which columns to display in the returned response(both (both syntax and preview), preview (preview only), syntax (syntax only))
"ephemeral": falsebooleannem kötelezőWhen true the response will only be visible to you
}
Válaszok
  • 200 The timestamp, in every format or the requested one
    {
    "command": "at",string(add, ago, at, at12, in, iso, snowflake, subtract, unix)
    "unix": 1792773000,integerUNIX timestamp in seconds
    "timezone": "Europe/Budapest",string | nullThe timezone the input was interpreted in, null for commands that have none
    "header": "📅 2026-10-23 • 🕕 18:30:00 • 🌐 Europe/Budapest",string | nullThe exact time as interpreted, null when the header is turned off
    "content": "📅 2026-10-23 • 🕕 18:30:00 • 🌐 Europe/Budapest\n`<t:1792773000:d>` → **<t:1792773000:d>**\n`<t:1792773000:R>` → **<t:1792773000:R>**",stringThe reply the bot would send: the optional header and the syntax/preview rows
    "singleFormat": null,string | nullThe one format that was asked for (by option or setting), null when every format is listed
    "minimalReply": false,booleanTrue when only the preview of a single format is meant to be shown, which the formatMinimalReply setting asks for
    "usingAtHoursOnly": true,booleannem kötelezőOnly for at: the hour was given as a bare 24-hour value, which the at12 command or a meridiem makes unambiguous
    "formats": [object[]
    {
    "format": "d",stringDiscord timestamp style (d, D, t, T, f, F, s, S or R)
    "timestamp": "<t:1792773000:d>"stringMarkdown to paste into Discord, e.g. <t:1650802953:R>
    }
    ],
    "telemetry": {objectnem kötelezőPresent only when usage telemetry is enabled in the settings of the account the key acts as
    "executionNumber": 1234,integerHow many times the command has been run, across Discord and the API
    "command": "at",string
    "privacyPolicyUrl": "https://hammertime.cyou/en/legal#telemetry-statistics",string
    "note": "This is execution #1234 for the /at command (since we started counting). Thank you for contributing telemetry data, which helps the bot's future development."stringThe sentence the bot appends to its replies
    }
    }
  • 400 The input is invalid, see error.code
  • 401 The API key is missing, unknown, revoked or expired
  • 403 The API key does not have the scope this endpoint needs
  • 429 Too many requests for this key (or too many failed attempts from this address), wait the number of seconds in Retry-After. Every response carries RateLimit-Limit, RateLimit-Remaining and RateLimit-Reset.
  • 503 The service is read-only while it is being deployed, retry after the number of seconds in Retry-After

Equivalent to the bot's /snowflake command: the same options, and any option left out falls back to the account's saved settings.

Jogosultságtimestamps:create
Kérés body-ja (JSON)
{
"value": "string",stringmin length 1The Snowflake number
"format": "d",stringnem kötelezőReturns only the specified format in the response(d (short date), f (date and time), t (short time), D (long date), F (weekday, date and time), s (short date and short time), S (short date and long time), R (relative), T (long time), all (all (default)))
"header": false,booleannem kötelezőDisplay the initial time (as interpreted by the bot) on top of the response
"columns": "both",stringnem kötelezőSpecify which columns to display in the returned response(both (both syntax and preview), preview (preview only), syntax (syntax only))
"ephemeral": falsebooleannem kötelezőWhen true the response will only be visible to you
}
Válaszok
  • 200 The timestamp, in every format or the requested one
    {
    "command": "at",string(add, ago, at, at12, in, iso, snowflake, subtract, unix)
    "unix": 1792773000,integerUNIX timestamp in seconds
    "timezone": "Europe/Budapest",string | nullThe timezone the input was interpreted in, null for commands that have none
    "header": "📅 2026-10-23 • 🕕 18:30:00 • 🌐 Europe/Budapest",string | nullThe exact time as interpreted, null when the header is turned off
    "content": "📅 2026-10-23 • 🕕 18:30:00 • 🌐 Europe/Budapest\n`<t:1792773000:d>` → **<t:1792773000:d>**\n`<t:1792773000:R>` → **<t:1792773000:R>**",stringThe reply the bot would send: the optional header and the syntax/preview rows
    "singleFormat": null,string | nullThe one format that was asked for (by option or setting), null when every format is listed
    "minimalReply": false,booleanTrue when only the preview of a single format is meant to be shown, which the formatMinimalReply setting asks for
    "usingAtHoursOnly": true,booleannem kötelezőOnly for at: the hour was given as a bare 24-hour value, which the at12 command or a meridiem makes unambiguous
    "formats": [object[]
    {
    "format": "d",stringDiscord timestamp style (d, D, t, T, f, F, s, S or R)
    "timestamp": "<t:1792773000:d>"stringMarkdown to paste into Discord, e.g. <t:1650802953:R>
    }
    ],
    "telemetry": {objectnem kötelezőPresent only when usage telemetry is enabled in the settings of the account the key acts as
    "executionNumber": 1234,integerHow many times the command has been run, across Discord and the API
    "command": "at",string
    "privacyPolicyUrl": "https://hammertime.cyou/en/legal#telemetry-statistics",string
    "note": "This is execution #1234 for the /at command (since we started counting). Thank you for contributing telemetry data, which helps the bot's future development."stringThe sentence the bot appends to its replies
    }
    }
  • 400 The input is invalid, see error.code
  • 401 The API key is missing, unknown, revoked or expired
  • 403 The API key does not have the scope this endpoint needs
  • 429 Too many requests for this key (or too many failed attempts from this address), wait the number of seconds in Retry-After. Every response carries RateLimit-Limit, RateLimit-Remaining and RateLimit-Reset.
  • 503 The service is read-only while it is being deployed, retry after the number of seconds in Retry-After

Equivalent to the bot's /subtract command: the same options, and any option left out falls back to the account's saved settings.

Jogosultságtimestamps:create
Kérés body-ja (JSON)
{
"from": 0,numberThe UNIX timestamp in seconds
"years": 1,integernem kötelezőmin 1How many years to subtract from the specified timestamp
"months": 1,integernem kötelezőmin 1How many months to subtract from the specified timestamp
"days": 1,integernem kötelezőmin 1How many days to subtract from the specified timestamp
"hours": 1,integernem kötelezőmin 1How many hours to subtract from the specified timestamp
"minutes": 1,integernem kötelezőmin 1How many minutes to subtract from the specified timestamp
"seconds": 0.001,numbernem kötelezőmin 0.001How many seconds to subtract from the specified timestamp
"format": "d",stringnem kötelezőReturns only the specified format in the response(d (short date), f (date and time), t (short time), D (long date), F (weekday, date and time), s (short date and short time), S (short date and long time), R (relative), T (long time), all (all (default)))
"header": false,booleannem kötelezőDisplay the initial time (as interpreted by the bot) on top of the response
"columns": "both",stringnem kötelezőSpecify which columns to display in the returned response(both (both syntax and preview), preview (preview only), syntax (syntax only))
"ephemeral": falsebooleannem kötelezőWhen true the response will only be visible to you
}
Válaszok
  • 200 The timestamp, in every format or the requested one
    {
    "command": "at",string(add, ago, at, at12, in, iso, snowflake, subtract, unix)
    "unix": 1792773000,integerUNIX timestamp in seconds
    "timezone": "Europe/Budapest",string | nullThe timezone the input was interpreted in, null for commands that have none
    "header": "📅 2026-10-23 • 🕕 18:30:00 • 🌐 Europe/Budapest",string | nullThe exact time as interpreted, null when the header is turned off
    "content": "📅 2026-10-23 • 🕕 18:30:00 • 🌐 Europe/Budapest\n`<t:1792773000:d>` → **<t:1792773000:d>**\n`<t:1792773000:R>` → **<t:1792773000:R>**",stringThe reply the bot would send: the optional header and the syntax/preview rows
    "singleFormat": null,string | nullThe one format that was asked for (by option or setting), null when every format is listed
    "minimalReply": false,booleanTrue when only the preview of a single format is meant to be shown, which the formatMinimalReply setting asks for
    "usingAtHoursOnly": true,booleannem kötelezőOnly for at: the hour was given as a bare 24-hour value, which the at12 command or a meridiem makes unambiguous
    "formats": [object[]
    {
    "format": "d",stringDiscord timestamp style (d, D, t, T, f, F, s, S or R)
    "timestamp": "<t:1792773000:d>"stringMarkdown to paste into Discord, e.g. <t:1650802953:R>
    }
    ],
    "telemetry": {objectnem kötelezőPresent only when usage telemetry is enabled in the settings of the account the key acts as
    "executionNumber": 1234,integerHow many times the command has been run, across Discord and the API
    "command": "at",string
    "privacyPolicyUrl": "https://hammertime.cyou/en/legal#telemetry-statistics",string
    "note": "This is execution #1234 for the /at command (since we started counting). Thank you for contributing telemetry data, which helps the bot's future development."stringThe sentence the bot appends to its replies
    }
    }
  • 400 The input is invalid, see error.code
  • 401 The API key is missing, unknown, revoked or expired
  • 403 The API key does not have the scope this endpoint needs
  • 429 Too many requests for this key (or too many failed attempts from this address), wait the number of seconds in Retry-After. Every response carries RateLimit-Limit, RateLimit-Remaining and RateLimit-Reset.
  • 503 The service is read-only while it is being deployed, retry after the number of seconds in Retry-After

Equivalent to the bot's /unix command: the same options, and any option left out falls back to the account's saved settings.

Jogosultságtimestamps:create
Kérés body-ja (JSON)
{
"value": 0,integerThe UNIX timestamp in seconds
"format": "d",stringnem kötelezőReturns only the specified format in the response(d (short date), f (date and time), t (short time), D (long date), F (weekday, date and time), s (short date and short time), S (short date and long time), R (relative), T (long time), all (all (default)))
"header": false,booleannem kötelezőDisplay the initial time (as interpreted by the bot) on top of the response
"columns": "both",stringnem kötelezőSpecify which columns to display in the returned response(both (both syntax and preview), preview (preview only), syntax (syntax only))
"ephemeral": falsebooleannem kötelezőWhen true the response will only be visible to you
}
Válaszok
  • 200 The timestamp, in every format or the requested one
    {
    "command": "at",string(add, ago, at, at12, in, iso, snowflake, subtract, unix)
    "unix": 1792773000,integerUNIX timestamp in seconds
    "timezone": "Europe/Budapest",string | nullThe timezone the input was interpreted in, null for commands that have none
    "header": "📅 2026-10-23 • 🕕 18:30:00 • 🌐 Europe/Budapest",string | nullThe exact time as interpreted, null when the header is turned off
    "content": "📅 2026-10-23 • 🕕 18:30:00 • 🌐 Europe/Budapest\n`<t:1792773000:d>` → **<t:1792773000:d>**\n`<t:1792773000:R>` → **<t:1792773000:R>**",stringThe reply the bot would send: the optional header and the syntax/preview rows
    "singleFormat": null,string | nullThe one format that was asked for (by option or setting), null when every format is listed
    "minimalReply": false,booleanTrue when only the preview of a single format is meant to be shown, which the formatMinimalReply setting asks for
    "usingAtHoursOnly": true,booleannem kötelezőOnly for at: the hour was given as a bare 24-hour value, which the at12 command or a meridiem makes unambiguous
    "formats": [object[]
    {
    "format": "d",stringDiscord timestamp style (d, D, t, T, f, F, s, S or R)
    "timestamp": "<t:1792773000:d>"stringMarkdown to paste into Discord, e.g. <t:1650802953:R>
    }
    ],
    "telemetry": {objectnem kötelezőPresent only when usage telemetry is enabled in the settings of the account the key acts as
    "executionNumber": 1234,integerHow many times the command has been run, across Discord and the API
    "command": "at",string
    "privacyPolicyUrl": "https://hammertime.cyou/en/legal#telemetry-statistics",string
    "note": "This is execution #1234 for the /at command (since we started counting). Thank you for contributing telemetry data, which helps the bot's future development."stringThe sentence the bot appends to its replies
    }
    }
  • 400 The input is invalid, see error.code
  • 401 The API key is missing, unknown, revoked or expired
  • 403 The API key does not have the scope this endpoint needs
  • 429 Too many requests for this key (or too many failed attempts from this address), wait the number of seconds in Retry-After. Every response carries RateLimit-Limit, RateLimit-Remaining and RateLimit-Reset.
  • 503 The service is read-only while it is being deployed, retry after the number of seconds in Retry-After

settings

The bot settings of the account

The saved settings of the account the key acts as. These are the defaults the timestamp endpoints fall back to.

Jogosultságsettings:read
Válaszok
  • 200 The settings
    {
    "ephemeral": true,boolean | nullWhether the bot replies are only visible to you (no effect on the API)
    "timezone": "Europe/Budapest",string | nullTimezone used when a command does not specify one
    "header": true,boolean | nullWhether replies start with the exact time as interpreted
    "boldPreview": true,boolean | nullWhether previews are bold when listing all formats
    "columns": null,string | nullWhich columns replies show(both, preview, syntax)
    "format": null,string | nullOnly return this format instead of all of them(d, D, t, T, f, F, s, S, R)
    "formatMinimalReply": true,boolean | nullWith a single format, reply with just the preview
    "telemetry": true,boolean | nullWhether anonymous command usage is recorded, and the run count shown in replies
    "defaultAtHour": null,integer | nullHour (0-23) used by the at command when none is given
    "defaultAt12Hour": null,integer | nullHour (1-12) used by the at12 and at commands when none is given
    "defaultAtMinute": null,integer | nullMinute used by the at commands when none is given
    "defaultAtSecond": 0integer | nullSecond used by the at commands when none is given
    }
  • 401 The API key is missing, unknown, revoked or expired
  • 403 The API key does not have the scope this endpoint needs
  • 429 Too many requests for this key (or too many failed attempts from this address), wait the number of seconds in Retry-After. Every response carries RateLimit-Limit, RateLimit-Remaining and RateLimit-Reset.
  • 503 The service is read-only while it is being deployed, retry after the number of seconds in Retry-After

Changes the given settings only. A null value resets a setting to its default.

Jogosultságsettings:write
Kérés body-ja (JSON)
{
"ephemeral": false,boolean | nullnem kötelező
"timezone": "string",string | nullnem kötelezőmin length 1, max length 64
"header": false,boolean | nullnem kötelező
"boldPreview": false,boolean | nullnem kötelező
"columns": "both",string | nullnem kötelező(both, preview, syntax)
"format": "d",string | nullnem kötelező(d, D, t, T, f, F, s, S, R)
"formatMinimalReply": false,boolean | nullnem kötelező
"telemetry": false,boolean | nullnem kötelező
"defaultAtHour": 0,integer | nullnem kötelezőmin 0, max 23
"defaultAt12Hour": 1,integer | nullnem kötelezőmin 1, max 12
"defaultAtMinute": 0,integer | nullnem kötelezőmin 0, max 59
"defaultAtSecond": 0integer | nullnem kötelezőmin 0, max 59
}
Válaszok
  • 200 The settings after the change
    {
    "ephemeral": true,boolean | nullWhether the bot replies are only visible to you (no effect on the API)
    "timezone": "Europe/Budapest",string | nullTimezone used when a command does not specify one
    "header": true,boolean | nullWhether replies start with the exact time as interpreted
    "boldPreview": true,boolean | nullWhether previews are bold when listing all formats
    "columns": null,string | nullWhich columns replies show(both, preview, syntax)
    "format": null,string | nullOnly return this format instead of all of them(d, D, t, T, f, F, s, S, R)
    "formatMinimalReply": true,boolean | nullWith a single format, reply with just the preview
    "telemetry": true,boolean | nullWhether anonymous command usage is recorded, and the run count shown in replies
    "defaultAtHour": null,integer | nullHour (0-23) used by the at command when none is given
    "defaultAt12Hour": null,integer | nullHour (1-12) used by the at12 and at commands when none is given
    "defaultAtMinute": null,integer | nullMinute used by the at commands when none is given
    "defaultAtSecond": 0integer | nullSecond used by the at commands when none is given
    }
  • 400 A value is invalid
  • 401 The API key is missing, unknown, revoked or expired
  • 403 The API key does not have the scope this endpoint needs
  • 429 Too many requests for this key (or too many failed attempts from this address), wait the number of seconds in Retry-After. Every response carries RateLimit-Limit, RateLimit-Remaining and RateLimit-Reset.
  • 503 The service is read-only while it is being deployed, retry after the number of seconds in Retry-After

keys

About the API key in use

Which account the key acts as and what it is allowed to do.

Bármely érvényes kulcs
Válaszok
  • 200 The key
    {
    "keyId": "42",string
    "kind": "user",string(user, service)
    "discordUserId": "140360880079503362",stringThe Discord account the key acts as
    "scopes": ["timestamps:create","settings:read","settings:write"]string[]
    }
  • 401 The API key is missing, unknown, revoked or expired
  • 429 Too many requests for this key (or too many failed attempts from this address), wait the number of seconds in Retry-After. Every response carries RateLimit-Limit, RateLimit-Remaining and RateLimit-Reset.
  • 503 The service is read-only while it is being deployed, retry after the number of seconds in Retry-After

server info

Service status

Whether the service is up.

Nincs szükség kulcsra
Válaszok
  • 200 The service is up
    {
    "status": "ok"string(ok)
    }

Az MCP-kiszolgáló használata

Az MCP-kiszolgáló a Streamable HTTP-átviteli protokollt és ugyanazokat a kulcsokat használja. Parancsonként egy tool-t és a beállításokat kínálja, és kizárólag azokat a tool-okat, amelyekre a kulcsod jogosultságai kiterjednek.

Kiszolgáló webcíme

Vágólapra másoláshttps://api.hammertime.cyou/mcp
Az alábbi példákban szereplő kulcs kitalált, nem fog működni. Cseréld ki a saját kulcsodra!

A következő paranccsal tudod hozzáadni a Claude Code-hoz:

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

Más kliensek hasonló konfigurációt alkalmaznak, az URL-címmel és egy Authorization header-rel:

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