API di Accorciamento Link di Linkly

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

Correlato: API di 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 pesante:

1. 1
   Vedi sotto per le richieste API di creazione link.
2. 2
   Copia le richieste nella loro interezza. 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 spendere tempo per un'integrazione complessa. La nostra API è completamente consumabile da macchina.

---

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 quanto fornito di seguito. Gli stessi endpoint sono disponibili anche come una raccolta Postman con un click.

Visualizza Specifica 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 quello 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 la specifica Open API.

Esempio di Richiesta usando cURL

Il codice sottostante 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 vuoi 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 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 tramite 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 alpha-2.

Creazione di Reindirizzamenti Dispositivo tramite 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 dei seguenti:

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

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

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

Tieni presente che può volerci fino a 60 secondi per una richiesta grande. 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 Frequenza

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

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