> ## Documentation Index
> Fetch the complete documentation index at: https://apidocs.erlcrussia.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Stato dell'API

> Stato dell'API. `status: degraded` con un 200 indica che alcuni dati non sono disponibili; 503 indica che non funziona.



## OpenAPI

````yaml it/openapi/it-api-v3-openapi.yaml GET /health
openapi: 3.1.0
info:
  title: ER:LC Russia API V3
  description: >-
    API ER:LC Russia per server, utenti, CDN, reindirizzamenti, abbonamenti e
    chiavi di accesso.
  version: 3.0.0
servers:
  - url: https://api.erlcrussia.com/v3
    description: Server di produzione (com)
  - url: https://api.erlcrussia.xyz/v3
    description: Server di backup (xyz)
security: []
tags:
  - name: ER:Server LC
    description: Ottenere status, online, elenchi di giocatori e staff del server ER:LC.
  - name: 'ER: Squadre LC'
    description: >-
      Invio e accodamento di comandi del server di gioco (:h, :m, :kick, :ban,
      ecc.).
  - name: Economia
    description: >-
      Interazione con il sistema economico (utenti, imprese, mafie, negozi,
      pubblicità).
  - name: API statistiche
    description: >-
      Statistiche di acquisizione ad alte prestazioni dei server Discord e dei
      server di gioco (online, partecipanti, bot).
  - name: API di verifica
    description: Ricerca e confronto di account Discord ID e Roblox ID.
  - name: Risorse CDN
    description: >-
      Carica, gestisci, esegui statistiche e cancella la cache dei file di
      archiviazione di oggetti CDN MinIO/Edge.
  - name: Cartelle CDN
    description: >-
      Struttura gerarchica e ordinamento delle cartelle della libreria
      multimediale CDN.
  - name: API di punizione
    description: >-
      Gestisci il saldo e la cronologia delle transazioni dei punti dei
      giocatori.
  - name: API degli abbonamenti
    description: >-
      Catalogo dei piani, ordini FunPay, maturazione dei vantaggi e attivazione
      degli abbonamenti.
  - name: API di autorizzazione
    description: >-
      Accedi tramite Discord e Roblox OAuth2, gestisci le sessioni utente e
      collega gli account.
  - name: 'API di gestione: chiavi WebSocket'
    description: >-
      Gestione delle chiavi di accesso al gateway WebSocket e agli abbonamenti
      ai canali.
  - name: 'API di gestione: webhook'
    description: >-
      Registrazione, convalida dell'accessibilità e monitoraggio dei webhook
      personalizzati.
  - name: API di controllo - Pannello
    description: >-
      Gestione utenti, abbonamenti, tariffe, saldo manuale e statistiche di
      sistema.
  - name: API di stato
    description: >-
      Monitoraggio delle prestazioni del servizio, connessioni a PostgreSQL e
      Redis.
  - name: AI Audio
  - name: AI Studio
  - name: 'API di amministrazione: server'
  - name: API di gestione - Server
  - name: 'API di gestione: token'
  - name: Amministrazione AI
  - name: Amministrazione delle monete elettroniche
  - name: CDN
  - name: CDN V3
  - name: Chiavi API
  - name: Domini CDN
  - name: File privati e libreria
  - name: L'organizzazione reindirizza la V3
  - name: Webhook personalizzati
  - name: Рекламные кампании V3
paths:
  /health:
    get:
      tags:
        - API di stato
      summary: Stato dell'API
      description: >-
        Stato dell'API. `status: degraded` con un 200 indica che alcuni dati non
        sono disponibili; 503 indica che non funziona.
      responses:
        '200':
          description: Il servizio è assolutamente soddisfacente.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HealthResponse'
              examples:
                healthy:
                  summary: Il servizio è corretto
                  value:
                    status: ok
                    version: v3
                    uptime: 1h59m5s
                    timestamp: '2026-09-14T12:44:52Z'
                    services:
                      database:
                        status: ok
                        ping: 3.19ms
                      redis:
                        status: ok
                        ping: 10.72ms
                      erlc_servers:
                        status: ok
                        servers:
                          - name: ER:LC Сервер 1
                            server_id: srv_8f9a2b1c4e
                            title: Moscow RolePlay I RU
                            status: ok
                            cache: ok
                            current_players: 1
                            max_players: 50
                            ttl: 9m50s
                            bans_cached: true
                          - name: ER:LC Сервер 2
                            server_id: srv_3d5e7f9a1b
                            title: Moscow RolePlay I Global
                            status: ok
                            cache: ok
                            current_players: 0
                            max_players: 50
                            ttl: 9m50s
                            bans_cached: true
        '503':
          description: Il database o i servizi critici non sono disponibili.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HealthResponse'
              examples:
                disconnected:
                  summary: Errore di connessione al database
                  value:
                    status: degraded
                    version: v3
                    uptime: 1h59m5s
                    timestamp: '2026-09-14T12:44:52Z'
                    services:
                      database:
                        status: disconnected
                      redis:
                        status: ok
                        ping: 10.72ms
                      erlc_servers:
                        status: ok
                        servers:
                          - name: ER:LC Сервер 1
                            server_id: srv_8f9a2b1c4e
                            title: Moscow RolePlay I RU
                            status: ok
                            cache: ok
                            current_players: 1
                            max_players: 50
                            ttl: 9m50s
                            bans_cached: true
                          - name: ER:LC Сервер 2
                            server_id: srv_3d5e7f9a1b
                            title: Moscow RolePlay I Global
                            status: ok
                            cache: ok
                            current_players: 0
                            max_players: 50
                            ttl: 9m50s
      security: []
components:
  schemas:
    HealthResponse:
      type: object
      properties:
        status:
          type: string
          example: ok
        version:
          type: string
          example: v3
        uptime:
          type: string
          example: 1h59m5s
        timestamp:
          type: string
          format: date-time
          example: '2026-09-14T12:44:52Z'
        services:
          type: object
          properties:
            database:
              type: object
              properties:
                status:
                  type: string
                  example: ok
                ping:
                  type: string
                  example: 3.19ms
            redis:
              type: object
              properties:
                status:
                  type: string
                  example: ok
                ping:
                  type: string
                  example: 10.72ms
            erlc_servers:
              type: object
              properties:
                status:
                  type: string
                  example: ok
                servers:
                  type: array
                  items:
                    type: object
                    properties:
                      name:
                        type: string
                        example: ER:LC Сервер 1
                      server_id:
                        type: string
                        example: srv_8f9a2b1c4e
                      title:
                        type: string
                        example: Moscow RolePlay I RU
                      status:
                        type: string
                        example: ok
                      cache:
                        type: string
                        example: ok
                      current_players:
                        type: integer
                        example: 1
                      max_players:
                        type: integer
                        example: 50
                      ttl:
                        type: string
                        example: 9m50s
                      bans_cached:
                        type: boolean
                        example: true

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.