API Dokumentation

Vollständige Referenz für die Relinqed API

Alle Systeme aktiv

Einführung

Die Relinqed API ermöglicht es dir, Amazon-Links automatisch in optimierte Affiliate-Deep-Links umzuwandeln. Deep-Links öffnen direkt die Amazon-App und steigern dadurch die Conversion-Rate um bis zu 300%.

Die API ist RESTful und gibt Antworten im JSON-Format zurück. Alle Anfragen müssen über HTTPS erfolgen.

Base URL

https://api.relinqed.io/v1

Authentifizierung

Für die Nutzung der API benötigst du einen API-Schlüssel. Diesen kannst du nach der Registrierung im Dashboard generieren. Der API-Schlüssel muss bei jeder Anfrage im Authorization-Header mitgesendet werden.

Authorization Header

Authorization: Bearer YOUR_API_KEY

Link konvertieren

POST/convert

Wandelt einen Amazon-Link in einen optimierten Affiliate-Deep-Link um. Die Affiliate-ID wird beibehalten, wenn vorhanden.

Parameter

Name	Typ	Erforderlich	Beschreibung
url	String	Ja	Der Amazon-Link, der konvertiert werden soll
tag	String	Nein	Deine Affiliate-ID (überschreibt die im Link vorhandene ID)

Beispielanfrage

JSON

{
  "url": "https://www.amazon.de/dp/B07FZ8S74R",
  "tag": "meinaffiliateid-21"
}

Beispielantwort

JSON

{
  "success": true,
  "converted_url": "https://amazon.de/gp/deep-link/ASIN/B07FZ8S74R?affiliate_tag=meinaffiliateid-21",
  "original_url": "https://www.amazon.de/dp/B07FZ8S74R"
}

Code-Beispiele

Python

import requests

API_KEY = "your_api_key"
API_URL = "https://api.relinqed.io/v1/convert"

headers = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json"
}

data = {
    "url": "https://www.amazon.de/dp/B07FZ8S74R",
    "tag": "meinaffiliateid-21"
}

response = requests.post(API_URL, json=data, headers=headers)
result = response.json()

if result["success"]:
    converted_url = result["converted_url"]
    print(f"Konvertierter Link: {converted_url}")
else:
    print(f"Fehler: {result.get('error')}")

JavaScript

const API_KEY = 'your_api_key';
const API_URL = 'https://api.relinqed.io/v1/convert';

const convertLink = async () => {
  const response = await fetch(API_URL, {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${API_KEY}`,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      url: 'https://www.amazon.de/dp/B07FZ8S74R',
      tag: 'meinaffiliateid-21'
    })
  });

  const result = await response.json();
  
  if (result.success) {
    const convertedUrl = result.converted_url;
    console.log(`Converted link: ${convertedUrl}`);
    return convertedUrl;
  } else {
    console.error(`Error: ${result.error}`);
    throw new Error(result.error);
  }
};

// Verwendung mit async/await
try {
  const deepLink = await convertLink();
  // Link verwenden...
} catch (error) {
  console.error(error);
}

cURL

curl -X POST https://api.relinqed.io/v1/convert \
  -H "Authorization: Bearer your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.amazon.de/dp/B07FZ8S74R",
    "tag": "meinaffiliateid-21"
  }'

Batch Konvertierung

Diese Funktion ist derzeit in Entwicklung und wird in Kürze verfügbar sein.

Conversion Statistiken

Diese Funktion ist derzeit in Entwicklung und wird in Kürze verfügbar sein.

Fehlerbehandlung

Die Relinqed API verwendet standardmäßige HTTP-Statuscodes, um den Erfolg oder Misserfolg einer API-Anfrage anzuzeigen. Zusätzlich enthält der Antworttext detaillierte Informationen über aufgetretene Fehler.

Status	Code	Beschreibung
200	OK	Die Anfrage war erfolgreich.
400	BAD_REQUEST	Die Anfrage ist fehlerhaft oder ungültig.
401	UNAUTHORIZED	Keine gültigen Authentifizierungsdaten wurden bereitgestellt.
403	FORBIDDEN	Keine ausreichenden Berechtigungen für diese Anfrage.
404	NOT_FOUND	Die angeforderte Ressource wurde nicht gefunden.
429	RATE_LIMIT_EXCEEDED	Das Rate-Limit wurde überschritten. Bitte versuche es später erneut.
500	SERVER_ERROR	Ein Serverfehler ist aufgetreten. Bitte kontaktiere den Support, wenn das Problem fortbesteht.

Beispiel für eine Fehlerantwort

JSON

{
  "success": false,
  "error": {
    "code": "INVALID_URL",
    "message": "Die angegebene URL ist keine gültige Amazon-URL.",
    "request_id": "c1b1e1a0-5c1a-11ec-b3d4-1b1d1b1d1b1d"
  }
}

Best Practices

Hier sind einige Empfehlungen, um das Beste aus der Relinqed API herauszuholen:

Caching implementieren
Speichere konvertierte Links zwischen, um wiederholte API-Anfragen zu vermeiden.
Batch-Anfragen nutzen
Für mehrere Links ist es effizienter, Batch-Anfragen zu verwenden, anstatt einzelne Anfragen zu senden.
Fehlerbehandlung einbauen
Implementiere eine robuste Fehlerbehandlung, um mit verschiedenen API-Antworten umgehen zu können.
Monitoring nutzen
Überwache API-Anfragen und -Antworten, um Probleme frühzeitig zu erkennen.

Benötigst du Hilfe?

Unser Entwicklerteam ist bereit, dir bei Fragen zur Relinqed API zu helfen. Kontaktiere uns einfach über eine der folgenden Möglichkeiten.

Support kontaktieren

Zurück zur Startseite