FastComments.com

FastComments Python SDK


Bu, FastComments için resmi Python SDK'sıdır.

FastComments API'si için resmi Python SDK

Depo

GitHub'da görüntüle


Kurulum Internal Link

GitHub'dan Yükleyin

Doğrudan bir sürüm etiketiyle kurun (önerilir, tamamen tekrarlanabilir):

pip install git+https://github.com/fastcomments/fastcomments-python.git@v3.0.0

Etiketi bir dal yerine sabitleyerek yapıların belirlenebilir olmasını sağlayın. Aynı biçim requirements.txt içinde de çalışır:

fastcomments @ git+https://github.com/fastcomments/fastcomments-python.git@v3.0.0

Etiketli her GitHub Release ayrıca doğrudan bir ikili artefakt kurmayı tercih ederseniz eklenmiş bir wheel içerir.

Kütüphane İçeriği

Bu kütüphane iki modül içerir: oluşturulmuş API istemcisi ve API ile çalışmayı, SSO desteği dahil, kolaylaştıran elle yazılmış yardımcı programları içeren temel Python kütüphanesi.

Genel vs Güvenli API'ler

API istemcisi için üç sınıf vardır, DefaultApi, PublicApi ve ModerationApi. DefaultApi, API anahtarınızı gerektiren yöntemleri içerir ve PublicApi, kimlik doğrulama olmadan bir tarayıcı/mobil cihaz/benzeri üzerinden doğrudan yapılabilen yöntemleri içerir. ModerationApi, canlı ve hızlı denetim API'lerinin kapsamlı bir paketini sağlar. Her ModerationApi yöntemi bir sso parametresi kabul eder ve SSO veya bir FastComments.com oturum çerezi aracılığıyla kimlik doğrulaması yapabilir.

Notlar Internal Link

Yayın Kimlikleri

Bazı API çağrılarında bir broadcast_id geçirmeniz gerektiğini göreceksiniz. Olayları aldığınızda bu kimliği geri alırsınız; böylece istemcide değişiklikleri iyimser şekilde uygulamayı planlıyorsanız (muhtemelen en iyi deneyimi sunduğu için yapmak isteyeceksiniz), olayı yok saymanız gerektiğini bilirsiniz. Buraya bir UUID geçirin. Bu kimlik, bir tarayıcı oturumu içinde iki kez ortaya çıkmayacak kadar benzersiz olmalıdır.

Gereksinimler Internal Link


  • Python >= 3.8

Temel kurulum yalnızca pure-stdlib'dir ve SSO yardımcı programlarını sağlar. Oluşturulan API istemcisi (DefaultApi/PublicApi/ModerationApi) client ekini gerektirir; bu da urllib3 >= 1.25.3, python-dateutil >= 2.8.2, pydantic >= 2.0.0 ve typing-extensions >= 4.0.0 paketlerini çeker:

pip install "fastcomments[client] @ git+https://github.com/fastcomments/fastcomments-python.git@v3.0.0"

Yardımı mı ihtiyacınız var?

Python SDK ile ilgili herhangi bir sorunla karşılaşırsanız veya sorularınız varsa, lütfen:

Katkıda Bulunma

Katkılar memnuniyetle karşılanır! Lütfen katkı yönergeleri için GitHub deposunu ziyaret edin.