開發者資料
整個和弦庫，
開放成 JSON。
站內工具靠這三個只讀 JSON 介面執行，也免費開放給任何人：全部和弦指型、全部音階圖，以及互動指板的完整查表。不需要金鑰、不需要賬號、不做追蹤——取用、快取、引用即可。
- 3
- JSON 介面
- 172
- 個和弦指型
- 60
- 張音階圖
- 144
- 條指板條目
介面
三個檔案都是本站域名下的靜態檔案，帶 Access-Control-Allow-Origin: *，快取一天。JSON 與 HTML 頁面由同一份源資料生成，兩邊的數字不會互相矛盾。
和弦資料庫
172 條每個和弦指型的按弦、組成音、難度、規範頁面地址，以及各已發布語言下的和弦名。
/data/chords.json→音階資料庫
60 條5 種音階 × 全部 12 個調，含拼寫正確的音名、音級、音程、全半音公式與該調的自然和弦。
/data/scales.json→互動指板狀態表
144 條互動指板只取這一份資料，不必把 144 條和弦記錄塞進每個頁面：全部根音與性質，含琴頸上所有把位。
/data/fretboard-explorer.json→
欄位說明
6 個值的陣列按低音 E 弦到高音 E 弦排列。品位 0 是空弦，"x" 表示該弦不彈。
chords[ ]
symbol- 本站拼寫的和弦符號，如 C、F#m7、Bbadd9。
name- 完整的可讀和弦名（C major）。
root- 該條目建立在哪個根音上。
quality- 性質 id，如 major、minor、7、sus4。
slug- 該條目對應頁面的 URL slug。
hasOwnPage- 該和弦是否有獨立頁面；為 false 時指型收錄在它的性質聚合頁裡。
href- 和弦頁的站內相對路徑；url 是絕對地址。
names- 按站點語言（en、zh、zh-Hant）給出的和弦名。
notes- 這個指型實際發出的音，按音級字母拼寫，而不是套全域性升降號表。
frets- 每根弦按第幾品，低音 E 到高音 E。
fingers- 每根弦用哪根手指：1 食指、2 中指、3 無名指、4 小指、0 不用。
barres- 用一根手指橫按的品位；空陣列表示沒有橫按。
baseFret- 指法圖視窗的第一格；1 表示從琴枕開始。
difficulty- 1–5：1 是開放把位的入門指型，5 是很少有人用的大跨度。
scales[ ]
root- 該條目建立在哪個根音上。
scale- 音階型別 id，如 major、natural-minor、blues。
slug- 該條目對應頁面的 URL slug。
url- 該條目 HTML 頁面的絕對 URL。
notes- 從根音按順序拼出的音階，每個音級用正確的字母（C 自然小調是 C D Eb F G Ab Bb）。
notePitchClasses- 同一組音的音高 class（0–11），給不該解析音名的程式碼用。
degrees- 每個音的音階級數：1、2、♭3、4、5、♭6、♭7。
intervals- 相對根音的半音數，也就是生成該音階用的那組數字。
steps- 全半音公式：W 全音、H 半音、m3 小三度。
diagram- 該音階指板圖的絕對 URL。
pitchClassNames- 音高 class 到音名的對映，給指板標註用，不必自己解析拼寫。
diatonicChords- 建立在音階上的 7 個和弦，含級數、符號與組成音。
chords["C|major"]
version- 響應格式版本，當前為 1；只有響應結構不得不改時才會變。
chords["…"]- 由根音加性質 id 組成的物件鍵，如 C|major 或 F#|minor。每個值複用上面的和弦欄位，另加 voicings。
voicings- 本站知道的該根音＋性質的全部把位，每個把位自帶按弦、指序與橫按。
快速上手
命令列直接讀，或瀏覽器裡 fetch。不需要金鑰、請求頭或賬號。
curl -s https://openguitarchords.com/data/chords.json | jq '.chords[] | select(.symbol == "C")'const res = await fetch('https://openguitarchords.com/data/chords.json');
const { chords } = await res.json();
const cMajor = chords.find((c) => c.symbol === 'C');單條和弦記錄
{
"symbol": "C",
"name": "C major",
"root": "C",
"quality": "major",
"slug": "c",
"hasOwnPage": true,
"href": "/chords/c",
"url": "https://openguitarchords.com/chords/c",
"names": {
"en": "C major",
"zh": "C 大三和弦",
"zh-Hant": "C 大三和弦"
},
"notes": [
"C",
"E",
"G"
],
"frets": [
"x",
3,
2,
0,
1,
0
],
"fingers": [
0,
3,
2,
0,
1,
0
],
"barres": [],
"baseFret": 1,
"difficulty": 1
}單條音階記錄
{
"root": "C",
"scale": "major",
"scaleLabel": "Major (Ionian)",
"slug": "c-major",
"url": "https://openguitarchords.com/scales/c-major",
"notes": [
"C",
"D",
"E",
"F",
"G",
"A",
"B"
],
"notePitchClasses": [
0,
2,
4,
5,
7,
9,
11
],
"degrees": [
"1",
"2",
"3",
"4",
"5",
"6",
"7"
],
"intervals": [
0,
2,
4,
5,
7,
9,
11
],
"steps": "W-W-H-W-W-W-H"
}單條指板記錄
{
"slug": "c",
"symbol": "C",
"baseFret": 1,
"frets": [
"x",
3,
2,
0,
1,
0
],
"fingers": [
0,
3,
2,
0,
1,
0
],
"barres": [],
"difficulty": 1,
"notes": [
"C",
"E",
"G"
],
"voicings": [
{
"baseFret": 1,
"frets": [
"x",
3,
2,
0,
1,
0
],
"fingers": [
0,
3,
2,
0,
1,
0
],
"barres": []
},
{
"baseFret": 3,
"frets": [
"x",
3,
5,
5,
5,
3
],
"fingers": [
0,
1,
3,
3,
3,
1
],
"barres": [
{
"fret": 3,
"from": 1,
"to": 5
},
{
"fret": 5,
"from": 2,
"to": 4
}
]
}
]
}示例只保留最常用的欄位；真實響應包含上面列出的全部欄位。
使用與署名
資料免費使用，包括商業用途。許可不強制署名，但鏈回 Open Guitar Chords 會很有幫助，也能讓這個專案繼續維護下去。
檔案裡只有和弦與音階事實：沒有歌詞、沒有六線譜文本、沒有音訊。呈現這些資料的指法圖、頁面文字與錄音屬於本站自己的作品。
穩定性與變更
欄位名保持穩定，變更只做增量：可能出現新欄位，已有欄位的含義不變。指板介面帶版本號，只有響應結構不得不改時才會變。
檔案在邊緣快取一天，所以一次更正最多需要 24 小時才到你那邊。HTML 頁面與 JSON 出自同一份生成資料。
發現指法有誤，或需要某個缺失的欄位？聯絡頁列出了所有能找到我們的渠道。 聯絡頁