JavaScript on tarpeellinen

Sinun selaimesi joko ei tue JavaScriptiä, tai se on pois käytöstä. Jotkut selaimet poistaa JavaScriptin käytöstä oletuksena turvallisuussyistä, mutta se on tarpeellinen tälle sovellukselle. Ole hyvä ja ota se käyttöön ja päivitä sivu, tai käytä eri selainta.

API-yhteys

Luo aikaleimoja ja vaihda apin asetuksia omista ohjelmistasi. Jokainen päätepiste vastaa apin komentoa, ja pyynnöt seuraavat sen Discord-tilin asetuksia, jolle avain luotiin.

API-avaimet

Kirjaudu sisään luodaksesi API-avaimia. Avaimet toimivat kuin yhtenä profiiliisi linkitetyistä Discord-tileistä.

API:n käyttö

Lähetä avaimesi bearer-tunnisteena jokaisen pyynnös Authorization-otsikossa.

Tämä palauttaa aikaleiman, joka vastaa kello 18.30 tänään tallennetussa aikavyöhykkeessäsi. Avain esimerkeissä on keksitty, käytä omaasi:

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

Käyttöoikeudet

Avaimella on ne käyttöoikeudet, joilla se oli luotu, ja loput tästä sivusta viittaa niihin näillä koodeilla.

Jokainen avain voi kutsua GET/me-funktiota, riippumatta sen käyttöoikeuksista, selvittääkseen mitkä sillä on.

Käyttöoikeus	Sallii
`timestamps:create`	Aikaleimojen luominen aikaleima-päätepisteillä ja MCP-työkaluilla, Discord-tilinä jona avain toimii.
`settings:read`	Lukee käyttäjän apin asetuksia.
`settings:write`	Vaihtaa käyttäjän apin asetuksia, vain kentät jotka lähetettiin.

Pyynntöjen määrää rajoitetaan avainkohtaisesti. Jokaisen vastauksen RateLimit-otsikot kertovat missä vaiheessa olet, ja HTTP-virhe 429 tulee Retry-After-otsikon mukana.

Suoritukset lasketaan kuin appikomennot, ja vastaus ilmoittaa monesko suoritus se oli, ellet ole poistanut telemetriatietojen keräämistä käytöstä.

Päätepisteen viite

Jokainen päätepiste sekä sen kentät ja antamat vastaukset. Tämä luetaan OpenAPI-spesifikaatiosta API-palvelimesta, eli se täsmää aina käytössä olevaa versiota.

Juuriosoite

https://api.hammertime.cyou

Interaktiivinen viite OpenAPI-spesifikaatio

Virheet

Jokaisella virhevasteella on tämä runko. Tilakoodi kertoo minkälainen virhe se on, ja error.code kertoo tarkan syyn.

{

"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": {},objectvalinnainenValues interpolated into the message

"issues": [object[]valinnainenFor invalid_request: what is wrong with which field

{

"path": "string",string

"message": "string"string

}

]

}

timestamps

Bot commands as endpoints

POST/addAdd some time to the specified UNIX timestamp

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

Käyttöoikeustimestamps:create

Pyynnön runko (JSON)

{

"to": 0,numberThe UNIX timestamp in seconds

"years": 1,integervalinnainenmin 1How many years to add to the specified timestamp

"months": 1,integervalinnainenmin 1How many months to add to the specified timestamp

"days": 1,integervalinnainenmin 1How many days to add to the specified timestamp

"hours": 1,integervalinnainenmin 1How many hours to add to the specified timestamp

"minutes": 1,integervalinnainenmin 1How many minutes to add to the specified timestamp

"seconds": 0.001,numbervalinnainenmin 0.001How many seconds to add to the specified timestamp

"format": "d",stringvalinnainenReturns 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,booleanvalinnainenDisplay the initial time (as interpreted by the bot) on top of the response

"columns": "both",stringvalinnainenSpecify which columns to display in the returned response(both (both syntax and preview), preview (preview only), syntax (syntax only))

"ephemeral": falsebooleanvalinnainenWhen true the response will only be visible to you

}

Vastaukset

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,booleanvalinnainenOnly 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": {objectvalinnainenPresent 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

POST/agoSpecify a timestamp in the past relative to the current time

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

Käyttöoikeustimestamps:create

Pyynnön runko (JSON)

{

"years": 1,integervalinnainenmin 1How many years to subtract from the current time

"months": 1,integervalinnainenmin 1How many months to subtract from the current time

"days": 1,integervalinnainenmin 1How many days to subtract from the current time

"hours": 1,integervalinnainenmin 1How many hours to subtract from the current time

"minutes": 1,integervalinnainenmin 1How many minutes to subtract from the current time

"seconds": 0.001,numbervalinnainenmin 0.001How many seconds to subtract from the current time

"header": false,booleanvalinnainenDisplay the initial time (as interpreted by the bot) on top of the response

"columns": "both",stringvalinnainenSpecify which columns to display in the returned response(both (both syntax and preview), preview (preview only), syntax (syntax only))

"ephemeral": falsebooleanvalinnainenWhen true the response will only be visible to you

}

