Pređi na vsebino
cutty.dev
Za razvijalce

API in strežnik MCP

Ustvarjajte in upravljajte kratke povezave iz svoje kode — prek REST API-ja ali prek strežnika MCP v vašem pomočniku z umetno inteligenco.

cutty ima javni API in strežnik MCP. Prvi vam omogoča ustvarjanje in spreminjanje povezav iz kode, drugi pa deluje naravnost iz pomočnika z umetno inteligenco, ki govori protokol MCP. Oba uporabljata isti ključ API.

Ključ API

Vsak klic overite z glavo:

Authorization: Bearer ck_your_key

Kje dobiti ključ: prijavite se, odprite nadzorno ploščo → Ključi API → Ustvari ključ. Celoten ključ (začne se s ck_) je prikazan samo enkrat, ob nastanku — takoj ga shranite na varno mesto. Omejitev je 120 zahtev na minuto na ključ.

Osnovni URL

Vse končne točke REST so pod https://cutty.dev/api/v1. Zahteve in odgovori so v formatu JSON.

Ustvarjanje povezave

POST /api/v1/links — telo JSON potrebuje vsaj url. Vse drugo je neobvezno:

  • url — ciljni naslov (obvezno)
  • slug — lasten zaključek, 3–40 znakov; izpustite za naključnega
  • expiresAt — datum poteka v formatu ISO 8601
  • maxHits — omejitev klikov (1–1.000.000)
  • password — geslo, ki ščiti povezavo
  • tags — oznake, ločene z vejicami, za urejanje v nadzorni plošči
  • folder — ime mape, v katero gre povezava
  • utmSource, utmMedium, utmCampaign — parametri UTM, dodani ob preusmeritvi

Odgovor vam vrne slug, shortUrl in target.

curl -X POST https://cutty.dev/api/v1/links \
  -H "Authorization: Bearer ck_your_key" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/a/very/long/address","slug":"offer","tags":"campaign,summer"}'

Izpis in posamezna povezava

GET /api/v1/links vrne vse vaše povezave. GET /api/v1/links/{slug} — podrobnosti ene.

curl https://cutty.dev/api/v1/links/offer \
  -H "Authorization: Bearer ck_your_key"

Posodabljanje in brisanje

PATCH /api/v1/links/{slug} posodobi polja, ki jih posredujete, DELETE /api/v1/links/{slug} pa odstrani povezavo.

curl -X PATCH https://cutty.dev/api/v1/links/offer \
  -H "Authorization: Bearer ck_your_key" \
  -H "Content-Type: application/json" \
  -d '{"maxHits":500}'

Prek PATCH lahko med drugim nastavite: targetUrl, expiresAt, maxHits, status, password, tags, folder ter napredna polja spodaj. Polje, nastavljeno na null (ali prazen niz), počisti to lastnost.

Ciljanje, A/B in napredna polja

Iste stvari, ki jih dobite v urejevalniku povezav, so na voljo prek API-ja:

  • rules — niz pravil preusmerjanja po državi ali napravi, npr. [{"kind":"country","match":"PL","url":"https://shop.pl"},{"kind":"device","match":"ios","url":"https://apps.apple.com/..."}]
  • abUrls — rotacija A/B: niz [{"url":"https://a.com","weight":1},{"url":"https://b.com","weight":1}]; uporabi se, ko se nobeno pravilo ne ujema
  • startsAt — datum (ISO 8601), ko povezava začne delovati; pred tem vrne 425
  • webhookUrl — naslov, ki ob vsakem kliku prejme obvestilo POST (fire-and-forget)
  • serveOg z ogTitle, ogDescription, ogImageUrl — lastna kartica predogleda za pajke družbenih omrežij (ljudje še vedno dobijo preusmeritev)
curl -X PATCH https://cutty.dev/api/v1/links/offer \
  -H "Authorization: Bearer ck_your_key" \
  -H "Content-Type: application/json" \
  -d '{"rules":[{"kind":"country","match":"DE","url":"https://example.de"}]}'

Množične operacije

POST /api/v1/bulk ustvari več povezav v eni zahtevi. Posredujte niz links (vsak element kot pri običajnem ustvarjanju), do 500 naenkrat. Odgovor vrne rezultat za vsako vrstico.

curl -X POST https://cutty.dev/api/v1/bulk \
  -H "Authorization: Bearer ck_your_key" \
  -H "Content-Type: application/json" \
  -d '{"links":[{"url":"https://a.com"},{"url":"https://b.com","slug":"b"}]}'

Statistika povezave

GET /api/v1/links/{slug}/stats vrne povzetek klikov: skupno število, razčlenitev po napravi in brskalniku ter porazdelitev v zadnjih 24 urah.

curl https://cutty.dev/api/v1/links/offer/stats \
  -H "Authorization: Bearer ck_your_key"

Strežnik MCP

Če delate s pomočnikom z umetno inteligenco, lahko cutty povežete prek MCP (Model Context Protocol) in ga prosite, naj povezave krajša in ureja kar v pogovoru. Strežnik teče na https://mcp.cutty.dev/mcp prek Streamable HTTP, overite pa se z istim ključem API — glavo Authorization: Bearer ck_....

Celoten seznam orodij, pripravljeni izseki za povezavo in primeri so na ločeni strani: strežnik MCP cutty.

Kaj ne deluje?

Pišite na [email protected] — odgovorim še isti dan.