Pāriet pie satura
cutty.dev
Izstrādātājiem

API un MCP serveris

Veido un pārvaldi īsās saites tieši no sava koda — izmantojot REST API vai MCP serveri savā AI asistentā.

cutty ir publisks API un MCP serveris. Pirmais ļauj veidot un mainīt saites no koda; otrais darbojas tieši no AI asistenta, kas runā MCP protokolā. Abi izmanto vienu un to pašu API atslēgu.

API atslēga

Autentificē katru izsaukumu ar galveni:

Authorization: Bearer ck_your_key

Kur dabūt atslēgu: pieslēdzies, atver savu vadības paneli → API atslēgas → Izveidot atslēgu. Pilnā atslēga (tā sākas ar ck_) tiek parādīta tikai vienu reizi, izveides brīdī — saglabā to drošā vietā uzreiz. Ierobežojums ir 120 pieprasījumi minūtē uz vienu atslēgu.

Bāzes URL

Visi REST galapunkti atrodas zem https://cutty.dev/api/v1. Pieprasījumi un atbildes ir JSON.

Saites izveide

POST /api/v1/links — JSON pamatdaļai nepieciešama vismaz url. Pārējais ir neobligāts:

  • url — galamērķa adrese (obligāti)
  • slug — pielāgota beigu daļa, 3–40 rakstzīmes; izlaid, lai būtu nejauša
  • expiresAt — derīguma beigu datums ISO 8601 formātā
  • maxHits — klikšķu limits (1–1 000 000)
  • password — parole, kas aizsargā saiti
  • tags — ar komatu atdalītas birkas kārtošanai vadības panelī
  • folder — mapes nosaukums, kurā saite tiek ievietota
  • utmSource, utmMedium, utmCampaign — UTM parametri, kas tiek pievienoti pāradresācijā

Atbilde tev sniedz slug, shortUrl un 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"}'

Saraksts un atsevišķa saite

GET /api/v1/links atgriež visas tavas saites. GET /api/v1/links/{slug} — vienas saites detaļas.

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

Atjaunināšana un dzēšana

PATCH /api/v1/links/{slug} atjaunina laukus, kurus nodod, DELETE /api/v1/links/{slug} noņem saiti.

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

Caur PATCH vari iestatīt, cita starpā: targetUrl, expiresAt, maxHits, status, password, tags, folder, kā arī zemāk minētos uzlabotos laukus. Lauks, kas iestatīts uz null (vai tukšu virkni), notīra šo īpašību.

Mērķēšana, A/B un uzlabotie lauki

To pašu, ko dabū saites redaktorā, var izmantot arī caur API:

  • rules — pāradresācijas noteikumu masīvs pēc valsts vai ierīces, piem., [{"kind":"country","match":"PL","url":"https://shop.pl"},{"kind":"device","match":"ios","url":"https://apps.apple.com/..."}]
  • abUrls — A/B rotācija: masīvs [{"url":"https://a.com","weight":1},{"url":"https://b.com","weight":1}]; tiek izmantots, kad neviens noteikums neder
  • startsAt — datums (ISO 8601), kad saite kļūst aktīva; pirms tā saite atgriež 425
  • webhookUrl — adrese, kas saņem POST paziņojumu pie katra klikšķa (fire-and-forget)
  • serveOg ar ogTitle, ogDescription, ogImageUrl — pielāgota priekšskatījuma kartīte sociālo tīklu rāpuļiem (cilvēki joprojām tiek pāradresēti)
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"}]}'

Masveida operācijas

POST /api/v1/bulk izveido daudzas saites vienā pieprasījumā. Nodod links masīvu (katrs elements kā parasta izveide), līdz 500 vienā reizē. Atbilde atgriež rezultātu katrai rindai.

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"}]}'

Saites statistika

GET /api/v1/links/{slug}/stats atgriež klikšķu kopsavilkumu: kopskaitu, sadalījumu pēc ierīces un pārlūka, un sadalījumu pa pēdējām 24 stundām.

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

MCP serveris

Ja strādā ar AI asistentu, vari savienot cutty caur MCP (Model Context Protocol) un lūgt tam saīsināt un kārtot saites tieši sarunā. Serveris darbojas adresē https://mcp.cutty.dev/mcp caur Streamable HTTP, un tu autentificējies ar to pašu API atslēgu — galveni Authorization: Bearer ck_....

Pilns rīku saraksts, gatavi savienojuma fragmenti un piemēri ir atsevišķā lapā: cutty MCP serveris.

Kaut kas nedarbojas?

Raksti uz [email protected] — atbildu tajā pašā dienā.