Vastaukset

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,booleanvalinnainenOnly 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": {objectvalinnainenPresent 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

POST/atSpecify the exact components of the timestamp (including the timezone)

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

Käyttöoikeustimestamps:create

Pyynnön runko (JSON)

{

"year": 0,integervalinnainenSpecify the year (defaults to current year)

"month": 1,integervalinnainenmin 1, max 12Specify the month (defaults to current month)

"day": 1,integervalinnainenmin 1, max 31Specify the day (defaults to current day)

"hour": "string",string | numbervalinnainenSpecify the hour (defaults to current hour). A plain number is accepted and read as text.

"hour12": 1,integervalinnainenmin 1, max 12Specify the hour using 12-hour clock (defaults to current hour)

"am": false,booleanvalinnainenWhen True, hour must be between 1 to 12 and will be interpreted as AM (ante meridiem)

"pm": false,booleanvalinnainenWhen True, hour must be between 1 to 12 and will be interpreted as PM (post meridiem)

"minute": 0,integervalinnainenmin 0, max 59Specify the minute (defaults to current minute)

"second": 0,numbervalinnainenmin 0, max 59.999Specify the second (defaults to 0)

"timezone": "string",stringvalinnainenmin length 3Specify the timezone (defaults to GMT)

"header": false,booleanvalinnainenDisplay the initial time (as interpreted by the bot) on top of the response

"columns": "both",stringvalinnainenSpecify which columns to display in the returned response(both (both syntax and preview), preview (preview only), syntax (syntax only))

"ephemeral": falsebooleanvalinnainenWhen true the response will only be visible to you

}

Vastaukset

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,booleanvalinnainenOnly 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": {objectvalinnainenPresent 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

POST/at12Specify the exact components of the timestamp (using a 12-hour clock)

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

Käyttöoikeustimestamps:create

Pyynnön runko (JSON)

{

"year": 0,integervalinnainenSpecify the year (defaults to current year)

"month": 1,integervalinnainenmin 1, max 12Specify the month (defaults to current month)

"day": 1,integervalinnainenmin 1, max 31Specify the day (defaults to current day)

"hour": 1,integervalinnainenmin 1, max 12Specify the hour (defaults to current hour)

"am": false,booleanvalinnainenWhen True, hour will be interpreted as am (ante meridiem, before noon)

"pm": false,booleanvalinnainenWhen True, hour will be interpreted as pm (post meridiem, after noon)

"minute": 0,integervalinnainenmin 0, max 59Specify the minute (defaults to current minute)

"second": 0,numbervalinnainenmin 0, max 59.999Specify the second (defaults to 0)

"timezone": "string",stringvalinnainenmin length 3Specify the timezone (defaults to GMT)

"header": false,booleanvalinnainenDisplay the initial time (as interpreted by the bot) on top of the response

"columns": "both",stringvalinnainenSpecify which columns to display in the returned response(both (both syntax and preview), preview (preview only), syntax (syntax only))

"ephemeral": falsebooleanvalinnainenWhen true the response will only be visible to you

}

Vastaukset

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,booleanvalinnainenOnly 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": {objectvalinnainenPresent 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

POST/inSpecify a timestamp in the future relative to the current time

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

Käyttöoikeustimestamps:create

Pyynnön runko (JSON)

{

"years": 1,integervalinnainenmin 1How many years to add to the current time

"months": 1,integervalinnainenmin 1How many months to add to the current time

"days": 1,integervalinnainenmin 1How many days to add to the current time

"hours": 1,integervalinnainenmin 1How many hours to add to the current time

"minutes": 1,integervalinnainenmin 1How many minutes to add to the current time

"seconds": 0.001,numbervalinnainenmin 0.001How many seconds to add to the current time

"header": false,booleanvalinnainenDisplay the initial time (as interpreted by the bot) on top of the response

"columns": "both",stringvalinnainenSpecify which columns to display in the returned response(both (both syntax and preview), preview (preview only), syntax (syntax only))

"ephemeral": falsebooleanvalinnainenWhen true the response will only be visible to you

}

Vastaukset

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,booleanvalinnainenOnly 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": {objectvalinnainenPresent 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

POST/isoDisplay the syntaxes for a specific ISO 8601 timestamp

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

Käyttöoikeustimestamps:create

Pyynnön runko (JSON)

