NØISEIT

Riferimento

API

Un'API JSON pubblica, in sola lettura, per sfogliare la libreria della community su questo sito.

Questa API è attiva ora che la libreria della community è su questo sito: vedi Sito.

Panoramica

Un'API JSON pubblica, in sola lettura, per sfogliare i brani condivisi. Nessuna autenticazione. CORS aperto (*). Limite: 120 richieste al minuto per IP; oltre, ricevi un 429 con un header Retry-After. Le risposte riuscite restano in cache per un minuto.

Vengono restituiti solo i brani pubblicati. Un id sconosciuto, o un brano non pubblicato, risponde 404:

{ "error": { "code": "not_found", "message": "No published song with that id." } }

GET /api/v1/songs

Elenca e cerca i brani.

Parametri di query:

ParametroSignificato
qRicerca libera (nome, autore, note)
styleFiltra per stile JAM: pop, rock, blues, jazz, hiphop, funk, metal
feelFiltra per tag del feel
difficultyeasy, medium, hard (maiuscole e minuscole non contano)
sortnewest (predefinito), downloads, rating, bars
pageNumero di pagina, a partire da 1, predefinito 1
per_pageRisultati per pagina, predefinito 20, massimo 50

Non c'è un filtro sulla tonalità; key viene solo riportata, non letta.

Forma della risposta:

{
  "songs": [
    {
      "id": "d_OxIkOTen",
      "name": "Amber Skyline",
      "author": "NØISE",
      "style": "rock",
      "feel": "straight",
      "key": "Am",
      "difficulty": "medium",
      "bars": 32,
      "ratingAvg": 4.5,
      "ratingCount": 2,
      "downloadCount": 17,
      "updatedAt": "2026-05-01T12:00:00.000Z"
    }
  ],
  "page": 1,
  "per_page": 20,
  "total": 137
}

author e key sono null quando il brano non li ha. id è l'id pubblico del brano, lo stesso dell'URL della sua pagina.

GET /api/v1/songs/{id}

Tutti i metadati del brano: i campi qui sopra più notes (la descrizione), kit, bpm, tuning, form (le sezioni in ordine, ad esempio INTRO · VERSE ×2 · CHORUS), playsOnce, sourceUuid (il brano da cui deriva, se c'è) e createdAt.

GET /api/v1/songs/{id}/chart

Lo schema degli accordi come dati leggibili, nella stessa forma che prende build_song del server MCP: battute come array, accordi come simboli, forme come tag.

{
  "id": "d_OxIkOTen",
  "songUuid": "6F1A0E9C-3D4E-4B11-9A0B-1C2D3E4F5A6B",
  "song": {
    "name": "Amber Skyline",
    "key": "Am",
    "bpm": 120,
    "sections": [
      { "name": "VERSE", "repeats": 2, "bars": ["Am", "F", "C", "G"] }
    ]
  },
  "notes": []
}

songUuid è l'id dentro il documento, per la discendenza quando ci costruisci sopra; notes elenca, in parole semplici, tutto quello che nel brano salvato questa forma non riesce a esprimere.

GET /api/v1/songs/{id}/file

Il file .noisesong del brano (Content-Type: application/x-noise-song+json), pronto da scaricare o da passare a un link noise://: vedi Il file .noisesong e il link noise://. Un download viene contato una volta per IP al giorno.

Avanti

SitoIl file .noisesong e il link noise://
La band