API di Accorciamento Link di Linkly

Crea, aggiorna e gestisci link in modo programmatico utilizzando l'API di Accorciamento Link di Linkly.

Correlati: API Analytics | Webhooks

Linkly genera richieste API nell'interfaccia che puoi copiare e incollare nelle tue applicazioni.

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

Risparmia tempo e lascia che facciamo noi il lavoro difficile:

1. 1Vedi sotto per le richieste API di creazione link.
2. 2Copia le richieste nella loro interezza. Puoi verificare che funzionino per te.
3. 3Chiedi a ChatGPT o un equivalente di adattare queste richieste in codice sorgente per la tua applicazione. Non c'è bisogno di dedicare tempo a un'integrazione complessa. La nostra API è completamente utilizzabile dalle macchine.

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.

Avrai bisogno di:

• La tua Chiave API
• ID Workspace

Puoi ottenere questi dettagli da dentro Linkly.

1. 1Accedi a Linkly.
2. 2Clicca Impostazioni.
3. 3Clicca Chiavi API.

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.

Il codice qui sotto 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,
    "alias": null,
    "url": "https://www.wikijob.co.uk",
    "name": "Test Link",
    "note": null,
    "head_tags": null,
    "body_tags": null,
    "linkify_words": null,
    "enabled": true,
    "cloaking": false,
    "replacements": 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,
    "full_url": "https://l.linklyhq.com/l/2TQ",
    "block_bots": false,
    "rules": [],
    "workspace_id": 1448,
    "referer_mode": null,
    "custom_referer": null,
    "click_fraud_mode": null,
    "deleted": false
}

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.

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.

Per esempio:

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

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.

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 alpha-2 ISO 3166.

Per reindirizzare per dispositivo, invia un campo chiamato rules come array JSON, insieme al payload del link 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

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 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 di aggiornamento.

Si prega di notare che può richiedere fino a 60 secondi per una richiesta grande. Se le richieste richiedono più tempo di questo, falliranno, e dovresti considerare di suddividere il tuo carico di lavoro in blocchi più piccoli.

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.

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