Soundito API

Bygg kraftfulla musikapplikationer med vårt omfattande API. Få tillgång till miljontals låtar, spellistor och analysdata för att skapa unika upplevelser för dina användare.

Dokumentation Kom igång

API-funktioner

Utforska kraften i Sounditos API med dessa nyckelfunktioner

Musikkatalog

Få tillgång till över 70 miljoner låtar med metadata, inklusive artister, album, genrer och mer.

Spellistor

Skapa, hantera och analysera spellistor med vårt omfattande spellist-API.

Analysdata

Få insikter om lyssningsmönster, publikdemografi och innehållsprestanda.

Användardata

Integrera med Sounditos användarsystem för personaliserade upplevelser.

Realtid

Webhooks och SSE för realtidsuppdateringar om användaraktivitet och innehåll.

Säkerhet

OAuth 2.0, API-nycklar och avancerad åtkomstkontroll för säker integration.

Kom igång

Följ dessa enkla steg för att börja använda Soundito API

1. Skapa ett utvecklarkonto

För att komma åt API:et behöver du ett utvecklarkonto och API-nyckel. Registrera dig eller logga in på ditt befintliga konto för att komma åt utvecklarpanelen. 


# Exempel på autentisering
import requests

api_key = "din_api_nyckel_här"
headers = {
    "Authorization": f"Bearer {api_key}",
    "Content-Type": "application/json"
}

response = requests.get(
    "https://api.soundito.com/v1/me",
    headers=headers
)

print(response.json())

2. Hämta din API-nyckel

När du har skapat ett konto kan du generera API-nycklar från utvecklarpanelen. Varje nyckel har specifika behörigheter och begränsningar.

Skydda din API-nyckel och dela den aldrig offentligt. För klientapplikationer, använd vårt säkra OAuth-flöde. 


// Exempel på OAuth 2.0-flöde
const authUrl = "https://auth.soundito.com/authorize?" +
    "response_type=code&" +
    "client_id=DIN_CLIENT_ID&" +
    "redirect_uri=DIN_REDIRECT_URI&" +
    "scope=user-read-private%20user-read-email&" +
    "state=STATEFUL_VALUE";

// Omdirigera användaren till authUrl
window.location.href = authUrl;

// Efter auktorisering, byt kod mot token

3. Testa API:et

Använd vår API-spelplats eller börja integrera direkt i din kod. Vi tillhandahåller klientbibliotek för flera populära programmeringsspråk. 


// Exempel på att hämta en spellista
fetch('https://api.soundito.com/v1/playlists/37i9dQZF1DXcBWIGoYBM5M', {
    headers: {
        'Authorization': 'Bearer DIN_ACCESS_TOKEN_HÄR'
    }
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));

API-dokumentation

Utforska vårt omfattande API med detaljerade slutpunkter och exempel

API-översikt

Soundito API är ett RESTful API som använder JSON för datatransport. Alla förfrågningar måste innehålla en giltig API-nyckel eller OAuth-token i Authorization-headern.

Bas-URL

https://api.soundito.com/v1

Svar

Alla lyckade förfrågningar returnerar statuskod 200 (eller 201 för skapade resurser) med svaret i JSON-format. 

{
    "data": { ... }, // Huvuddata
    "meta": { ... }, // Paginering, filtrering etc.
    "error": null    // Felmeddelande om något gick fel
}

Felhantering

Fel returneras med lämplig HTTP-statuskod och ett felmeddelande i JSON-format. 

{
    "error": {
        "code": 404,
        "message": "Resursen hittades inte",
        "details": "Spellistan med ID 123 finns inte"
    }
}

Vanliga slutpunkter

GET /tracks/{id}

Hämtar detaljerad information om en specifik låt, inklusive metadata, tillgänglighet och relaterat innehåll.

Parametrar

Namn Typ Beskrivning
id string Låtens unika ID
market string Marknadskod (ISO 3166-1 alpha-2)

Exempelsvar

{
    "data": {
        "id": "6f807x0ima9a1j3VPbc7U2",
        "name": "Blinding Lights",
        "duration_ms": 200040,
        "explicit": false,
        "artists": [
            {
                "id": "1Xyo4u8uXC1ZmMpatF05PJ",
                "name": "The Weeknd"
            }
        ],
        "album": {
            "id": "2yIwhsIWGRQzGQdn1czSK0",
            "name": "After Hours",
            "release_date": "2020-03-20"
        },
        "available_markets": ["SE", "US", "GB", ...]
    }
}
POST /playlists

Skapar en ny spellista för den autentiserade användaren.

Parametrar

Namn Typ Beskrivning
name string Spellistans namn
description string Beskrivning av spellistan
public boolean Om spellistan är publik (default: true)

Exempelförfrågan

{
    "name": "Min nya spellista",
    "description": "En samling av mina favoritlåtar",
    "public": true
}
GET /me/top/{type}

Hämtar den autentiserade användarens mest spelade låtar eller artister.

Parametrar

Namn Typ Beskrivning
type string Antingen "tracks" eller "artists"
time_range string Tidsperiod ("short_term", "medium_term", "long_term")
limit integer Antal objekt att returnera (default: 20, max: 50)

Exempelsvar

{
    "data": [
        {
            "id": "6f807x0ima9a1j3VPbc7U2",
            "name": "Blinding Lights",
            "artist": "The Weeknd",
            "play_count": 127,
            "image_url": "https://i.scdn.co/image/..."
        },
        {
            "id": "5ZBeML7Lf3FMEVviTyvi8l",
            "name": "Save Your Tears",
            "artist": "The Weeknd",
            "play_count": 98,
            "image_url": "https://i.scdn.co/image/..."
        }
    ],
    "meta": {
        "time_range": "medium_term",
        "total": 50
    }
}

Klientbibliotek

Förenkla din integration med våra officiella klientbibliotek

JavaScript

Vårt officiella JavaScript-bibliotek för både Node.js och webbläsarmiljöer.

Dokumentation GitHub

Python

Python-bibliotek för enkel integration med Flask, Django och andra ramverk.

Dokumentation GitHub

Java

Java-bibliotek för Android och backend-utveckling med Spring och andra ramverk.

Dokumentation GitHub

Letar du efter ett annat språk? Vi har fler alternativ.

Visa alla klientbibliotek

Redo att börja bygga?

Registrera dig för ett utvecklarkonto idag och få tillgång till hela Soundito API:et.