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 หากเกินขีดจำกัดจะได้รับรหัส 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 ไดเรกทอรีในฐานะงานรวบรวม และส่วนที่คัดลอกอย่างมีนัยสำคัญ เช่น ข้อมูลส่งออก อยู่ภายใต้สัญญาอนุญาต Open Database Licence: ให้เครดิตไดเรกทอรี และแบ่งปันฐานข้อมูลที่คุณต่อยอดกลับคืน สัญญาอนุญาตเชิงพาณิชย์สำหรับผลิตภัณฑ์แบบปิดสามารถขอได้จาก Box Of Rules

ข้อตกลง

เอกสาร OpenAPI 3.1 · llms.txt · ai-catalog.json

การเปลี่ยนแปลง

  • 0.1.1 (10 กันยายน 2026) บุคคล: เครดิตนักแสดงและโปรดิวเซอร์บนข้อกล่าวอ้างและผลงานเพลง เอนด์พอยต์บุคคล ข้อเสนอเครดิต
  • 0.1.0 (10 กันยายน 2026) เบต้าแรก: โทเคน 200 ครั้งต่อชั่วโมง อ่านข้อกล่าวอ้าง ผลงานเพลง ศิลปิน เครื่องดนตรี และการค้นหา เสนอข้อกล่าวอ้าง แหล่งข้อมูล ศิลปิน และผลงานเพลง และฟีดข้อมูลส่งออก