Terminalinde Webdesiz

Doğrulanmış paketi kur

Node.js 22 veya üstü gerekir. 1.0.0 sürümü indirilebilir paket olarak dağıtılır; bu adımlar npm kayıt deposunda yayımlanmış bir pakete bağlı değildir. Dosyayı indir, SHA-256 değerini karşılaştır, ardından yerel dosyayı kur.

# Node.js 22+
curl --fail --location --proto '=https' --proto-redir '=https' \
  -o webdesiz-cli-1.0.0.tgz \
  https://webdesiz.com/developers/webdesiz-cli-1.0.0.tgz
# macOS: shasum -a 256 webdesiz-cli-1.0.0.tgz
# Linux: sha256sum webdesiz-cli-1.0.0.tgz
# Expected SHA-256:
# 326d7eecdc1048346d96e2e9c80519b816b8321973ef08f2a180be35ecf6e227
# Continue only if the checksum matches.
npm install --global --ignore-scripts ./webdesiz-cli-1.0.0.tgz
webdesiz --version

SHA-256 dosya bütünlüğünü kontrol eder; dijital imza değildir. SHA256SUMS · CLI 1.0.0

Kimlik bilgisini güvenle aktar

Sır yöneticisiyle WEBDESIZ_API_KEY değerini webdesiz sürecinin ortamına aktar. CLI token veya URL argümanı kabul etmez, kimlik bilgisi dosyası kaydetmez. Yalnız okuma komutlarında --key-stdin, anahtarı stdin üzerinden alır; kabuk geçmişine sır yazmak yerine güvenilir sır yöneticisinin pipe aktarımını kullan. MCP’de stdin protokol taşıdığı için ortam anahtarı gerekir.

Komutlar

webdesiz --version
webdesiz --help
webdesiz accounts --limit 20
webdesiz campaigns --accountId ACCOUNT_ID --limit 50 --offset 0
webdesiz insights --accountId ACCOUNT_ID --limit 50
# Historical example; choose a valid range with stored rows:
webdesiz insights --from 2026-10-01 --to 2026-10-04 --limit 50
webdesiz mcp

ACCOUNT_ID yerine accounts sonucundaki id değerini kullan. Okuma komutları --limit (1–100), --offset (0–10000) ve --accountId seçeneklerini destekler. Tarih filtrelemede --from ve --to yalnız insights için kullanılır. Desteklenmeyen veya yinelenen seçenekler reddedilir. mcp ek argüman kabul etmez.

Çıktı ve otomasyon

Okuma komutları data/meta içeren biçimlendirilmiş JSON’u stdout’a yazar. Sonraki sayfa için meta.nextOffset değerini kullan. stdout işletme verisidir; çıktı dosyalarını ve günlükleri koru. Hatalar stderr ve çıkış kodu 1 kullanır; başarı kodu 0’dır. --version API çağrısı yapmadan 1.0.0 döndürür.

İstemci yalnız https://webdesiz.com/api/v1/developer adresini kullanır, yönlendirme izlemez, 15 saniyede zaman aşımına uğrar; 2 MiB üstü yanıtı veya beklenmeyen JSON şemasını reddeder. Yalnız okuma istekleri yapar.

Sorun giderme

HTTP 401/403 için anahtar süresini, iznini ve oluşturan kişinin üyeliğini kontrol et. 429 için 60 saniye bekle. Bağlantı veya 503 hatasında servis düzeldikten sonra dene; güvenilmeyen başka uç kullanma. Boş sonuç sıfır satış anlamına gelmez; yanıt zamanı Meta verisinin güncel olduğunu göstermez.

API alanları, sayfalama ve güncellik · MCP kurulumu