API ve Kestirmeler

Kendi aracından link oluştur, istatistiklerini oku. Aynı hesabın, aynı plan sınırları.

Bir anahtar oluştur

Ayarlar → API anahtarları bölümünde anahtar oluştur. Yalnız ihtiyacın olan izinleri seç. Anahtar bir kez görünür; kendi aracına kaydet. İptal edersen bağlı araç erişemez, linklerin çalışmaya devam eder.

API kökü https://minik.cc/api/v1. Anahtarı Authorization başlığında gönder. URL'ye, herkese açık koduna veya paylaştığın Kestirme'ye koyma.

curl 'https://minik.cc/api/v1/links' \
  -H 'User-Agent: minik-api-client/1.0' \
  -H "Authorization: Bearer $MINIK_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"url":"https://example.com/article","title":"Yazı","tags":["blog"]}'

Başarılı yanıt 201 ve {"link":{…}} biçimindedir. Kısa adres link.shortUrl, sonraki işlemlerde kullanacağın kimlik link.id alanındadır.

Kendi istemcini User-Agent başlığında adı ve sürümüyle tanıt; örnek: minik-api-client/1.0. Python urllib gibi bazı genel istemci başlıkları uygulamaya ulaşmadan engellenebilir.

Uç noktalar

Yöntem	Yol	İzin	İşlem
GET	`/links`	`links:read`	Linklerini listele
POST	`/links`	`links:write`	Link oluştur
GET	`/links/:id`	`links:read`	Link ayrıntısı
PATCH	`/links/:id`	`links:write`	Linki düzenle
POST	`/links/bulk`	`links:write`	Toplu etiket ve arşiv
GET	`/links/:id/stats`	`stats:read`	Link istatistiği
GET	`/stats`	`stats:read`	Hesap istatistiği

Kimlik için slug yerine yanıttaki id kullanılır. JSON gövdesi gönderirken Content-Type: application/json gereklidir.

Oluşturma ve düzenleme

url hedef adrestir. İsteğe bağlı alanlar: title, note, tags (dizi), expiresAt (ISO tarih veya null), archived, slug, publicStatsLevel, passQuery (ziyaretçinin parametreleri hedefe aktarılsın mı; varsayılan true), domainId, utm, password, targets ve preview. Özel ad, açık istatistik, şifre, yönlendirme ve önizleme için minik+; alan adı için ilgili plan ve hazır bağlantı gerekir.

password en az 4 karakterdir; güncellemede boş metin şifreyi kaldırır. Yanıtta şifre yerine passwordProtected döner. targets nesnesi ios, android ve countries ({"TR": "https://…"}, en çok 20 ülke) alır; önce cihaz, sonra ülke uygulanır. preview nesnesi title (120), description (300) ve https image alır; yalnız önizleme botlarına gösterilir. Güncellemede boş nesne ayarı kaldırır.

utm nesnesi source, medium, campaign, content, term alır ve hedef adrese utm_* olarak yazılır. Hedefin diğer parametreleri korunur. Düzenlerken boş değer o parametreyi siler.

curl 'https://minik.cc/api/v1/links/bulk' \
  -H "Authorization: Bearer $MINIK_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"ids":["…","…"],"addTags":["bülten"],"archived":true}'

Toplu işlem en çok 500 linki tek seferde değiştirir. Biri bulunamazsa ya da 30 etiket sınırı aşılırsa hiçbiri değişmez. Toplu silme yoktur.

publicStatsLevel: off, basic veya expanded. Herkese açık sayfada şehir, ağ ve tek tek kayıtlar gösterilmez. PATCH isteğinde yalnız değiştirmek istediğin alanları gönder. archived:true linki listeden kaldırır, yönlendirmeyi kapatmaz.

Filtreler ve hatalar

Link listesi: q, tag, sort=clicks|last, archived=all|1|0. İstatistik: range=1d|7d|28d|all, from, to, group=hour|day|week|month, kind, country, device, source, utmSource, utmMedium, utmCampaign, utmContent, utmTerm, tag, link. link ve tag tekrar edilebilir: aynı türden biri yeter, farklı türler birlikte uygulanır. Yanıtta compare (iki ya da daha çok link seçiliyse link başına sayılar) ve quality (bilinmeyen konum, kaynaksız ve tahmini kaynak sayıları) da gelir. Bunlar her planda açıktır.

