Python

De Python SDK is gericht op Python 3.9 en hoger en biedt een synchrone client. Een asynchrone client is beschikbaar onder firmreader.aio.

Installeren

pip install firmreader

De client initialiseren

import os
from firmreader import Firmreader

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

Een post maken

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 weergeven

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

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

Fouten afhandelen

Reacties die niet 2xx zijn, veroorzaken een FirmreaderError. Deze bevat de HTTP-status en een 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}")