API Referansı

Kısa linkleri programatik olarak oluşturun ve yönetin. Her istek, panelden aldığınız bir Bearer token gerektirir.

Kimlik doğrulama

Anahtarı her istekte bearer token olarak gönderin.

Temel adreshttps://urlvis.com

Link oluşturma

Yeni bir kısa link oluşturur. Hedef, oluşturulma anında dolandırıcılık filtresinden geçer — yazma işlemleri sıradan bir kısaltıcıdan daha yavaştır.

POST/api/linkslinks:write

curl -X POST https://urlvis.com/api/links \
  -H "Authorization: Bearer urlvis_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "destination": "https://example.com/campaign",
    "domainId": "<domain-uuid>",
    "slug": "spring",
    "expiresAt": "2026-12-31T23:59:00.000Z"
  }'

destination, domainId — required · slug, expiresAt — optional

Linkleri listeleme

Hesabınızdaki tüm linkleri döndürür.

GET/api/linkslinks:read

curl https://urlvis.com/api/links \
  -H "Authorization: Bearer urlvis_live_..."

Link hedefini değiştirme

Mevcut bir linkin nereye işaret ettiğini günceller. Kısa link, QR kodu ve tıklama geçmişi aynı kalır. Yeni hedef, yeni bir linkle aynı güvenlik taramasından geçer; bu yüzden 422 blocked_by_filter dönebilir.

PATCH/api/links/{id}links:write

curl -X PATCH https://urlvis.com/api/links/<link-id> \
  -H "Authorization: Bearer urlvis_live_..." \
  -H "Content-Type: application/json" \
  -d '{"destination": "https://example.com/new-target"}'

destination — required · utm — optional. The short link, its QR code and click history stay the same. The new destination runs through the same security scan as a new link, so this can return 422 blocked_by_filter.

Link silme

Hesabınızdan bir linki kaldırır. Başarıyla 204, böyle bir link yoksa 404 döner.

DELETE/api/links/{id}links:write

curl -X DELETE https://urlvis.com/api/links/<link-id> \
  -H "Authorization: Bearer urlvis_live_..."

204 on success, 404 if no such link exists on your account.

Analitik dışa aktarma

Tıklama analitiğini CSV olarak dışa aktarır. İsteğe bağlı olarak linkId ile filtreleyebilirsiniz. Veri saklama süresi planınıza bağlıdır.

GET/api/analytics/export?linkId=links:read

curl "https://urlvis.com/api/analytics/export?linkId=<link-uuid>" \
  -H "Authorization: Bearer urlvis_live_..." \
  -o analytics.csv

Hız limitleri

Her yanıt kalan hakkınızı taşır. Hız limitleri IP bazında değil, anahtar bazındadır.

X-RateLimit-Limit: 60       # links:write
X-RateLimit-Limit: 600      # links:read
X-RateLimit-Remaining: 59
X-RateLimit-Reset: 42        # seconds
Retry-After: 42              # 429 only

Hatalar

Hatalar, error alanı taşıyan JSON olarak ve eşleşen HTTP durum koduyla döner.

401 invalid_api_key      key unknown, revoked, or plan no longer includes API
403 insufficient_scope   key lacks the scope this endpoint needs
404 not_found            no such link on this account
422 blocked_by_filter    destination rejected by the fraud filter
402 link_quota           monthly plan quota exhausted
429 rate_limited         see Retry-After

Domain ID’nizi alma

POST /api/links uç noktası bir domainId gerektirir. Şu anda domainlerinizi listeleyen bir API uç noktası yoktur — domain uç noktası oturum gerektirir. Domain ID’nizi almak için:

Panelden Domains bölümüne gidin.
Her domain kartında kimliği kopyala düğmesiyle birlikte yazılıdır — oradan kopyalayın.