{"title":"उपयोगिता टूल्स (time, calc, random)","slug":"tools","category":"api","summary":"सार्वजनिक उपयोगिता एंडपॉइंट्स — सर्वर समय, सुरक्षित कैलकुलेटर, रैंडम मान जनरेटर। कोई प्रमाणीकरण आवश्यक नहीं।","audience":["human","llm"],"tags":["api","tools","utility","public"],"difficulty":"beginner","updated":"2026-06-27","word_count":251,"read_minutes":1,"llm_context":"No auth required for any /tools/* endpoint.\nGET /tools/time → { time, timezone, offset }\nGET /tools/calc?expr=(10+5)*3 → { result, expr } (safe, no eval, arithmetic only)\nGET /tools/random?type=uuid → { value, type } (types: uuid, int, float, hex, alpha)\nUse case: LLM agents that need current time, safe math, or random values.\n","lang":"hi","translated":true,"requested_lang":"hi","content_markdown":"\n# उपयोगिता टूल्स\n\n`/tools` एंडपॉइंट्स सार्वजनिक उपयोगिताएँ हैं — किसी प्रमाणीकरण की आवश्यकता नहीं। ये उन LLM एजेंट्स के लिए उपयोगी हैं जिन्हें सर्वर-साइड समय, सुरक्षित गणित, या रैंडम मान चाहिए।\n\n## GET /tools/time\n\nवर्तमान सर्वर समय, टाइमज़ोन, और UTC ऑफ़सेट प्राप्त करें।\n\n```bash\ncurl https://synapse.schaefer.zone/tools/time\n```\n\nप्रतिक्रिया:\n\n```json\n{\n \"time\": \"2026-06-27T14:30:00.000Z\",\n \"timezone\": \"Europe/Berlin\",\n \"offset\": 120\n}\n```\n\nउपयोग का मामला: LLM एजेंट्स जिन्हें शेड्यूलिंग, टाइमस्टैम्प्स, या सापेक्ष तिथि गणना के लिए \"अभी क्या समय है\" जानना चाहिए।\n\n## GET /tools/calc\n\nसुरक्षित कैलकुलेटर — केवल अंकगणित, कोई `eval()` नहीं। `+`, `-`, `*`, `/`, `%`, `(`, `)`, और संख्याओं का समर्थन करता है।\n\n```bash\ncurl \"https://synapse.schaefer.zone/tools/calc?expr=(10+5)*3\"\n```\n\nप्रतिक्रिया:\n\n```json\n{\n \"result\": 45,\n \"expr\": \"(10+5)*3\"\n}\n```\n\n> [!TIP]\n> दिमाग में या स्ट्रिंग पार्सिंग के माध्यम से गणित करने के बजाय इसका उपयोग करें। यह सुरक्षित (कोई कोड इंजेक्शन संभव नहीं) और सटीक है।\n\n### समर्थित ऑपरेटर\n\n- `+` जोड़\n- `-` घटाव\n- `*` गुणन\n- `/` भाग\n- `%` मॉड्यूलो\n- `(` `)` कोष्ठक\n- संख्याएँ (पूर्णांक और दशमलव)\n\n### उदाहरण\n\n```bash\ncurl \".../tools/calc?expr=2+2\" # → 4\ncurl \".../tools/calc?expr=3.14*100\" # → 314\ncurl \".../tools/calc?expr=100%7\" # → 2\ncurl \".../tools/calc?expr=(2+3)*4-1\" # → 19\n```\n\n## GET /tools/random\n\nरैंडम मान जनरेट करें।\n\n```bash\n# UUID v4\ncurl \"https://synapse.schaefer.zone/tools/random?type=uuid\"\n# → { \"value\": \"a1b2c3d4-...\", \"type\": \"uuid\" }\n\n# Integer (default range 0-100)\ncurl \"https://synapse.schaefer.zone/tools/random?type=int&min=1&max=10\"\n# → { \"value\": 7, \"type\": \"int\" }\n\n# Float\ncurl \"https://synapse.schaefer.zone/tools/random?type=float&min=0&max=1\"\n# → { \"value\": 0.7234, \"type\": \"float\" }\n\n# Hex string\ncurl \"https://synapse.schaefer.zone/tools/random?type=hex&min=8&max=16\"\n# → { \"value\": \"a3f7b2c1\", \"type\": \"hex\" }\n\n# Alphabetic string\ncurl \"https://synapse.schaefer.zone/tools/random?type=alpha&min=8&max=12\"\n# → { \"value\": \"kQmzPwXn\", \"type\": \"alpha\" }\n```\n\n### प्रकार पैरामीटर\n\n| प्रकार | पैरामीटर | आउटपुट |\n|------|-----------|--------|\n| `uuid` | कोई नहीं | UUID v4 स्ट्रिंग |\n| `int` | `min`, `max` (डिफ़ॉल्ट 0-100) | पूर्णांक |\n| `float` | `min`, `max` (डिफ़ॉल्ट 0-100) | फ़्लोट |\n| `hex` | `min`, `max` (लंबाई दायरा, डिफ़ॉल्ट 8-16) | हेक्स स्ट्रिंग |\n| `alpha` | `min`, `max` (लंबाई दायरा, डिफ़ॉल्ट 8-16) | अक्षरीय स्ट्रिंग |\n\n## LLM एजेंट्स के लिए उपयोग के मामले\n\n### अद्वितीय ID जनरेट करें\n\n```bash\nID=$(curl -s .../tools/random?type=uuid | jq -r .value)\ncurl -X POST .../memory -d \"{\\\"key\\\": \\\"task_$ID\\\", ...}\"\n```\n\n### प्रतिशत की गणना\n\n```bash\nTOTAL=142\nDONE=87\nPERCENT=$(curl -s \".../tools/calc?expr=($DONE*100)/$TOTAL\" | jq -r .result)\necho \"Progress: $PERCENT%\"\n```\n\n### वर्तमान टाइमस्टैम्प प्राप्त करें\n\n```bash\nNOW=$(curl -s .../tools/time | jq -r .time)\ncurl -X POST .../var -d \"{\\\"key\\\": \\\"last_run\\\", \\\"value\\\": \\\"$NOW\\\"}\"\n```\n\n### परीक्षण डेटा जनरेट करें\n\n```bash\nfor i in {1..10}; do\n NAME=$(curl -s \".../tools/random?type=alpha&min=5&max=10\" | jq -r .value)\n curl -X POST .../memory -d \"{\\\"key\\\": \\\"test_$i\\\", \\\"content\\\": \\\"$NAME\\\"}\"\ndone\n```\n\n## अगले कदम\n\n- [API Overview](/docs/api/overview) — सभी एंडपॉइंट समूह\n- [त्रुटियाँ और त्रुटि प्रबंधन](/docs/api/errors)\n","content_html":"

उपयोगिता टूल्स

\n

/tools एंडपॉइंट्स सार्वजनिक उपयोगिताएँ हैं — किसी प्रमाणीकरण की आवश्यकता नहीं। ये उन LLM एजेंट्स के लिए उपयोगी हैं जिन्हें सर्वर-साइड समय, सुरक्षित गणित, या रैंडम मान चाहिए।

\n

GET /tools/time

\n

वर्तमान सर्वर समय, टाइमज़ोन, और UTC ऑफ़सेट प्राप्त करें।

\n
curl https://synapse.schaefer.zone/tools/time

प्रतिक्रिया:

\n
{\n  "time": "2026-06-27T14:30:00.000Z",\n  "timezone": "Europe/Berlin",\n  "offset": 120\n}

उपयोग का मामला: LLM एजेंट्स जिन्हें शेड्यूलिंग, टाइमस्टैम्प्स, या सापेक्ष तिथि गणना के लिए "अभी क्या समय है" जानना चाहिए।

\n

GET /tools/calc

\n

सुरक्षित कैलकुलेटर — केवल अंकगणित, कोई eval() नहीं। +, -, *, /, %, (, ), और संख्याओं का समर्थन करता है।

\n
curl "https://synapse.schaefer.zone/tools/calc?expr=(10+5)*3"

प्रतिक्रिया:

\n
{\n  "result": 45,\n  "expr": "(10+5)*3"\n}
दिमाग में या स्ट्रिंग पार्सिंग के माध्यम से गणित करने के बजाय इसका उपयोग करें। यह सुरक्षित (कोई कोड इंजेक्शन संभव नहीं) और सटीक है।

समर्थित ऑपरेटर

\n\n

उदाहरण

\n
curl ".../tools/calc?expr=2+2"          # → 4\ncurl ".../tools/calc?expr=3.14*100"     # → 314\ncurl ".../tools/calc?expr=100%7"        # → 2\ncurl ".../tools/calc?expr=(2+3)*4-1"    # → 19

GET /tools/random

\n

रैंडम मान जनरेट करें।

\n
# UUID v4\ncurl "https://synapse.schaefer.zone/tools/random?type=uuid"\n# → { "value": "a1b2c3d4-...", "type": "uuid" }\n\n# Integer (default range 0-100)\ncurl "https://synapse.schaefer.zone/tools/random?type=int&min=1&max=10"\n# → { "value": 7, "type": "int" }\n\n# Float\ncurl "https://synapse.schaefer.zone/tools/random?type=float&min=0&max=1"\n# → { "value": 0.7234, "type": "float" }\n\n# Hex string\ncurl "https://synapse.schaefer.zone/tools/random?type=hex&min=8&max=16"\n# → { "value": "a3f7b2c1", "type": "hex" }\n\n# Alphabetic string\ncurl "https://synapse.schaefer.zone/tools/random?type=alpha&min=8&max=12"\n# → { "value": "kQmzPwXn", "type": "alpha" }

प्रकार पैरामीटर

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
प्रकारपैरामीटरआउटपुट
uuidकोई नहींUUID v4 स्ट्रिंग
intmin, max (डिफ़ॉल्ट 0-100)पूर्णांक
floatmin, max (डिफ़ॉल्ट 0-100)फ़्लोट
hexmin, max (लंबाई दायरा, डिफ़ॉल्ट 8-16)हेक्स स्ट्रिंग
alphamin, max (लंबाई दायरा, डिफ़ॉल्ट 8-16)अक्षरीय स्ट्रिंग
\n

LLM एजेंट्स के लिए उपयोग के मामले

\n

अद्वितीय ID जनरेट करें

\n
ID=$(curl -s .../tools/random?type=uuid | jq -r .value)\ncurl -X POST .../memory -d "{\\"key\\": \\"task_$ID\\", ...}"

प्रतिशत की गणना

\n
TOTAL=142\nDONE=87\nPERCENT=$(curl -s ".../tools/calc?expr=($DONE*100)/$TOTAL" | jq -r .result)\necho "Progress: $PERCENT%"

वर्तमान टाइमस्टैम्प प्राप्त करें

\n
NOW=$(curl -s .../tools/time | jq -r .time)\ncurl -X POST .../var -d "{\\"key\\": \\"last_run\\", \\"value\\": \\"$NOW\\"}"

परीक्षण डेटा जनरेट करें

\n
for i in {1..10}; do\n  NAME=$(curl -s ".../tools/random?type=alpha&min=5&max=10" | jq -r .value)\n  curl -X POST .../memory -d "{\\"key\\": \\"test_$i\\", \\"content\\": \\"$NAME\\"}"\ndone

अगले कदम

\n\n","urls":{"html":"/docs/api/tools","text":"/docs/api/tools?format=text","json":"/docs/api/tools?format=json","llm":"/docs/api/tools?format=llm"},"translations_available":["en","zh","hi","es","fr","ar","pt","ru","ja","de","it","ko","nl","pl","tr","sv","vi","th","id","uk"]}