Verktyg (tid, kalkyl, slump)
Publika verktygs-endpoints — servertid, säker kalkylator, slumpvärdesgenerator. Ingen autentisering krävs.
Verktyg
/tools-endpoints är publika verktyg — ingen autentisering krävs.
De är användbara för LLM-agenter som behöver servertid, säker matematik eller
slumpvärden.
GET /tools/time
Hämta aktuell servertid, tidszon och UTC-offset.
curl https://synapse.schaefer.zone/tools/timeSvar:
{
"time": "2026-06-27T14:30:00.000Z",
"timezone": "Europe/Berlin",
"offset": 120
}Användningsområde: LLM-agenter som behöver veta "vilken tid är det nu" för schemaläggning, tidsstämplar eller relativa datumberäkningar.
GET /tools/calc
Säker kalkylator — endast aritmetik, ingen eval(). Stöder +, -, *, /,
%, (, ) och tal.
curl "https://synapse.schaefer.zone/tools/calc?expr=(10+5)*3"Svar:
{
"result": 45,
"expr": "(10+5)*3"
}Använd detta istället för att försöka räkna i huvudet eller via strängtolkning.
Det är säkert (ingen kodinjektion möjlig) och korrekt.
Operatorer som stöds
+addition-subtraktion*multiplikation/division%modulo()parenteser- Tal (heltal och decimaler)
Exempel
curl ".../tools/calc?expr=2+2" # → 4
curl ".../tools/calc?expr=3.14*100" # → 314
curl ".../tools/calc?expr=100%7" # → 2
curl ".../tools/calc?expr=(2+3)*4-1" # → 19GET /tools/random
Generera slumpvärden.
# UUID v4
curl "https://synapse.schaefer.zone/tools/random?type=uuid"
# → { "value": "a1b2c3d4-...", "type": "uuid" }
# Integer (default range 0-100)
curl "https://synapse.schaefer.zone/tools/random?type=int&min=1&max=10"
# → { "value": 7, "type": "int" }
# Float
curl "https://synapse.schaefer.zone/tools/random?type=float&min=0&max=1"
# → { "value": 0.7234, "type": "float" }
# Hex string
curl "https://synapse.schaefer.zone/tools/random?type=hex&min=8&max=16"
# → { "value": "a3f7b2c1", "type": "hex" }
# Alphabetic string
curl "https://synapse.schaefer.zone/tools/random?type=alpha&min=8&max=12"
# → { "value": "kQmzPwXn", "type": "alpha" }Typ-parametrar
| Typ | Parametrar | Utdata |
|---|---|---|
uuid |
inga | UUID v4-sträng |
int |
min, max (standard 0-100) |
Heltal |
float |
min, max (standard 0-100) |
Flyttal |
hex |
min, max (längdintervall, standard 8-16) |
Hex-sträng |
alpha |
min, max (längdintervall, standard 8-16) |
Alfabetisk sträng |
Användningsområden för LLM-agenter
Generera unika ID:n
ID=$(curl -s .../tools/random?type=uuid | jq -r .value)
curl -X POST .../memory -d "{\"key\": \"task_$ID\", ...}"Beräkna procentandelar
TOTAL=142
DONE=87
PERCENT=$(curl -s ".../tools/calc?expr=($DONE*100)/$TOTAL" | jq -r .result)
echo "Progress: $PERCENT%"Hämta aktuell tidsstämpel
NOW=$(curl -s .../tools/time | jq -r .time)
curl -X POST .../var -d "{\"key\": \"last_run\", \"value\": \"$NOW\"}"Generera testdata
for i in {1..10}; do
NAME=$(curl -s ".../tools/random?type=alpha&min=5&max=10" | jq -r .value)
curl -X POST .../memory -d "{\"key\": \"test_$i\", \"content\": \"$NAME\"}"
doneNästa steg
- API-översikt — alla endpoint-grupper
- Fel & felhantering