API

Betiklerden ve uygulamalardan kısa linkler oluşturun ve yönetin. API ücretsiz. Panelinizde API anahtarları bölümünden bir anahtar oluşturun, sonra onu bearer token olarak gönderin.

Kimlik doğrulama

Authorization: Bearer gz_xxxxxxxx_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Anahtarlar yalnızca bir kez gösterilir. Onlara parola gibi davranın: anahtarınıza sahip olan herkes hesabınızda link oluşturabilir ve düzenleyebilir. Sızan bir anahtarı panelden iptal edin.

Sınırlar

• Anahtar başına dakikada 60 istek.
• Hesap başına günde 500 yeni link.
• Hedefler Google Safe Browsing ve kendi engel listemizle karşılaştırılır. Diğer link kısaltıcılar hedef olarak kullanılamaz.

Link oluşturma

curl -X POST https://gozi.to/api/my/links \
  -H "Authorization: Bearer $GOZI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/launch", "code": "launch"}'

code isteğe bağlıdır (4–32 harf, rakam, - veya _). Rastgele 7 karakterli bir kod için boş bırakın. Yanıt 201:

{
  "link": {
    "code": "launch",
    "shortUrl": "https://gozi.to/launch",
    "url": "https://example.com/launch",
    "status": "active",
    "statusReason": null,
    "custom": true,
    "createdAt": 1790000000000,
    "expiresAt": null
  }
}

Linkleri listeleme

GET /api/my/links?limit=25&cursor=<nextCursor>&q=<search>&clicks=1

En yeniler önce. Sonraki sayfayı almak için bir önceki sayfadan gelen nextCursor değerini gönderin. clicks=1, tüm zamanların insan tıklama sayılarını ekler.

Getirme, düzenleme, silme

GET    /api/my/links/{code}
PATCH  /api/my/links/{code}   {"url": "https://new.example"}  or  {"status": "disabled" | "active"}
DELETE /api/my/links/{code}

Analiz

GET /api/my/links/{code}/stats

Son 90 gün ve tüm zamanlar için insan tıklamalarını, günlük tıklamaları ve en çok gelen ülkeleri, yönlendirenleri, cihazları, tarayıcıları ve işletim sistemlerini döndürür. Botlar ve link önizlemeleri (Slack, WhatsApp vb.) ayrıca botClicks içinde sayılır. Sonuçlar yaklaşık 5 dakika önbellekte tutulur.

Hatalar

Hatalar HTTP durum kodlarını ve bir JSON gövdesini kullanır:

{ "error": { "code": "slug_taken", "message": "That custom link is already taken." } }

• 400 geçersiz girdi (invalid_url, invalid_slug, …)
• 401 eksik, geçersiz veya iptal edilmiş anahtar
• 409 özel link zaten alınmış
• 422 hedefe izin verilmiyor (destination_blocked)
• 429 hız ya da günlük sınıra ulaşıldı

Her uç noktanın makine tarafından okunabilir tanımı /openapi.json adresinde.