Przejdź do głównej treści

​
Wprowadzenie

Short URL to narzędzie oferowane przez Ace Data Cloud, służące do generowania krótkich linków. Dzięki zunifikowanemu API Ace Data Cloud możesz szybko zintegrować Short URL za pomocą JavaScript, realizując funkcje skracania URL oraz korzystania z niestandardowych domen.

​
Wymagania wstępne

  • Konto w Ace Data Cloud oraz uzyskany API Token
  • Node.js 18+ lub nowoczesne środowisko przeglądarki

​
Podstawowe użycie

Główny endpoint API Short URL to: 
POST https://api.acedata.cloud/shorturl
Pełny przykład kodu JavaScript: 
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);
Proszę zastąpić YOUR_API_TOKEN rzeczywistym tokenem uzyskanym na platformie Ace Data Cloud.

​
Obsługa odpowiedzi

Zaleca się sprawdzanie statusu odpowiedzi i obsługę błędów: 
if (response.ok) {
  const result = await response.json();
  console.log("Wywołanie zakończone sukcesem:", result);
} else {
  console.error(`Wywołanie nie powiodło się, kod statusu: ${response.status}`);
  const error = await response.text();
  console.error(error);
}

​
Opakowanie w Node.js

Zaleca się opakowanie w funkcję wielokrotnego użytku: 
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(`Błąd API: ${response.status}`);
  return response.json();
}

​
Obsługa błędów

Typowe kody błędów:
Kod statusuOpis
401Błąd uwierzytelniania, sprawdź API Token
403Niewystarczające środki lub brak dostępu
429Przekroczono limit zapytań
500Błąd wewnętrzny serwera

​
Kolejne kroki