نسخ صفحة
أعلى كل صفحة من التوثيق زر «نسخ للذكاء الاصطناعي». ينسخ الصفحة بصيغة Markdown: عناوينها وجداولها وأمثلتها، وكل مسار فيها بمعاملاته وحقوله وحالاته كاملة، والروابط كاملة. الصقها في محادثتك مع ChatGPT أو Claude، أو اختر من قائمة الزر أن تسأل أحدهما عن الصفحة مباشرة.
ولكل صفحة نسخة على عنوانها نفسه مع .md في آخره:
| الصفحة | نسختها |
|---|---|
https://new.wasmenia.com/developers/docs | https://new.wasmenia.com/developers/docs.md |
https://new.wasmenia.com/developers/docs/reference/brands-get | https://new.wasmenia.com/developers/docs/reference/brands-get.md |
النسخة تتبع الصفحة المنشورة، فتتغير حين تتغير.
التوثيق كله
| الملف | ما فيه |
|---|---|
https://new.wasmenia.com/llms.txt | فهرس صفحات التوثيق بصيغة llms.txt، كل صفحة رابطًا إلى نسختها |
https://new.wasmenia.com/llms-full.txt | كل صفحات التوثيق في ملف واحد، بترتيب الفهرس |
https://new.wasmenia.com/api/v1/openapi.json | المسارات بمعاملاتها وحقولها وحالاتها، بصيغة OpenAPI 3.1 |
أعطِ المساعد الفهرس ليقرأ منه ما يحتاجه صفحةً صفحة، أو الملف الكامل حين تريد التوثيق كله في محادثة واحدة. «نسخ التوثيق كاملًا» في قائمة الزر ينسخ الملف الكامل.
مواصفة OpenAPI
المواصفة مبنية من المرجع نفسه الذي تُرسم منه صفحات المرجع، فلا تختلف عنه: كل معامل بنوعه وحدوده، وكل حقل بنوعه وما إذا كان قد يأتي فارغًا، وكل حالة بجسمها. أوصافها بالإنجليزية، وأضف ?lang=ar للعربية.
استوردها في Postman أو Insomnia، أو ولّد منها أنواعًا لكودك:
أنواع من المواصفة
# Types for TypeScript, from the specificationnpx openapi-typescript 'https://new.wasmenia.com/api/v1/openapi.json' -o wasmenia-api.d.ts# Models for Python (pydantic)datamodel-codegen --url 'https://new.wasmenia.com/api/v1/openapi.json' \ --input-file-type openapi --output wasmenia_api.pyتعليمات للمساعد
حين تطلب من مساعد أن يكتب كودًا بالواجهة، أعطه هذه التعليمات مع رابط الفهرس، فيكتب ما يتوافق مع الحدود والحقول الغائبة من أول مرة.
التعليمات
instructions.txt
أنت تكتب كودًا يستخدم واجهة وسمينيا للمطورين.التوثيق: https://new.wasmenia.com/llms.txtالمواصفة: https://new.wasmenia.com/api/v1/openapi.json- اطلب الواجهة من الخادم فقط. المفتاح من متغير البيئة WASMENIA_API_KEY، في ترويسة Authorization: Bearer.- لا تضع المفتاح في الرابط ولا في كود المتصفح.- name.en وأي حقل غير معروف قد يأتي null، والقوائم قد تأتي فارغة. لا تملأ الغائب بتخمين.- قراءة سجل جهة تُحسب سحبًا من حد الشهر، فخزّن السجل عندك. البحث والقائمة لا يُحسبان.- عند 429 انتظر Retry-After ثانية ثم أعد مرة واحدة. عند 402 لا تُعد قبل X-Quota-Reset.- اتبع 308 حين تغيّر جهة slug، وحدّث ما حفظته.- لا تخترع حقلًا ولا مسارًا ليس في المواصفة.وكيل يستدعي الواجهة
لا يوجد خادم MCP لوسمينيا بعد. يكفي الوكيلَ أداتان فوق HTTP: البحث بالاسم، ثم قراءة السجل بمعرّفه. صف الأداتين للنموذج بمعاملاتهما، واجعل خادمك ينفذهما بالمفتاح، فلا يمر المفتاح بالمحادثة ولا يُكتب في سجلها.
كل استدعاء لقراءة السجل سحب من حد الشهر، فاحفظ ما قرأه الوكيل ولا تكرر طلبه في المحادثة نفسها.
الأداتان
tools.json
[ { "name": "search_brands", "description": "Search Wasmenia's archive of logos by brand name, in Arabic or English. Returns up to 8 matches, closest first, each with its slug.", "input_schema": { "type": "object", "properties": { "q": { "type": "string", "minLength": 2, "maxLength": 120 } }, "required": ["q"] } }, { "name": "get_brand", "description": "Read one brand's record by its slug: names, country, colours, current logo files and older versions. Fields the archive does not know are null. Each call counts as one pull.", "input_schema": { "type": "object", "properties": { "slug": { "type": "string" } }, "required": ["slug"] } }]