Synth.Directory

API · বেটা 0.1.1

এই API

ডিরেক্টরির সবকিছু JSON হিসেবে উপলব্ধ: উৎস ও মিডিয়াসহ দাবি, রেকর্ড, শিল্পী, যন্ত্র, অনুসন্ধান, এবং নতুন এন্ট্রি প্রস্তাব করার একটি উপায় যা ওয়েবসাইটের মতোই একই পর্যালোচনা সারিতে যায়। এই API বেটায় আছে। সংস্করণ 0.1.1। ডিরেক্টরি স্থিতিশীল হওয়ার সাথে সাথে ফিল্ডের নাম ও আকার পরিবর্তিত হতে পারে; পরিবর্তনগুলি এই পাতার নিচে তালিকাভুক্ত আছে, এবং OpenAPI দলিল সর্বদা সঠিক বর্তমান চুক্তি।

টোকেন পাওয়া

  1. একটি অ্যাকাউন্ট তৈরি করুন এবং লগ ইন করুন।
  2. খুলুন API টোকেন টি আমার-এ গিয়ে তৈরি করুন। এটি একবারই দেখানো হয়; এটি শুরু হয়: sd_.
  3. প্রতিটি অনুরোধে এটি একটি বিয়ারার টোকেন হিসেবে পাঠান।
curl -H "Authorization: Bearer sd_..." "https://synth.directory/api/v1/claims?q=juno&status=verified"

সীমা

প্রতি টোকেনে ঘণ্টায় 200 টি অনুরোধ। প্রতিটি প্রতিক্রিয়ায় X-RateLimit-Limit ও X-RateLimit-Remaining থাকে; সীমা ছাড়ালে আপনি JSON বার্তাসহ একটি 429 পাবেন। পার্টনার এবং ডিরেক্টরির নিজস্ব বটের জন্য একটি সীমাহীন স্তর আছে; জিজ্ঞাসা করুন।

পড়া হচ্ছে

তালিকাগুলি পৃষ্ঠাবিভক্ত: 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 since ও status ফিল্টারসহ, প্রতিটি দাবিকে তার উৎস ও গৃহীত মিডিয়াসহ, প্রতি লাইনে একটি JSON অবজেক্ট হিসেবে স্ট্রিম করে। এর জন্য একটি রপ্তানি টোকেন প্রয়োজন; জিজ্ঞাসা করুন।

লাইসেন্স

স্বতন্ত্র তথ্যগুলি CC0। একটি সংকলন হিসেবে ডিরেক্টরি, এবং রপ্তানির মতো যেকোনো উল্লেখযোগ্য অংশ, ওপেন ডেটাবেস লাইসেন্সের অধীনে: ডিরেক্টরিকে কৃতিত্ব দিন, এবং আপনি এর থেকে যে ডেটাবেস তৈরি করেন তা ফিরিয়ে দিন। বন্ধ পণ্যের জন্য একটি বাণিজ্যিক লাইসেন্স Box Of Rules থেকে পাওয়া যায়।

চুক্তি

OpenAPI 3.1 দলিল · llms.txt · ai-catalog.json

পরিবর্তন

  • 0.1.1 (১০ সেপ্টেম্বর ২০২৬) মানুষ: দাবি ও রেকর্ডের ওপর পারফর্মার ও প্রযোজক ক্রেডিট, মানুষ সংক্রান্ত এন্ডপয়েন্ট, ক্রেডিট প্রস্তাব।
  • 0.1.0 (১০ সেপ্টেম্বর ২০২৬) প্রথম বেটা: টোকেন, ঘণ্টায় ২০০; দাবি, রেকর্ড, শিল্পী, যন্ত্র ও অনুসন্ধান পড়া; দাবি, উৎস, শিল্পী ও রেকর্ডের জন্য প্রস্তাব; রপ্তানি ফিড।