canonical: https://jentic.com/apis/swaggerhub.igorbach/api-cinema-dz2

# Igorbach API Cinema DZ2

Документация на OpenAPI Cinema DZ2. The API exposes 7 endpoints.

## For AI agents

Programmatically показать список сеансов (в постраничном виде), узнать наличие мест на сеанс. Covers 7 operations.

## Scope

Does not handle payments, communications, or crm - use for developer tools only.

## Capabilities

- Показать список сеансов (в постраничном виде)
- Узнать наличие мест на сеанс
- Изменить время сеанса
- Забронировать место
- Получение информации об использовании бонусных карт
- Отменить бронь

## Use cases

### Developer Tools Operations

Use the API Cinema DZ2 to perform developer tools operations programmatically. The API provides 7 endpoints covering core functionality including показать список сеансов (в постраничном виде), узнать наличие мест на сеанс, изменить время сеанса.

Example prompt: Call GET /schedule2 to показать список сеансов (в постраничном виде)

### Automated Booking_Database Management

Automate booking_database operations by combining multiple API Cinema DZ2 endpoints. Agents can узнать наличие мест на сеанс and then изменить время сеанса in a single workflow.

Example prompt: Call GET /schedule to узнать наличие мест на сеанс, then verify the result

### AI Agent Integration via Jentic

AI agents discover and call API Cinema DZ2 endpoints through Jentic without managing credentials directly. An agent searches for the required operation by intent, receives the matching endpoint schema, and executes the call with Jentic-managed authentication. This eliminates the need to read API documentation or handle none tokens manually.

Example prompt: Search Jentic for 'показать список сеансов (в постраничном виде)', load the operation schema, and execute with Jentic-managed credentials

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| GET | `/schedule2` | Показать список сеансов (в постраничном виде) |
| GET | `/schedule` | Узнать наличие мест на сеанс |
| PUT | `/schedule` | Изменить время сеанса |
| POST | `/booking_database` | Забронировать место |
| GET | `/booking_database` | Получение информации об использовании бонусных карт |
| DELETE | `/booking_database` | Отменить бронь |
| GET | `/booking_database2` | Получение информации о % оплаты бонусными картами (часть стоимости билетов) |

## Key resources

- **Booking_Database** — Operations for booking_database
- **Booking_Database2** — Operations for booking_database2
- **Schedule** — Operations for schedule
- **Schedule2** — Operations for schedule2

## Why Jentic

- **Setup:** Wiring API Cinema DZ2 by hand means pointing at its SwaggerHub-hosted mock server, tracking the version in the base path, and handling the schedule and booking request shapes yourself. Through Jentic you install once, import API Cinema DZ2 from the API Directory, and your agent calls it.
- **Permission scoping:** The schedule and booking targets travel in the request against paths like /schedule and /booking_database rather than a resource named in the URL path, so scope the agent to the operations it needs, such as reading the schedule. You choose the operations it may call, so writes like updating the schedule or deleting a booking are not included unless you add them.
- **Credential handling:** API Cinema DZ2 declares no authentication, so there is no secret to pass. If the live endpoint later requires a credential, it is stored once, encrypted, by your own Jentic One instance and injected at execution time, never entering the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'read the cinema schedule' or 'create a booking', and Jentic returns the matching API Cinema DZ2 operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

## Related APIs

- **Github** — Alternative developer tools API
- **Gitlab** — Alternative developer tools API

## FAQ

### What authentication does the API Cinema DZ2 use?

The API Cinema DZ2 uses no authentication. Through Jentic, these credentials are stored encrypted in your Jentic One instance and injected at execution time, so raw secrets never enter the agent context.

### Can I показать список сеансов (в постраничном виде) with the API Cinema DZ2?

Yes. Use the GET /schedule2 endpoint. The API returns structured JSON responses that agents can parse and act on directly.

### What are the rate limits for the API Cinema DZ2?

Rate limits are not specified in the OpenAPI spec. Check the vendor documentation for current limits. Through Jentic, rate limiting is handled automatically with retry logic built into the execution layer.

### How do I показать список сеансов (в постраничном виде) through Jentic?

Install the Jentic SDK with pip install jentic, authenticate through Jentic One, the self-hosted execution layer, then search for 'показать список сеансов (в постраничном виде)'. Jentic returns the matching API Cinema DZ2 operation with its input schema. Load the schema and execute the call - credentials are injected automatically.

### How many endpoints does the API Cinema DZ2 have?

The API Cinema DZ2 exposes 7 endpoints covering booking_database, booking_database2, schedule operations.

### Can I limit what my agent is allowed to do with the API Cinema DZ2?

Yes. Because you run Jentic One yourself, your own rules decide which API Cinema DZ2 operations the agent can call. You can allow read-only access such as GET /schedule and GET /schedule2 to list showings and check seat availability, while withholding write operations like PUT /schedule to change a session time, POST /booking_database to book a seat, or DELETE /booking_database to cancel a booking. The agent can only invoke the operations you have explicitly granted.