API di accorciamento dei link di Linkly

Crea, aggiorna e gestisci link a livello di programmazione utilizzando l'API di accorciamento dei link di Linkly.

Correlato: API Analytics | Webhooks

Prima di iniziare

Linkly genera richieste API nell'interfaccia per te da copiare e incollare nelle tue applicazioni.

Questo funziona per la creazione di link e l'aggiornamento di link.

Risparmia tempo e lascia che facciamo il lavoro difficile:

1. 1
   Vedi di seguito le richieste API di creazione dei link.
2. 2
   Copia le richieste per intero. Puoi verificare che funzionino per te.
3. 3
   Chiedi a ChatGPT o equivalente di adattare queste richieste in codice sorgente per la tua applicazione. Non è necessario dedicare tempo a un'integrazione complessa. La nostra API è completamente machine-consumable.

---

Specifiche OpenAPI 3.0

Puoi generare richieste API direttamente dall'interfaccia utente di Linkly.

L'API di Linkly è documentata utilizzando lo standard OpenAPI, che va oltre quanto fornito di seguito. Gli stessi endpoint sono disponibili anche come collezione Postman con un clic.

Visualizza specifiche OpenAPI

Esegui in Postman

Autorizzazione

Avrai bisogno di:

• La tua chiave API
• ID Workspace

Puoi ottenere questi dettagli da dentro Linkly.

1. 1
   Accedi a Linkly.
2. 2
   Fai clic su Impostazioni.
3. 3
   Fai clic su Chiavi API.

Creazione o aggiornamento di un link

Per creare un link, tutto ciò che devi fare è inviare una richiesta POST a:

https://app.linklyhq.com/api/v1/link

con i seguenti campi nel corpo.

Il tipo di codifica è x-www-form-urlencoded o application/json.

Se stai inviando il campo Rules, devi usare application/json.

Ti consigliamo di usare JSON con le specifiche Open API.

Esempio di richiesta usando curl

Il codice seguente illustra come effettuare una richiesta API per creare un link.

curl -X POST https://app.linklyhq.com/api/v1/link
-H 'cache-control: no-cache'
-d 'api_key=your_secret_key&workspace_id=1&url=http%3A%2F%2Fwww.wikijob.co.uk&name=Test%20Link'

Una risposta riuscita restituirà un oggetto JSON che rappresenta il link, insieme a un id link.

{
    "id": 9512,
    "url": "https://www.wikijob.co.uk",
    "name": "Test Link",
    "note": null,
    "head_tags": null,
    "body_tags": null,
    "linkify_words": null,
    "replacements": null,
    "enabled": true,
    "cloaking": false,
    "forward_params": false,
    "hide_referrer": false,
    "block_bots": false,
    "skip_social_crawler_tracking": false,
    "public_analytics": false,
    "password": null,
    "domain": null,
    "slug": null,
    "utm_source": null,
    "utm_medium": null,
    "utm_campaign": null,
    "utm_term": null,
    "utm_content": null,
    "og_title": null,
    "og_description": null,
    "og_image": null,
    "fb_pixel_id": null,
    "tiktok_pixel_id": null,
    "ga4_tag_id": null,
    "gtm_id": null,
    "full_url": "https://l.linklyhq.com/l/2TQ",
    "rules": [],
    "expiry_datetime": null,
    "expiry_destination": null,
    "expiry_clicks": null,
    "qr_styles": null,
    "webhooks": [],
    "notify_user_ids": [],
    "workspace_id": 1448,
    "deleted": false
}

Aggiornamento di un link

Per aggiornare un link, invia la stessa richiesta che utilizzeresti per creare il link, ma includi il campo id per il link che desideri aggiornare, insieme alle modifiche.

Creazione di rotatori tramite API

Per creare un rotatore, invia un campo chiamato rules come array JSON, insieme al payload del link di cui sopra. Devi usare application/json per inviare array JSON.

Per esempio:

[
  {"what": "rotator", "url": "https://www.microsoft.com", "percentage": "50"},
  {"what": "rotator", "url": "https://www.apple.com", "percentage": "50"}
]

Creazione di geo-redirect tramite API

Per reindirizzare per paese, invia un campo chiamato rules come array JSON, insieme al payload del link di cui sopra. Devi usare la codifica application/json per inviare array JSON.

Per esempio:

[
  {"what": "country", "url": "https://www.microsoft.com", "matches": "UK"},
  {"what": "country", "url": "https://www.apple.com", "matches": "US"}
]

Il paese è il codice paese ISO 3166 alpha-2.

Creazione di device redirect tramite API

Per reindirizzare per dispositivo, invia un campo chiamato rules come array JSON, insieme al payload del link di cui sopra.

Per esempio:

[
  {"what": "platform", "url": "https://www.google.com", "matches": "windows"},
  {"what": "platform", "url": "https://www.apple.com", "matches": "ios"}
]

Dove il campo matches è uno di:

• ios
• android
• windows
• linux
• mac

Creazione o aggiornamento di più link in una richiesta

Linkly supporta la creazione/modifica di fino a 1000 link per richiesta.

Per farlo, invia la tua chiave API come parte della richiesta come segue:

https://app.linklyhq.com/api/v1/links?api_key=XXXXXXXXXXX

Quindi, utilizza lo stesso schema di cui sopra per i casi di link individuali, ma racchiudi le richieste di link in un array, della forma:

[{link}, {link}]

Ecco una richiesta completa che aggiornerà due link:

wget --no-check-certificate \
  --method POST \
  --timeout=0 \
  --header 'Content-Type: application/json' \
  --body-data '[
    {
        "workspace_id": "WORKSPACE_ID",
        "url": "https://nature.com",
        "name": "Test",
        "id": LINK_ID
    },
    {
        "workspace_id": "WORKSPACE_ID",
        "url": "https://science.com",
        "id": LINK_ID
    }
]' \
   'https://app.linklyhq.com/api/v1/links?api_key=API_KEY'

Questo funziona sia per le azioni di creazione che di aggiornamento.

Ti preghiamo di essere consapevole che può richiedere fino a 60 secondi per una richiesta di grandi dimensioni. Se le richieste impiegano più di questo, falliranno, e dovresti considerare di dividere il tuo carico di lavoro in blocchi più piccoli.

Limiti di velocità

L'API di accorciamento dei link è limitata a 20 richieste/secondo. Fino a 200 richieste al secondo sono disponibili su richiesta. Puoi caricare fino a 1000 link in una singola richiesta.

Correlato

• API Analytics - Esporta dati di click e rapporti sul traffico
• Webhooks - Notifiche di click in tempo reale
• Integrazione Zapier - Integrazioni senza codice