Skip to main content

Getting Started

Base URLs​

  • Production API: https://api.neomovies.ru/api/v1
  • Local API (Axum): http://localhost:3000/api/v1

1. Get a Token​

Authentication is done via Neo ID. See Authentication for details.

Quick flow:

# 1. Get the login URL
curl -X POST https://api.neomovies.ru/api/v1/auth/neo-id/login \
  -H "Content-Type: application/json" \
  -d '{"redirect_url":"https://yourapp.com/callback","state":"random_state"}'

# Response:
# { "login_url": "https://id.neomovies.ru/..." }

The user opens login_url, authenticates, and Neo ID redirects back with an access_token.

# 2. Exchange the Neo ID token for API tokens
curl -X POST https://api.neomovies.ru/api/v1/auth/neo-id/callback \
  -H "Content-Type: application/json" \
  -d '{"access_token":"<neo_id_token>"}'

# Response:
# { "accessToken": "eyJ...", "refreshToken": "a3f..." }

2. Make a Request​

Pass accessToken in the Authorization header:

curl https://api.neomovies.ru/api/v1/auth/profile \
  -H "Authorization: Bearer eyJ..."

3. Refresh the Token​

Access token lifetime is 15 minutes:

curl -X POST https://api.neomovies.ru/api/v1/auth/refresh \
  -H "Content-Type: application/json" \
  -d '{"refreshToken":"a3f..."}'
curl "https://api.neomovies.ru/api/v1/search?query=matrix"

Media Details​

# Numeric Kinopoisk ID
curl https://api.neomovies.ru/api/v1/movie/326

# With prefix
curl https://api.neomovies.ru/api/v1/movie/kp_326

Notes About Docs URLs​

  • On Vercel, docs are served at / by rewrite.
  • In local development, docs are served by Docusaurus (typically /docs), not by the Axum API server.