Per sviluppatori e agenti AI
Il tuo prossimo link.
Basta una chiamata API.
Abbrevia un URL. Genera un codice QR. Lascia le attività ripetitive al tuo agente: tutti i risultati restano nel tuo spazio LinkDirect.
REST + MCP · Chiavi con permessi · Inizia con Free
{
"destinationUrl": "https://example.com/offer",
"title": "My next campaign",
"utm": {
"source": "newsletter",
"medium": "email"
}
}201 Created
Un link tracciabile, pronto da condividere.
Link brevi senza cambiare scheda
Mantieni i parametri della campagna e crea link dalla tua app, da un’automazione o da una conversazione con l’AI.
Codici QR collegati al tuo spazio
Genera codici QR dinamici per siti web, scarica PNG o SVG e gestisci le destinazioni dalla dashboard.
Il tuo spazio. I tuoi permessi.
Assegna a ogni connessione solo i permessi necessari. Imposta una scadenza, controlla l’ultimo utilizzo e revoca l’accesso quando vuoi.
Gestisci tutta la campagna.
Crea link, aggiorna le destinazioni e scopri cosa funziona dal tuo assistente o dalla tua applicazione.
- Modifica destinazioni, titoli, parametri UTM e regole GEO senza cambiare il link breve.
- Chiedi i 10 link più cliccati da Facebook negli ultimi 7 giorni oppure consulta i risultati di un singolo link.
- Crea o aggiorna fino a 50 link in un’unica operazione atomica. Se un elemento fallisce, viene annullato l’intero gruppo.
- Scegli un dominio attivo del tuo account per nome. Senza copiare UUID, inventare identificatori o usare un altro dominio senza avvisare.
Le scritture richiedono la tua conferma e rispettano i limiti del piano. L’analisi richiede analytics:read; l’elenco domini account:read. Aggiorna gli strumenti del client o ricollegalo per approvare i permessi mancanti. Non li estendiamo automaticamente.
Dall’account al primo link.
- 1Crea il tuo account e verifica l’email. Puoi iniziare con il piano Free.
- 2Apri API & MCP, assegna un nome alla connessione e scegli i permessi.
- 3Conserva la chiave al sicuro e invia la prima richiesta. Il nuovo link comparirà nella dashboard.
La tua prima richiesta
curl 'https://linkdirect.co/api/v1/links' \
-H "Authorization: Bearer $LINKDIRECT_API_KEY" \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: my-campaign-link-01' \
--data '{"destinationUrl":"https://example.com"}'Usa una nuova chiave di idempotenza per ogni creazione. Riutilizzala quando ripeti la stessa richiesta.
I tuoi strumenti AI. Un solo standard di connessione.
Usa LinkDirect dal tuo assistente o editor preferito. Claude e ChatGPT supportano l’accesso dal browser tramite i loro client OAuth pubblicati. Claude Code, Codex, Cursor, VS Code e altri client MCP compatibili possono usare chiavi API private.
Scegli il client in API & MCP per le istruzioni di connessione, la gestione dei segreti e la configurazione da copiare. La disponibilità dipende dalla versione e dalle impostazioni dell’account.
Scegli la configurazioneIndirizzo del server Streamable HTTP
https://linkdirect.co/mcpOAuth + PKCE per i client browser compatibili · Chiavi Bearer private per API e MCP
create_short_linkcreate_qr_codelist_domainsget_account_limitsget_qr_code_imagelist_short_linkslist_qr_codesget_short_linkget_qr_codeupdate_short_linkget_top_linksget_link_analyticsbulk_create_short_linksbulk_update_short_links
Usa get_qr_code_image per recuperare un QR nel client AI. Scollega le app OAuth o revoca le chiavi separatamente in API & MCP. Restano validi i permessi e i limiti del tuo spazio di lavoro.
API semplici. Funzioni utili.
URL di base: https://linkdirect.co/api/v1
| Metodo | Endpoint | Funzione | Permesso |
|---|---|---|---|
| GET | /account | Piano, utilizzo e limiti | account:read |
| GET | /domains | Domini attivi, ID e supporto dei percorsi personalizzati | account:read |
| POST | /links | Crea un link breve | links:write |
| GET | /links | Elenca i tuoi link brevi | links:read |
| GET | /links/{id} | Leggi un link breve | links:read |
| POST | /qr-codes | Crea un codice QR dinamico | qr:write |
| GET | /qr-codes | Elenca i tuoi codici QR | qr:read |
| GET | /qr-codes/{id} | Leggi un codice QR | qr:read |
| GET | /qr-codes/{id}/image | Scarica PNG o SVG | qr:read |
| PATCH | /links/{id} | Modifica un link breve | links:write |
| POST | /links/batch | Crea un gruppo di link | links:write |
| PATCH | /links/batch | Aggiorna i link selezionati della campagna | links:write |
| GET | /analytics/links | Classifica i link per clic | analytics:read |
| GET | /links/{id}/analytics | Leggi le statistiche aggregate di un link | analytics:read |
La modifica dei link comprende regole GEO e impostazioni di condivisione. I QR di V1 accettano URL web; il loro stile si modifica nella dashboard. Anche i download REST richiedono l’autenticazione Bearer.
Inizia gratis. Cresci quando serve.
API e dashboard condividono i limiti del tuo piano. Non ci sono quote duplicate né un abbonamento API separato. Controlla l’utilizzo attuale con GET /account e passa a un piano superiore in Fatturazione quando hai bisogno di più spazio.
Automazioni sicure
- Tentativi sicuri per 24 ore. La stessa chiave di idempotenza e gli stessi dati restituiscono il risultato originale, senza duplicati.
- Limiti chiari. Free: 60 richieste al minuto e 10 creazioni al giorno, entro i limiti delle risorse dell’account. I piani a pagamento aumentano i limiti API.
- Errori con indicazioni utili. Rispetta Retry-After in caso di 429. La risposta per il limite del piano rimanda a Fatturazione; il tuo agente non cambia mai piano da solo.
Pronto a collegarti?
Crea una chiave con i permessi giusti e semplifica il tuo flusso di lavoro.
Cerchi codici di errore, regole per i nuovi tentativi o dettagli su MCP? Leggi la guida Markdown completa (in inglese).