{

"value": "string",stringmin length 10, max length 25The ISO 8601 standard timestamp

"timezone": "string",stringvalinnainenmin length 3Specify the timezone (defaults to GMT)

"header": false,booleanvalinnainenDisplay the initial time (as interpreted by the bot) on top of the response

"columns": "both",stringvalinnainenSpecify which columns to display in the returned response(both (both syntax and preview), preview (preview only), syntax (syntax only))

"ephemeral": falsebooleanvalinnainenWhen true the response will only be visible to you

}

Vastaukset

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,booleanvalinnainenOnly 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": {objectvalinnainenPresent 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

POST/snowflakeDisplay the syntax for the timestamp of a Snowflake (most IDs within Discord)

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

Käyttöoikeustimestamps:create

Pyynnön runko (JSON)

{

"value": "string",stringmin length 1The Snowflake number

"header": false,booleanvalinnainenDisplay the initial time (as interpreted by the bot) on top of the response

"columns": "both",stringvalinnainenSpecify which columns to display in the returned response(both (both syntax and preview), preview (preview only), syntax (syntax only))

"ephemeral": falsebooleanvalinnainenWhen true the response will only be visible to you

}

Vastaukset

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,booleanvalinnainenOnly 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": {objectvalinnainenPresent 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

POST/subtractSubtract some time from the specified UNIX timestamp

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

Käyttöoikeustimestamps:create

Pyynnön runko (JSON)

{

"from": 0,numberThe UNIX timestamp in seconds

"years": 1,integervalinnainenmin 1How many years to subtract from the specified timestamp

"months": 1,integervalinnainenmin 1How many months to subtract from the specified timestamp

"days": 1,integervalinnainenmin 1How many days to subtract from the specified timestamp

"hours": 1,integervalinnainenmin 1How many hours to subtract from the specified timestamp

"minutes": 1,integervalinnainenmin 1How many minutes to subtract from the specified timestamp

"seconds": 0.001,numbervalinnainenmin 0.001How many seconds to subtract from the specified timestamp

"header": false,booleanvalinnainenDisplay the initial time (as interpreted by the bot) on top of the response

"columns": "both",stringvalinnainenSpecify which columns to display in the returned response(both (both syntax and preview), preview (preview only), syntax (syntax only))

"ephemeral": falsebooleanvalinnainenWhen true the response will only be visible to you

}

Vastaukset

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,booleanvalinnainenOnly 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": {objectvalinnainenPresent 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

POST/unixDisplay the syntaxes for a specific UNIX timestamp

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

Käyttöoikeustimestamps:create

Pyynnön runko (JSON)

{

"value": 0,integerThe UNIX timestamp in seconds

"header": false,booleanvalinnainenDisplay the initial time (as interpreted by the bot) on top of the response

"columns": "both",stringvalinnainenSpecify which columns to display in the returned response(both (both syntax and preview), preview (preview only), syntax (syntax only))

"ephemeral": falsebooleanvalinnainenWhen true the response will only be visible to you

}

Vastaukset

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,booleanvalinnainenOnly 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": {objectvalinnainenPresent 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

GET/settingsRead the settings

PATCH/settingsChange the settings

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

Käyttöoikeussettings:write

Pyynnön runko (JSON)

{

"ephemeral": false,boolean | nullvalinnainen

"timezone": "string",string | nullvalinnainenmin length 1, max length 64

"header": false,boolean | nullvalinnainen

"boldPreview": false,boolean | nullvalinnainen

"columns": "both",string | nullvalinnainen(both, preview, syntax)

"format": "d",string | nullvalinnainen(d, D, t, T, f, F, s, S, R)

"formatMinimalReply": false,boolean | nullvalinnainen

"telemetry": false,boolean | nullvalinnainen

"defaultAtHour": 0,integer | nullvalinnainenmin 0, max 23

"defaultAt12Hour": 1,integer | nullvalinnainenmin 1, max 12

"defaultAtMinute": 0,integer | nullvalinnainenmin 0, max 59

"defaultAtSecond": 0integer | nullvalinnainenmin 0, max 59

}

Vastaukset

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

GET/meShow the key's account and permissions

server info

Service status

GET/healthCheck that the service is up

Käyttää MCP-palvelinta

MCP-palvelin käyttää Streamable HTTP -siirtotapaa ja samoja avaimia. Se tarjoaa yhden työkalun kutakin komentoia kohti sekä asetukset, ja vain niitä työkaluja joita avaimesi asetukset sallivat.

Palvelimen URL-osoite

https://api.hammertime.cyou/mcp

Avain seuraavissa esimerkeissä on keksitty, se ei toimi. Korvaa se yhdellä omista avaimistasi.

Lisää se Claude Codeen seuraavasti:

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

Toiset asiakasohjelmat ottavat samanlaisia konfiguraatioita, URL-osoitteen ja Authorization-otsikon kanssa:

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