Publiczne API

Nasze publiczne API pozwala na programowe skracanie URLi. Nie wymaga klucza API ani uwierzytelnienia.

📥 POST /api/links

Wyślij pojedynczy obiekt lub tablicę obiektów, aby skrócić URL.

{
  "domain": "clc.is",
  "target_url": "https://example.com",
  "slug": "custom", // opcjonalne
  "expired_url": "https://expired.example.com", // opcjonalne
  "expired_hours": 48 // opcjonalne (0 = brak wygaśnięcia)
}

🔁 Odpowiedź:

{
  "input": { ... },
  "slug": "custom",
  "url": "https://clc.is/custom",
  "is_generated": false
}

🌐 GET /api/domains

Zwraca tablicę dostępnych domen do skracania linków.

["clc.is", "alt1.com", "alt2.com"]

⚠️ Obsługa błędów

409 Conflict — jeśli slug jest już zajęty
400 Bad Request — brak lub nieprawidłowe parametry

📦 Przetwarzanie hurtowe

Aby przesłać do 5000 URLi jednocześnie, użyj strony Hurtowe lub wyślij tablicę wpisów do /api/links.