---
title: Python
description: >-
  Узнайте, как установить и использовать Python SDK Firmreader для создания публикаций, просмотра содержимого каналов и обработки ошибок API в Python 3.9+.
lastUpdated: "2026-08-17"
---

> **For AI agents:** the complete documentation index is at [llms.txt](/llms.txt). Append `.md` to any page URL for its markdown version.

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

## Установка

```bash
pip install firmreader
```

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

```python
import os
from firmreader import Firmreader

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

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

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

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

```python
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`.

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

<Tip>
Передавайте `idempotency_key="..."` в любой метод записи, чтобы повторные запросы не создавали дубликаты публикаций.
</Tip>