{"title":"Outils utilitaires (heure, calcul, aléatoire)","slug":"tools","category":"api","summary":"Endpoints utilitaires publics — heure serveur, calculatrice sûre, générateur de valeurs aléatoires. Aucune authentification requise.","audience":["human","llm"],"tags":["api","tools","utility","public"],"difficulty":"beginner","updated":"2026-06-27","word_count":278,"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":"fr","translated":true,"requested_lang":"fr","content_markdown":"\n# Outils utilitaires\n\nLes endpoints `/tools` sont des utilitaires publics — aucune authentification requise.\nIls sont utiles pour les agents LLM qui ont besoin de l'heure côté serveur, de calculs\nsûrs ou de valeurs aléatoires.\n\n## GET /tools/time\n\nRécupère l'heure actuelle du serveur, le fuseau horaire et le décalage UTC.\n\n```bash\ncurl https://synapse.schaefer.zone/tools/time\n```\n\nRéponse :\n\n```json\n{\n \"time\": \"2026-06-27T14:30:00.000Z\",\n \"timezone\": \"Europe/Berlin\",\n \"offset\": 120\n}\n```\n\nCas d'usage : agents LLM qui ont besoin de savoir « quelle heure est-il maintenant »\npour la planification, les horodatages ou les calculs de dates relatives.\n\n## GET /tools/calc\n\nCalculatrice sûre — arithmétique uniquement, pas d'`eval()`. Prend en charge `+`, `-`,\n`*`, `/`, `%`, `(`, `)` et les nombres.\n\n```bash\ncurl \"https://synapse.schaefer.zone/tools/calc?expr=(10+5)*3\"\n```\n\nRéponse :\n\n```json\n{\n \"result\": 45,\n \"expr\": \"(10+5)*3\"\n}\n```\n\n> [!TIP]\n> Utilisez ceci plutôt que d'essayer de faire des calculs de tête ou via l'analyse\n> de chaînes. C'est sûr (aucune injection de code possible) et précis.\n\n### Opérateurs pris en charge\n\n- `+` addition\n- `-` soustraction\n- `*` multiplication\n- `/` division\n- `%` modulo\n- `(` `)` parenthèses\n- Nombres (entiers et décimaux)\n\n### Exemples\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\nGénère des valeurs aléatoires.\n\n```bash\n# UUID v4\ncurl \"https://synapse.schaefer.zone/tools/random?type=uuid\"\n# → { \"value\": \"a1b2c3d4-...\", \"type\": \"uuid\" }\n\n# Entier (plage par défaut 0-100)\ncurl \"https://synapse.schaefer.zone/tools/random?type=int&min=1&max=10\"\n# → { \"value\": 7, \"type\": \"int\" }\n\n# Flottant\ncurl \"https://synapse.schaefer.zone/tools/random?type=float&min=0&max=1\"\n# → { \"value\": 0.7234, \"type\": \"float\" }\n\n# Chaîne hexadécimale\ncurl \"https://synapse.schaefer.zone/tools/random?type=hex&min=8&max=16\"\n# → { \"value\": \"a3f7b2c1\", \"type\": \"hex\" }\n\n# Chaîne alphabétique\ncurl \"https://synapse.schaefer.zone/tools/random?type=alpha&min=8&max=12\"\n# → { \"value\": \"kQmzPwXn\", \"type\": \"alpha\" }\n```\n\n### Paramètres par type\n\n| Type | Paramètres | Sortie |\n|------|-----------|--------|\n| `uuid` | aucun | Chaîne UUID v4 |\n| `int` | `min`, `max` (par défaut 0-100) | Entier |\n| `float` | `min`, `max` (par défaut 0-100) | Flottant |\n| `hex` | `min`, `max` (plage de longueur, par défaut 8-16) | Chaîne hexadécimale |\n| `alpha` | `min`, `max` (plage de longueur, par défaut 8-16) | Chaîne alphabétique |\n\n## Cas d'usage pour les agents LLM\n\n### Générer des identifiants uniques\n\n```bash\nID=$(curl -s .../tools/random?type=uuid | jq -r .value)\ncurl -X POST .../memory -d \"{\\\"key\\\": \\\"task_$ID\\\", ...}\"\n```\n\n### Calculer des pourcentages\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### Obtenir l'horodatage courant\n\n```bash\nNOW=$(curl -s .../tools/time | jq -r .time)\ncurl -X POST .../var -d \"{\\\"key\\\": \\\"last_run\\\", \\\"value\\\": \\\"$NOW\\\"}\"\n```\n\n### Générer des données de test\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## Prochaines étapes\n\n- [Vue d'ensemble de l'API](/docs/api/overview) — tous les groupes d'endpoints\n- [Erreurs & gestion des erreurs](/docs/api/errors)\n","content_html":"

Outils utilitaires

\n

Les endpoints /tools sont des utilitaires publics — aucune authentification requise.\nIls sont utiles pour les agents LLM qui ont besoin de l'heure côté serveur, de calculs\nsûrs ou de valeurs aléatoires.

\n

GET /tools/time

\n

Récupère l'heure actuelle du serveur, le fuseau horaire et le décalage UTC.

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

Réponse :

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

Cas d'usage : agents LLM qui ont besoin de savoir « quelle heure est-il maintenant »\npour la planification, les horodatages ou les calculs de dates relatives.

\n

GET /tools/calc

\n

Calculatrice sûre — arithmétique uniquement, pas d'eval(). Prend en charge +, -,\n*, /, %, (, ) et les nombres.

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

Réponse :

\n
{\n  "result": 45,\n  "expr": "(10+5)*3"\n}
Utilisez ceci plutôt que d'essayer de faire des calculs de tête ou via l'analyse\nde chaînes. C'est sûr (aucune injection de code possible) et précis.

Opérateurs pris en charge

\n\n

Exemples

\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

Génère des valeurs aléatoires.

\n
# UUID v4\ncurl "https://synapse.schaefer.zone/tools/random?type=uuid"\n# → { "value": "a1b2c3d4-...", "type": "uuid" }\n\n# Entier (plage par défaut 0-100)\ncurl "https://synapse.schaefer.zone/tools/random?type=int&min=1&max=10"\n# → { "value": 7, "type": "int" }\n\n# Flottant\ncurl "https://synapse.schaefer.zone/tools/random?type=float&min=0&max=1"\n# → { "value": 0.7234, "type": "float" }\n\n# Chaîne hexadécimale\ncurl "https://synapse.schaefer.zone/tools/random?type=hex&min=8&max=16"\n# → { "value": "a3f7b2c1", "type": "hex" }\n\n# Chaîne alphabétique\ncurl "https://synapse.schaefer.zone/tools/random?type=alpha&min=8&max=12"\n# → { "value": "kQmzPwXn", "type": "alpha" }

Paramètres par type

\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
TypeParamètresSortie
uuidaucunChaîne UUID v4
intmin, max (par défaut 0-100)Entier
floatmin, max (par défaut 0-100)Flottant
hexmin, max (plage de longueur, par défaut 8-16)Chaîne hexadécimale
alphamin, max (plage de longueur, par défaut 8-16)Chaîne alphabétique
\n

Cas d'usage pour les agents LLM

\n

Générer des identifiants uniques

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

Calculer des pourcentages

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

Obtenir l'horodatage courant

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

Générer des données de test

\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

Prochaines étapes

\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"]}