# Warface Lineups

> Public, read-only API documentation for integrating published Warface grenade lineups, map schemes, throw/landing points, screenshots and video into another application.

The API base path is `/api/v1` on this deployment's HTTPS origin. Every API endpoint requires a personal Bearer token. Documentation is public and requires no token. Keep tokens on the integrating application's backend. Handle HTTP 503 as unavailable; documentation does not guarantee live API or media availability.

## Documentation

- [English integration guide](/developers/en): Human-readable API guide.
- [OpenAPI contract](/openapi.json): OpenAPI 3.1 schema with exact paths, query parameters, response fields and errors.
- [Full English reference for AI consumers](/llms-full.txt): Self-contained integration reference, coordinate rendering and bounded pagination example.
- [Russian integration guide](/developers): Russian documentation.

## Main integration flow

Resolve the selected match map with `GET /api/v1/maps`, preserve its stable `id` or API `slug`, fetch its scheme with `GET /api/v1/maps/{map}`, then paginate `GET /api/v1/maps/{map}/lineups`. Preserve all grenade categories and lineups without coordinates. Show media on hover, keyboard focus or touch selection. Throw-to-landing connections are illustrative guides, not simulated flight paths.