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 (10 सितंबर 2026) लोग: दावों और रिकॉर्ड पर कलाकार और निर्माता क्रेडिट, लोग एंडपॉइंट्स, क्रेडिट प्रस्ताव।
  • 0.1.0 (10 सितंबर 2026) पहला बीटा: टोकन, प्रति घंटा 200; दावे, रिकॉर्ड, कलाकार, वाद्ययंत्र और खोज पढ़ना; दावों, स्रोतों, कलाकारों और रिकॉर्ड के लिए प्रस्ताव; निर्यात फ़ीड।