HammerTime Beta

Πρόσβαση API

Δημιουργήστε χρονοσημάνσεις και αλλάξτε τις ρυθμίσεις της εφαρμογής σας από τα δικά σας προγράμματα. Κάθε τελικό σημείο αντιστοιχεί σε μια εντολή εφαρμογής και οι αιτήσεις ακολουθούν τις ρυθμίσεις του λογαριασμού Discord για τις οποίες δημιουργήθηκε το κλειδί.

Κλειδιά API

Συνδεθείτε για να δημιουργήσετε κλειδιά API. Τα κλειδιά λειτουργούν ως ένας από τους λογαριασμούς Discord που είναι συνδεδεμένοι με το προφίλ σας.

Χρήση του API

Στείλτε το κλειδί σας ως token χωρίς κατοχύρωση στην κεφαλίδα «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Δημιουργία χρονοσημάνσεων με τα σημεία τερματισμού χρονοσημάνσεων και τα εργαλεία MCP, όπως λειτουργεί ο λογαριασμός Discord για το κλειδί.
settings:readΑνάγνωση των ρυθμίσεων της εφαρμογής αυτού του λογαριασμού.
settings:writeΑλλαγή των ρυθμίσεων της εφαρμογής αυτού του λογαριασμού, μόνο τα πεδία που έχουν αποσταλεί.

Οι αιτήσεις υπόκεινται σε περιορισμό συχνότητας ανά κλειδί. Οι κεφαλίδες RateLimit κάθε απόκρισης σας ενημερώνουν για την τρέχουσα κατάσταση, ενώ η απόκριση 429 συνοδεύεται από μια κεφαλίδα Retry-After.

Οι εκτελέσεις καταγράφονται όπως οι εντολές της εφαρμογής, και η απάντηση αναφέρει ποια εκτέλεση ήταν, εκτός αν έχετε απενεργοποιήσει την τηλεμετρία στις ρυθμίσεις της εφαρμογής σας.

Αναφορά τελικού σημείου

Κάθε τελικό σημείο με τα πεδία που δέχεται και τις απαντήσεις που παρέχει. Αυτά αντλούνται από την προδιαγραφή 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 χρησιμοποιεί το πρωτόκολλο μεταφοράς 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"

Άλλοι clients χρησιμοποιούν παρόμοια διαμόρφωση, με τη διεύθυνση URL και μια κεφαλίδα εξουσιοδότησης:

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