POST /api/v1/shorten

Crea uno short link per il proprietario della API key.

Body JSON

{"url":"https://example.com","title":"Landing","campaign":"spring-2026","custom_code":"promo26"}

Regola piano: su piano Free il campo custom_code viene ignorato e il sistema genera automaticamente uno short code casuale.

Risposta 201

{"short_code":"Ab3xK9q","short_url":"https://tapy.cc/Ab3xK9q","destination_url":"https://example.com"}

GET /api/v1/links

Ritorna tutti i link creati dall'utente della API key.

Risposta 200

{"data":[{"short_code":"abc123","destination_url":"https://example.com","campaign":"spring-2026","clicks":10}]}

GET /api/v1/stats/{code}

Recupera statistiche e metadata di un singolo link.

Risposta 200

{"data":{"short_code":"abc123","destination_url":"https://example.com","campaign":"spring-2026","clicks":10,"is_active":1}}

Errori standard

• 401 API key mancante o non valida
• 404 Link non trovato
• 409 Short code già in uso / limite piano raggiunto
• 422 URL non valido

cURL rapido

curl -X POST "https://tapy.cc/api/v1/shorten" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d "{\"url\":\"https://example.com\",\"campaign\":\"spring-2026\"}"