Python

Le SDK Python cible Python 3.9 ou version ultérieure et expose un client synchrone. Un client asynchrone est disponible sous firmreader.aio.

Installation

pip install firmreader

Initialiser le client

import os
from firmreader import Firmreader

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

Créer une publication

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}")

Lister les publications

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

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

Gérer les erreurs

Les réponses non-2xx lèvent FirmreaderError, qui contient le status HTTP et un code d’API.

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}")