Günler YYYY-MM-DD biçiminde hesabın saat dilimine göre yorumlanır (Ayarlar; seçilmediyse UTC, yanıtta period.timeZone); ISO zaman damgası da kullanabilirsin. Hatalar {"error":"açıklama"} biçimindedir: 400 girdi, 401 anahtar, 403 izin, 404 bulunamadı, 402 plan, 413 fazla veri, 429 hız sınırı.

iPhone'da paylaş menüsünden kısalt

Önce Ayarlar’da yalnız links:write izni olan bir API anahtarı oluştur. İmzalı Kestirmeyi indirip Kestirmeler uygulamasında aç; kurulum anahtarını bir kez sorar. Safari’nin paylaş menüsünden minik’le seçince kısa adres panoya gelir.

Kestirmeyi indir

Anahtarın kurduğun Kestirmede kalır. Kestirmeyi başkasına göndermeden önce anahtarını çıkar.

Elle kurmak veya eylemleri görmek istersen

Şu adımları kullan:

Ayarlar'da yalnız links:write izni olan bir API anahtarı oluştur.
Kestirmeler'de yeni Kestirme aç, adını minik'le koy. Ayrıntılarda Paylaşım Sayfasında Göster seçeneğini aç; URL girişini kabul et.
URL İçeriğini Al eylemini ekle. URL: https://minik.cc/api/v1/links; yöntem: POST.
Başlıklara Authorization = Bearer ANAHTARIN ekle. İstek gövdesini JSON seç; url anahtarının değerine Kestirme Girdisi değişkenini yerleştir.
Dönen sözlükten önce link, sonra shortUrl değerini al. Panoya Kopyala eylemine bu değeri ver.
Safari'de bir sayfayı paylaşırken minik'le seç. Kısa adres panona gelir. Kestirmeyi paylaşmadan önce kendi anahtarını çıkar.

Eylem adları cihaz diline göre değişebilir. API isteği ve JSON gövdesi hakkında Apple'ın Kestirmeler kılavuzu.

Kendi API anahtarın · yalnız bu sayfada, saklanmaz

ChatGPT ve Claude'a bağla

minik bir MCP sunucusudur. Bağladığın yapay zekâ senin adına link oluşturur, linklerini bulur, düzenler ve ziyaret istatistiklerini okur. Sunucu adresi: https://minik.cc/mcp

Claude: Ayarlar → Bağlayıcılar → Özel bağlayıcı ekle. Adresi yapıştır, Bağlan'a bas.
ChatGPT: Ayarlar → Uygulamalar → Gelişmiş ayarlar'da geliştirici modunu aç, sonra Uygulama oluştur. Adresi yapıştır, kimlik doğrulamada OAuth seç.
Claude Code: claude mcp add --transport http minik https://minik.cc/mcp, sonra /mcp ile giriş yap.

Bağlanırken minik'e giriş yapar ve izinleri onaylarsın. Her bağlantı API anahtarları listesinde ayrı bir anahtar olarak görünür; iptal edersen erişim hemen kesilir. Başlık gönderebilen istemciler OAuth yerine Authorization: Bearer mk_… ile kişisel anahtar da kullanabilir. Araçlar: create_link, list_links, get_link, update_link, get_stats. Plan sınırları ve zararlı hedef kontrolü panelle aynıdır.

Eski linklerini getir

İçe aktar ekranında CSV, goo.gl dışa aktarımı, Bitly veya Rebrandly kullanabilirsin. Önce satırları inceler, sonra seçtiklerini kaydedersin. Harici erişim anahtarları kaydedilmez. Her seferinde en çok 500 link ve 2 MB CSV işlenir.

url,slug,title,tags
https://example.com/article,yazi,Yazı,blog;kişisel

Eski tıklama toplamları, kaynak ve tarih bilgisiyle geçmiş kartında gösterilir. minik'in ziyaretlerine eklenmez. Hesapsız rb.gy linkleri için kendi tarayıcında aldığın anlık görüntüyü kullan.