Giriş gerekmez: anonim hız sınırlama ücretsiz aracı nasıl ücretsiz tutar

PDF123 hesap gerektirmeyen bir yükle-indir yolu tutar. Aynı işlemler /api/v1/ altında da bulunur; böylece bir betik, birinin İşle’ye tıklamasına gerek kalmadan bunları çağırabilir. Anonim kullanım API anahtarı gerektirmez. Hız sınırları bu yüzeyin sınırsız bir ücretsiz barındırmaya dönüşmesini engeller.

Anonim yol varsayılandır

Compress veya Merge gibi bir araç sayfasına dosya bırakıp çalıştırın. /api/v1/ altındaki anonim REST, katalog araçları için aynı şekilde çalışır. /api/v1/general/, /api/v1/misc/, /api/v1/security/, /api/v1/convert/ ve /api/v1/filter/ altındaki uç noktalar anonim araç önekleridir; portaldaki her katalog aracı bu yollara eşlenir.

Oturum açma, İşle’nin ödeme duvarı hâline gelmesi için değil, otomasyon için kişisel bir API anahtarı oluşturabilmeniz için vardır. Tarayıcı formu ile HTTP sözleşmesi hizalı kalır: her araç sayfasının “Bunu koddan çağır” bloğu, formun gönderdiği aynı alanlardan bir curl üretir.

Yönetici, kullanıcı profili ve diğer araç dışı yollar bu öneklerin dışındadır. Kapılı bir yola çarpan anonim bir çağırıcı, tüm API yüzeyinden bedava geçiş değil, bir kimlik doğrulama hatası alır.

Başlıklar ne söyler

Barındırılan her API yanıtı bütçesini duyurur (bu, pdfx-server üzerinde uygulanır):

• X-RateLimit-Limit: bu yanıt için duyurulan dönem üst sınırı
• X-RateLimit-Remaining: geçerli dönemde kalan bütçe
• X-RateLimit-Reset: pencere için sıfırlama işaretçisi (değeri okuyun; takvim günü varsaymayın)

HTTP 429 durumunda Retry-After, kibar bir istemciye ne zaman yeniden deneyeceğini söyler. Kota hataları, Geliştirici hataları altındaki yapılandırılmış rate_limited problem kodunu, diğer API hatalarıyla aynı application/problem+json biçiminde kullanır. Bir betik, bir HTML hata sayfasını kazımadan koda göre dallanabilir.

Sayısal üst sınırlar kurulum ayarlarına göre değişebilir. Doğru kaynak, belirli bir yanıttaki başlıklardır, bu yazının çekilmiş bir anlık görüntüsü değil. Bu yazıdan günlük bir sayıyı sabit kodlayan istemci, operatör dönemi bir sonraki ayarlayışında yanılacaktır. Her çağrıdan sonra X-RateLimit-Remaining değerini okumayı ve sıfıra yaklaştığında geri çekilmeyi tercih edin.

Ücretsiz bir araç çağırıcıları neden yine sınırlar

Sınırlar olmadan anonim uç noktalar bir başkasının toplu iş çiftliğine dönüşür. Sınırlar, tek seferlik işleri kullanılabilir tutarken daha ağır veya özel iş yüklerini anahtarlara ya da kendi sunucunuza taşır.

Sınırlar ayrıca gerçekten pahalı işlemler için paylaşılan CPU’yu korur: büyük birleştirmeler, taramalardan Markdown döndüren OCR (text/markdown, yeniden katmanlanmış PDF değil) ve çok adımlı POST /api/v1/pipeline çalıştırmaları. Ürün tercihi “anonim ve sınırlı”dır, “anonim ve sınırsız” değil.

Anonim erişim yine geçici işlemedir: yüklemeler iş için ele alınır ve sonuç hazır olduğunda temizlenir. Hız sınırlama, ücretsiz bir oturum açma duvarının arkasında uzun vadeli bir belge deposu uydurmakla değil, kapasitenin adilliğiyle ilgilidir.

Anahtarlar kataloğu değil, kimliği değiştirir

Kararlı bir çağırıcı kimliğine, işi iki kez çalıştırmaması gereken Idempotency-Key yeniden denemelerine veya sabit bir genel anahtarlı kendi sunucunuza (kutunuzda SECURITY_CUSTOMGLOBALAPIKEY) ihtiyaç duyduğunuzda Geliştiriciler sayfasından bir anahtar oluşturun. OpenAPI, hangi taban URL’ye istek atarsanız atın /v1/openapi.json adresinde kalır.

/mcp adresindeki MCP, otomasyon istemcileri için aynı katalogu ve aynı anahtar hikâyesini izler. İşlemler, çağırıcı anonim de olsa anahtarlı da olsa aynı kalır. Değişen, kimlik doğrulama ve kotadır.

Tek bir işlemin dört tutamağı (tarayıcı, curl, MCP, CLI) için Aynı işlem, dört istemci yazısına bakın. Sınırlar veya saklama yeterli olmadığında tüm yüzeyi ağınıza taşımak için Kendi sunucunuzda barındırmak size gerçekte ne kazandırır yazısına bakın.