Scoreplay

Diese Anleitung beschreibt, wie du die ScorePlay API in deine Anwendung integrierst, um gezielt nach Medieninhalten (z. B. Videos oder Bilder) basierend auf Tags oder anderen Filtern zu suchen. Die Integration soll sicher, effizient und einfach umsetzbar sein.

---

🧰 Voraussetzungen

Bevor du startest, solltest du Folgendes vorbereitet haben:

• Ein aktives ScorePlay-Konto

• Zugang zum ScorePlay-Dashboard

• Kenntnisse in einer Programmiersprache wie Python oder JavaScript

• Ein HTTP-Client, z. B.:

  • requests (Python)

  • axios oder fetch (JavaScript)

Die ScorePlay API erfordert eine Authentifizierung per API-Key. Ohne diesen kannst du keine Anfragen senden.

---

🔑 Schritt 1: API-Schlüssel erhalten

1. Login: Melde dich in deinem ScorePlay-Konto an.

2. API-Einstellungen: Navigiere im Dashboard zu den Entwickler- oder API-Einstellungen.

3. Schlüssel generieren: Erstelle einen neuen API-Schlüssel. Möglicherweise kannst du den Zugriff beschränken – z. B.:

   • Nur Lesen

   • Schreiben

   • Projektbezogen

4. Speichern: Kopiere den Schlüssel sofort und speichere ihn sicher. Er wird oft nur einmal angezeigt!

Behandle deinen API-Key wie ein Passwort – teile ihn niemals öffentlich! Wenn du glaubst, dass der Schlüssel kompromittiert wurde, lösche ihn und generiere einen neuen.

---

🧩 Technische Anforderungen

🔧 Entwicklungsumgebung

• Programmiersprache: Python, JavaScript oder ein anderes Framework deiner Wahl.

• HTTP-Client: Zum Beispiel:

  • requests (Python)

  • axios (JavaScript)

  • curl (CLI)

---

🌐 API-Endpunkt

Basis-URL: https://api.scoreplay.io/v1/search

📥 HTTP-Anfragen

Die API unterstützt die Standardmethoden GET und POST. Zur Authentifizierung wird der API-Schlüssel im Header mitgesendet:

Authorization: Bearer <API_KEY>

🧪 Testumgebung

Wenn verfügbar, kannst du die API zunächst in einer Sandbox- oder Testumgebung verwenden, bevor du produktive Daten abrufst.

Nutze beim Testen kleine Abfrageparameter (limit=5), um die Antwortgröße zu begrenzen und Performance zu prüfen.

---

🔍 Beispiel: Suche nach Medien mit Python

import requests

# API-Schlüssel
api_key = "dein_api_schlüssel"

# Basis-URL
base_url = "https://api.scoreplay.io/v1/search"

# Suchparameter
params = {
    "tags": "Sport,Event",
    "type": "video",
    "page": 1,
    "limit": 10
}

# Header für Authentifizierung
headers = {
    "Authorization": f"Bearer {api_key}"
}

# API-Anfrage
response = requests.get(base_url, headers=headers, params=params)

if response.status_code == 200:
    data = response.json()
    print("Suchergebnisse:", data)
else:
    print("Fehler:", response.status_code, response.text)

---

🧾 Erklärung der Parameter

Parameter	Beschreibung	Beispiel
tags	Schlagwörter, nach denen gefiltert wird	Sport,Event
type	Medientyp	video, image
page	Seitennummer für Pagination	1
limit	Anzahl der Ergebnisse pro Seite	10

Die ScorePlay API unterstützt verschiedene Filteroptionen, je nach Medienart und verfügbarer Lizenz.

---

✅ Ergebnis

Nach erfolgreicher Integration kannst du:

• Medien gezielt nach Tags oder Filtern durchsuchen

• Ergebnisse paginiert und gefiltert abrufen

• Deine App oder Website mit dynamischen ScorePlay-Inhalten erweitern

Deine Anwendung ist nun bereit, die ScorePlay API sicher und performant zu nutzen!