Riferimento API
Nayalink espone un'API REST completamente tipizzata. Tutto ciò che puoi fare nella dashboard — creare link brevi, gestire campagne e tag e leggere analisi dei clic rispettose della privacy — è disponibile a livello di codice.
Per un riferimento interattivo in cui puoi provare le richieste nel browser, apri il riferimento API interattivo. Il contratto leggibile dalle macchine è il documento OpenAPI.
URL di base
Tutti gli endpoint sono serviti da https://api.nayalink.co.
Autenticazione
Autenticati con una chiave API inviata come token Bearer:
Authorization: Bearer <your-api-key>
Le chiavi API sono disponibili con i piani Pro e Business e possono essere limitate a permessi specifici. Gestiscile in Impostazioni → Token API.
Creare un link breve
È richiesto solo original_url:
curl -X POST https://api.nayalink.co/api/v1/links \
-H "Authorization: Bearer <your-api-key>" \
-H "Content-Type: application/json" \
-d '{"original_url": "https://example.com/very/long/url"}'
La risposta contiene il codice breve generato e l'URL breve completo.
Risorse
- Link — crea, aggiorna e gestisci link brevi: codici personalizzati, scadenza, protezione con password e regole di routing.
- Campagne — raggruppa i link in campagne e aggrega le analisi tra di esse.
- Tag — organizza i link con tag colorati.
- Analytics — leggi analisi dei clic aggregate e rispettose della privacy: visite nel tempo, paesi, città, referrer, browser, sistemi operativi, tipi di dispositivo, lingue e parametri UTM. Non viene memorizzato alcun indirizzo IP.
- Token API — crea e revoca chiavi API con ambito limitato.
- Profilo — leggi e aggiorna l'account autenticato.
Prossimi passi
- Prova le richieste in modo interattivo nel riferimento API.
- Nuovo su Nayalink? Inizia con l'introduzione.