Idi na sadržaj
cutty.dev
Za programere

API i MCP poslužitelj

Stvaraj i upravljaj kratkim linkovima iz vlastitog koda — preko REST API-ja ili preko MCP poslužitelja u svom AI asistentu.

cutty ima javni API i MCP poslužitelj. Prvi ti omogućuje stvaranje i izmjenu poveznica iz koda; drugi radi ravno iz AI asistenta koji govori MCP protokol. Oba koriste isti API ključ.

API ključ

Autenticiraj svaki poziv zaglavljem:

Authorization: Bearer ck_your_key

Gdje nabaviti ključ: prijavi se, otvori svoju nadzornu ploču → API ključevi → Stvori ključ. Cijeli ključ (počinje s ck_) prikazuje se samo jednom, pri stvaranju — odmah ga spremi na sigurno mjesto. Ograničenje je 120 zahtjeva u minuti po ključu.

Osnovni URL

Sve REST krajnje točke nalaze se pod https://cutty.dev/api/v1. Zahtjevi i odgovori su JSON.

Stvaranje poveznice

POST /api/v1/links — JSON tijelo treba barem url. Ostalo je neobavezno:

  • url — odredišna adresa (obavezno)
  • slug — prilagođeni nastavak, 3–40 znakova; izostavi za nasumični
  • expiresAt — datum isteka u ISO 8601 formatu
  • maxHits — ograničenje klikova (1–1.000.000)
  • password — lozinka koja štiti poveznicu
  • tags — oznake odvojene zarezima za organiziranje na nadzornoj ploči
  • folder — naziv mape u koju poveznica ide
  • utmSource, utmMedium, utmCampaign — UTM parametri dodani pri preusmjeravanju

Odgovor ti daje slug, shortUrl i 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"}'

Popis i pojedinačna poveznica

GET /api/v1/links vraća sve tvoje poveznice. GET /api/v1/links/{slug} — detalje jedne.

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

Ažuriranje i brisanje

PATCH /api/v1/links/{slug} ažurira polja koja proslijediš, DELETE /api/v1/links/{slug} uklanja poveznicu.

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

Putem PATCH možeš postaviti, među ostalim: targetUrl, expiresAt, maxHits, status, password, tags, folder, te napredna polja u nastavku. Polje postavljeno na null (ili prazan niz) briše to svojstvo.

Targetiranje, A/B i napredna polja

Iste stvari koje imaš u uređivaču poveznica dostupne su i kroz API:

  • rules — niz pravila preusmjeravanja po državi ili uređaju, npr. [{"kind":"country","match":"PL","url":"https://shop.pl"},{"kind":"device","match":"ios","url":"https://apps.apple.com/..."}]
  • abUrls — A/B rotacija: niz [{"url":"https://a.com","weight":1},{"url":"https://b.com","weight":1}]; koristi se kad nijedno pravilo ne odgovara
  • startsAt — datum (ISO 8601) kad poveznica postaje aktivna; prije toga poveznica vraća 425
  • webhookUrl — adresa koja prima POST obavijest pri svakom kliku (fire-and-forget)
  • serveOg s ogTitle, ogDescription, ogImageUrl — prilagođena kartica pregleda za društvene crawlere (ljudi i dalje dobivaju preusmjeravanje)
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"}]}'

Skupne operacije

POST /api/v1/bulk stvara mnogo poveznica u jednom zahtjevu. Proslijedi niz links (svaka stavka kao kod običnog stvaranja), do 500 odjednom. Odgovor vraća rezultat po retku.

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 poveznice

GET /api/v1/links/{slug}/stats vraća sažetak klikova: ukupan broj, razradu po uređaju i pregledniku te raspodjelu kroz zadnja 24 sata.

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

MCP poslužitelj

Ako radiš s AI asistentom, možeš povezati cutty preko MCP-a (Model Context Protocol) i zamoliti ga da skraćuje i organizira poveznice ravno u razgovoru. Poslužitelj radi na https://mcp.cutty.dev/mcp preko Streamable HTTP, a autenticiraš se istim API ključem — zaglavljem Authorization: Bearer ck_....

Potpuni popis alata, gotovi isječci za povezivanje i primjeri nalaze se na zasebnoj stranici: cutty MCP poslužitelj.

Nešto ne radi?

Piši na [email protected] — odgovaram istog dana.