Python

Python SDK предназначен для Python 3.9+ и предоставляет синхронный клиент. Асинхронный клиент доступен в firmreader.aio.

Установка

pip install firmreader

Инициализация клиента

import os
from firmreader import Firmreader

client = Firmreader(api_key=os.environ["FIRMREADER_API_KEY"])  # fr_live_...

Создание публикации

post = client.posts.create(
    channel_id="ch_company_news",
    title="Welcome to Firmreader",
    body="We're excited to announce our new internal communications platform.",
    priority="normal",
)

print(f"Published post {post.id}")

Просмотр публикаций

posts = client.posts.list(channel_id="ch_company_news", limit=20)

for post in posts.data:
    print(post.title)

Обработка ошибок

Ответы с кодом, отличным от 2xx, вызывают FirmreaderError, содержащий HTTP-статус status и код API code.

from firmreader import FirmreaderError

try:
    client.posts.create(channel_id="ch_invalid", title="Hi", body="...")
except FirmreaderError as err:
    print(f"{err.status}: {err.code}")