API di accorciamento link di Linkly

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

Correlato: Analytics API | 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 per le richieste API di creazione 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 al codice sorgente per la tua applicazione. Non è necessario dedicare tempo a un'integrazione complessa. La nostra API è completamente leggibile dalle macchine.

---

Specifica 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 ciò che è fornito di seguito. Gli stessi endpoint sono disponibili anche come una collezione Postman con un clic.

Visualizza specifiche OpenAPI

Esegui in Postman

Autorizzazione

Avrai bisogno di:

• La tua chiave API
• ID dell'area di lavoro

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 utilizzare JSON con le specifiche Open API.

Esempio di richiesta usando curl

Il codice di seguito 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 di successo restituirà un oggetto JSON che rappresenta il link, insieme a un link id.

{
    "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 useresti per creare il link, ma includi il campo id per il link che desideri aggiornare, insieme alle modifiche.

Creazione di rotatori via API

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

Ad esempio:

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

Creazione di geo-reindirizzamenti via API

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

Ad 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 alfa-2.

Creazione di reindirizzamenti dispositivo via API

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

Ad 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 sola 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/link?api_key=XXXXXXXXXXX

Quindi, usa lo stesso schema di cui sopra per i singoli casi di link, ma avvolgi 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/workspace/WORKSPACE_ID/links?api_key=API_KEY'

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

Tieni presente che può volerci fino a 60 secondi per una richiesta di grandi dimensioni. Se le richieste richiedono più tempo di questo, falliranno e dovresti considerare di dividere il tuo carico di lavoro in blocchi più piccoli.

Limiti di velocità

L'API di accorciamento 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

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