{"title":"Scripts API","slug":"scripts","category":"api","summary":"تخزين دائم للسكربتات — احفظ سكربتات shell أو Python أو Node القابلة لإعادة الاستخدام وجلبها عبر curl | bash.","audience":["human","llm"],"tags":["api","scripts","automation","snippets"],"difficulty":"beginner","updated":"2026-06-27","word_count":127,"read_minutes":1,"llm_context":"Auth: Mind Key or JWT\nStore: POST /script { name, content, description?, language? }\nFetch as text: GET /script/:name (returns text/plain, curl | bash ready)\nInfo: GET /script/:name/info (metadata without content)\nList: GET /scripts (JSON array)\nDelete: DELETE /script/:name\nUse case: store deployment scripts, config generators, troubleshooting snippets\n","lang":"ar","translated":true,"requested_lang":"ar","content_markdown":"\n# Scripts API\n\nتُوفّر Scripts API تخزينًا دائمًا للسكربتات القابلة لإعادة الاستخدام. تُسمّى\nالسكربتات وتُنسب إصداراتها داخل عقل، ويمكن جلبها كنص عادي — مثالية لأنماط\n`curl | bash`.\n\n## نقاط النهاية\n\n### POST /script\n\nتخزين سكربت أو تحديثه.\n\n```bash\ncurl -X POST https://synapse.schaefer.zone/script \\\n -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"name\": \"deploy-synapse\",\n \"content\": \"#!/bin/bash\\nset -euo pipefail\\ngit pull\\nnpm ci\\nnpm run build\\ndocker compose up -d\",\n \"description\": \"Deploy Synapse to production\",\n \"language\": \"bash\"\n }'\n```\n\n### GET /script/:name\n\nجلب محتوى السكربت كـ `text/plain`. مثالي للتمرير إلى bash.\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/script/deploy-synapse | bash\n```\n\n### GET /script/:name/info\n\nالحصول على بيانات السكربت الوصفية دون المحتوى.\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/script/deploy-synapse/info\n```\n\nالاستجابة:\n\n```json\n{\n \"name\": \"deploy-synapse\",\n \"description\": \"Deploy Synapse to production\",\n \"language\": \"bash\",\n \"size_bytes\": 142,\n \"created_at\": \"2026-06-27T...\",\n \"updated_at\": \"2026-06-27T...\"\n}\n```\n\n### GET /scripts\n\nقائمة بجميع السكربتات في العقل الحالي.\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/scripts\n```\n\n### DELETE /script/:name\n\nحذف سكربت.\n\n```bash\ncurl -X DELETE -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/script/deploy-synapse\n```\n\n## حالات الاستخدام الشائعة\n\n### سكربتات النشر\n\nخزّن إجراءات النشر القياسية حتى يتمكن LLM من تشغيلها دون إعادة اشتقاق\nالخطوات في كل مرة:\n\n```bash\n# يخزّن LLM هذا مرة واحدة\ncurl -X POST .../script -d '{\n \"name\": \"deploy-vps1\",\n \"content\": \"#!/bin/bash\\nssh vps1 \\\"cd /opt/synapse && git pull && docker compose up -d --build\\\"\",\n \"language\": \"bash\"\n}'\n\n# الجلسات اللاحقة تشغّله فقط\ncurl -H \"Authorization: ...\" .../script/deploy-vps1 | bash\n```\n\n### مقتطفات استكشاف الأخطاء\n\nخزّن أوامر التشخيص للمشكلات الشائعة:\n\n```bash\ncurl -X POST .../script -d '{\n \"name\": \"check-docker\",\n \"content\": \"#!/bin/bash\\ndocker ps\\ndocker stats --no-stream\\ndocker system df\",\n \"description\": \"Quick Docker health check\",\n \"language\": \"bash\"\n}'\n```\n\n### مولّدات الإعدادات\n\nخزّن سكربتات تُولّد الإعدادات:\n\n```bash\ncurl -X POST .../script -d '{\n \"name\": \"gen-nginx-conf\",\n \"content\": \"#!/usr/bin/env python3\\nimport sys\\n# ... generate nginx config from template ...\",\n \"language\": \"python\"\n}'\n```\n\n## الخطوات التالية\n\n- [Variables API](/docs/api/variables)\n- [Cron والمجدول](/docs/api/cron)\n","content_html":"

Scripts API

\n

تُوفّر Scripts API تخزينًا دائمًا للسكربتات القابلة لإعادة الاستخدام. تُسمّى\nالسكربتات وتُنسب إصداراتها داخل عقل، ويمكن جلبها كنص عادي — مثالية لأنماط\ncurl | bash.

\n

نقاط النهاية

\n

POST /script

\n

تخزين سكربت أو تحديثه.

\n
curl -X POST https://synapse.schaefer.zone/script \\\n  -H "Authorization: Bearer YOUR_MIND_KEY" \\\n  -H "Content-Type: application/json" \\\n  -d '{\n    "name": "deploy-synapse",\n    "content": "#!/bin/bash\\nset -euo pipefail\\ngit pull\\nnpm ci\\nnpm run build\\ndocker compose up -d",\n    "description": "Deploy Synapse to production",\n    "language": "bash"\n  }'

GET /script/:name

\n

جلب محتوى السكربت كـ text/plain. مثالي للتمرير إلى bash.

\n
curl -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     https://synapse.schaefer.zone/script/deploy-synapse | bash

GET /script/:name/info

\n

الحصول على بيانات السكربت الوصفية دون المحتوى.

\n
curl -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     https://synapse.schaefer.zone/script/deploy-synapse/info

الاستجابة:

\n
{\n  "name": "deploy-synapse",\n  "description": "Deploy Synapse to production",\n  "language": "bash",\n  "size_bytes": 142,\n  "created_at": "2026-06-27T...",\n  "updated_at": "2026-06-27T..."\n}

GET /scripts

\n

قائمة بجميع السكربتات في العقل الحالي.

\n
curl -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     https://synapse.schaefer.zone/scripts

DELETE /script/:name

\n

حذف سكربت.

\n
curl -X DELETE -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     https://synapse.schaefer.zone/script/deploy-synapse

حالات الاستخدام الشائعة

\n

سكربتات النشر

\n

خزّن إجراءات النشر القياسية حتى يتمكن LLM من تشغيلها دون إعادة اشتقاق\nالخطوات في كل مرة:

\n
# يخزّن LLM هذا مرة واحدة\ncurl -X POST .../script -d '{\n  "name": "deploy-vps1",\n  "content": "#!/bin/bash\\nssh vps1 \\"cd /opt/synapse && git pull && docker compose up -d --build\\"",\n  "language": "bash"\n}'\n\n# الجلسات اللاحقة تشغّله فقط\ncurl -H "Authorization: ..." .../script/deploy-vps1 | bash

مقتطفات استكشاف الأخطاء

\n

خزّن أوامر التشخيص للمشكلات الشائعة:

\n
curl -X POST .../script -d '{\n  "name": "check-docker",\n  "content": "#!/bin/bash\\ndocker ps\\ndocker stats --no-stream\\ndocker system df",\n  "description": "Quick Docker health check",\n  "language": "bash"\n}'

مولّدات الإعدادات

\n

خزّن سكربتات تُولّد الإعدادات:

\n
curl -X POST .../script -d '{\n  "name": "gen-nginx-conf",\n  "content": "#!/usr/bin/env python3\\nimport sys\\n# ... generate nginx config from template ...",\n  "language": "python"\n}'

الخطوات التالية

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