> DOC_API_

L'API di Link-To ti permette di creare URL abbreviati in modo programmatico. La nostra API è RESTful, restituisce risposte JSON e utilizza codici di risposta HTTP standard. Questa documentazione fornisce tutte le informazioni necessarie per integrare il nostro servizio di abbreviazione URL nelle tue applicazioni.

Scarica le nostre specifiche API in formato machine-readable per l'integrazione con strumenti come Postman, Swagger UI o generatori automatici di SDK.

Tutte le richieste API richiedono l'autenticazione tramite la tua chiave API. Puoi ottenere la tua chiave API dalla dashboard del tuo account dopo aver acquistato un piano con API abilitata.

$ ottieni_chiave_api()

1. Accedi alla tua dashboard account
2. Vai su Impostazioni Account
3. La tua chiave API sarà visualizzata nella sezione Accesso API
4. Copia la tua chiave API e conservala in modo sicuro

$ metodi_autenticazione()

Supportiamo due metodi di autenticazione per retrocompatibilità:

Metodo 1: Autenticazione Header (Consigliato)

X-API-Key: la_tua_chiave_api_qui
Content-Type: application/json

Metodo 2: Parametro POST (Legacy)

apikey=la_tua_chiave_api_qui&url=https://esempio.com

$ curl_moderno()

curl -X POST https://link-to.site/create \
  -H 'Content-Type: application/json' \
  -H 'X-API-Key: la_tua_chiave_api_qui' \
  -d '{
    "url": "https://esempio.com"
  }'

$ curl_legacy()

curl -X POST https://link-to.site/create \
  -d 'apikey=la_tua_chiave_api_qui' \
  -d 'url=https://esempio.com'

$ esempio_php()

<?php
$apiUrl = 'https://link-to.site/create';
$apiKey = 'la_tua_chiave_api_qui';

$data = json_encode([
    'url' => 'https://esempio.com'
]);

$options = [
    'http' => [
        'method' => 'POST',
        'header' => [
            'Content-Type: application/json',
            'X-API-Key: ' . $apiKey
        ],
        'content' => $data
    ]
];

$context = stream_context_create($options);
$response = file_get_contents($apiUrl, false, $context);
$result = json_decode($response, true);

if ($result['success'] === 'true') {
    echo "URL Breve: " . $result['short_url'];
} else {
    echo "Errore: " . $result['message'];
}
?>

$ esempio_javascript()

const apiUrl = 'https://link-to.site/create';
const apiKey = 'la_tua_chiave_api_qui';

const data = {
    url: 'https://esempio.com'
};

fetch(apiUrl, {
    method: 'POST',
    headers: {
        'Content-Type': 'application/json',
        'X-API-Key': apiKey
    },
    body: JSON.stringify(data)
})
.then(response => response.json())
.then(result => {
    if (result.success === 'true') {
        console.log('URL Breve:', result.short_url);
    } else {
        console.error('Errore:', result.message);
    }
})
.catch(error => console.error('Richiesta fallita:', error));

$ esempio_python()

import requests
import json

api_url = 'https://link-to.site/create'
api_key = 'la_tua_chiave_api_qui'

data = {
    'url': 'https://esempio.com'
}

headers = {
    'Content-Type': 'application/json',
    'X-API-Key': api_key
}

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

if result['success'] == 'true':
    print(f"URL Breve: {result['short_url']}")
else:
    print(f"Errore: {result['message']}")

Risposta di Successo

{
    "success": "true",
    "timestamps": "2025/11/13 16:53:37",
    "message": "Certificazione completata",
    "error": "",
    "short_code": "abc123",
    "short_url": "https://link-to.site/abc123",
    "long_url": "https://esempio.com",
    "qr_code": "https://link-to.site/qrcode/abc123.png",
    "title": "Dominio di Esempio",
    "clicks": 0
}

Risposta di Errore

{
    "success": "false",
    "timestamps": "2025/11/13 16:53:37",
    "message": "Chiave API non rilevata",
    "error": "301"
}

L'API utilizza i seguenti codici di errore per indicare problemi specifici:

Per garantire un utilizzo equo e la stabilità del sistema, le richieste API sono limitate:

Se superi il limite di richieste, riceverai una risposta di errore 429. Il limite si resetta ogni ora. Se hai bisogno di limiti più alti, contatta il supporto.

• Proteggi la tua chiave API: Non esporla mai nel codice lato client o nei repository pubblici
• Gestisci gli errori con grazia: Controlla sempre il campo success e gestisci gli errori appropriatamente
• Memorizza le risposte in cache: Salva gli URL abbreviati per evitare chiamate API duplicate
• Usa codici personalizzati con saggezza: Scegli codici brevi memorabili e brandizzati quando appropriato
• Rispetta i limiti di richieste: Implementa il backoff esponenziale se raggiungi i limiti
• Valida gli URL: Assicurati che gli URL siano validi prima di inviarli all'API

Hai bisogno di aiuto? Siamo qui per assisterti:

• Email: support@link-to.site
• Modulo di Contatto: Contattaci