Zum Hauptinhalt springen

​
Einführung

Short URL ist ein Tool-Service von Ace Data Cloud, der einen Dienst zur Erstellung von Kurzlinks anbietet. Über die einheitliche API von Ace Data Cloud können Sie Short URL mit JavaScript schnell integrieren und Funktionen wie URL-Verkürzung und benutzerdefinierte Domains realisieren.

​
Voraussetzungen

  • Ein Konto bei Ace Data Cloud und ein API-Token
  • Node.js 18+ oder eine moderne Browserumgebung

​
Grundlegende Verwendung

Der Hauptendpunkt der Short URL API lautet: 
POST https://api.acedata.cloud/shorturl
Vollständiges JavaScript-Beispiel: 
const response = await fetch("https://api.acedata.cloud/shorturl", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "content": "https://platform.acedata.cloud"
}),
});

const result = await response.json();
console.log(result);
Bitte ersetzen Sie YOUR_API_TOKEN durch den tatsächlichen Token, den Sie auf der Ace Data Cloud Plattform erhalten haben.

​
Antwortverarbeitung

Es wird empfohlen, den Statuscode der Antwort zu prüfen und Fehler zu behandeln: 
if (response.ok) {
  const result = await response.json();
  console.log("Aufruf erfolgreich:", result);
} else {
  console.error(`Aufruf fehlgeschlagen, Statuscode: ${response.status}`);
  const error = await response.text();
  console.error(error);
}

​
Node.js Wrapper

Es wird empfohlen, eine wiederverwendbare Funktion zu erstellen: 
async function callShortURL(data) {
  const response = await fetch("https://api.acedata.cloud/shorturl", {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${process.env.ACE_API_TOKEN}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify(data),
  });
  if (!response.ok) throw new Error(`API Fehler: ${response.status}`);
  return response.json();
}

​
Fehlerbehandlung

Häufige Fehlercodes:
StatuscodeBeschreibung
401Authentifizierung fehlgeschlagen, bitte API-Token prüfen
403Unzureichendes Guthaben oder keine Zugriffsberechtigung
429Anfragerate überschritten
500Interner Serverfehler

​
Nächste Schritte