Synth.Directory

API · تجريبي 0.1.1

الـ API

كل ما في الدليل متاح بصيغة JSON: الادعاءات بمصادرها ووسائطها، والتسجيلات، والفنانون، والآلات، والبحث، وطريقة لاقتراح مدخلات جديدة تصل إلى نفس قائمة انتظار المراجعة الخاصة بالموقع. الـ API في مرحلة تجريبية. الإصدار 0.1.1. قد تتغير أسماء الحقول وأشكالها مع استقرار الدليل؛ تُدرج التغييرات أسفل هذه الصفحة، ووثيقة OpenAPI هي دائمًا العقد الحالي الدقيق.

الحصول على رمز

  1. أنشئ حسابًا وسجّل الدخول.
  2. فتح رموز API ضمن مساهماتي وأنشئ واحدًا. يُعرض مرة واحدة؛ ويبدأ بـ sd_.
  3. أرسله كرمز حامل (Bearer) مع كل طلب.
curl -H "Authorization: Bearer sd_..." "https://synth.directory/api/v1/claims?q=juno&status=verified"

الحدود

200 طلب في الساعة لكل رمز. يحمل كل رد X-RateLimit-Limit وX-RateLimit-Remaining؛ وعند تجاوز الحد تحصل على رمز 429 مع رسالة JSON. توجد فئة غير محدودة للشركاء ولبوت الدليل نفسه؛ اسأل.

جارٍ القراءة

القوائم مقسّمة إلى صفحات: page وper_page (حتى 100)، مع next_page في المتن.

  • GET /api/v1/claims · q, status, origin, artist, instrument, role, since, order · GET /api/v1/claims/{id}
  • GET /api/v1/records · q, artist_id, status=wanted|claimed, since, order, with=claims · GET /api/v1/records/{id}
  • GET /api/v1/artists?q= · GET /api/v1/artists/{id}
  • GET /api/v1/instruments · q, maker, kind · GET /api/v1/instruments/{id}
  • GET /api/v1/people?q= · المؤدون والمنتجون · GET /api/v1/people/{id} · مع اعتماداتهم المقبولة
  • GET /api/v1/search?q= · فنانون وتسجيلات وآلات في إجابة واحدة

الحالات: verified, potentially, submitted, inferred (من قاعدة المعرفة، بلا مصدر بعد), disputed. يبدو صف الادعاء كسطر واحد من التصدير أدناه.

الإعدادات المسبقة والتقييمات والمفضلة مخصصة للأشخاص على الموقع فقط. لا توجد في API ولن تُصدَّر أبدًا.

جارٍ الاقتراح

يضع POST /api/v1/propose اقتراحًا في قائمة الانتظار تمامًا كما يفعل الموقع؛ ويراجعه شخص قبل نشر أي شيء. يُسجَّل اسم الرمز في الاقتراح، لذا تكون البوتات مرئية أثناء المراجعة.

{"kind": "claim", "work_id": 101, "instrument": "Minimoog", "instrument_maker": "Moog", "role": "lead",
 "source": {"grade": "A", "kind": "interview", "url": "https://...", "publication": "Sound On Sound",
            "author": "...", "published_on": "1983-06-01", "quote": "one sentence, verbatim"}}
{"kind": "source", "claim_id": 202, "source": {...}}
{"kind": "artist", "name": "Tool", "country": "US", "refs": ["https://en.wikipedia.org/...", "https://musicbrainz.org/..."]}
{"kind": "record", "artist_id": 12, "title": "Lateralus", "year": 2001, "refs": ["https://musicbrainz.org/..."]}
{"kind": "credit", "subject": "claim", "id": 202, "person": "Vince Clarke", "part": "played", "note": "on the intro only"}
{"kind": "credit", "subject": "work", "id": 101, "person": "Flood", "part": "produced"}

أجزاء الاعتماد: ادعاء played, programmed · تسجيلة produced, engineered, mixed, arranged. يُطابَق الشخص حسب الاسم بصرف النظر عن حالة الأحرف، أو يُنشأ شخص جديد. الاعتمادات حقائق، لذا فهي، خلافًا للإعدادات المسبقة، مدرجة في API والتصدير.

الدليل بأكمله

GET /export/manifest.json علني ويوضح ما هو موجود. GET /export/claims.jsonl يبث كل ادعاء مع مصادره ووسائطه المقبولة، ككائن JSON واحد في كل سطر، مع مرشحات since وstatus. يحتاج إلى رمز تصدير؛ اسأل.

الرخصة

الحقائق الفردية بموجب CC0. أما الدليل كمُجمّع، وأي مقتطف كبير منه مثل التصدير، فيخضع لرخصة قاعدة البيانات المفتوحة: انسب الفضل إلى الدليل، وشارك أي قاعدة بيانات تشتقها منه. تتوفر رخصة تجارية للمنتجات المغلقة من Box Of Rules.

العقد

وثيقة OpenAPI 3.1 · llms.txt · ai-catalog.json

التغييرات

  • 0.1.1 (10 سبتمبر 2026) الأشخاص: اعتمادات الأداء والإنتاج على الادعاءات والتسجيلات، ونقاط نهاية الأشخاص، ومقترحات الاعتمادات.
  • 0.1.0 (10 سبتمبر 2026) الإصدار التجريبي الأول: رموز، 200 في الساعة، قراءة الادعاءات والتسجيلات والفنانين والآلات والبحث؛ اقتراح ادعاءات ومصادر وفنانين وتسجيلات؛ وتغذية التصدير.