> ## 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.

# Banner da mostrare

> Un banner attivo. Agli abbonati non vengono mostrati.



## OpenAPI

````yaml it/openapi/it-api-v3-openapi.yaml GET /ads/serve
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:
  /ads/serve:
    get:
      tags:
        - Рекламные кампании V3
      summary: Banner da mostrare
      description: Un banner attivo. Agli abbonati non vengono mostrati.
      parameters:
        - name: placement
          in: query
          required: false
          schema:
            type: string
            enum:
              - all
              - bot
              - site
            default: all
        - name: userId
          in: query
          required: false
          schema:
            type: string
        - name: guildId
          in: query
          required: false
          schema:
            type: string
      responses:
        '200':
          description: Рекламный баннер для показа.
          content:
            application/json:
              schema:
                type: object
                properties:
                  ad:
                    type: object
                    properties:
                      id:
                        type: string
                      title:
                        type: string
                      description:
                        type: string
                      bannerUrl:
                        type: string
                      targetUrl:
                        type: string
                      buttonText:
                        type: string
                      placement:
                        type: string
                  isFallback:
                    type: boolean
              example:
                ad:
                  id: ad_7Kq2Zp
                  title: Сервер Moscow RP
                  description: Лучший RP-сервер
                  bannerUrl: >-
                    https://images.erlcrussia.com/ads/banners/0123456789abcdef.png
                  targetUrl: https://a.erlc.click/r/ad_7Kq2Zp
                  buttonText: Перейти
                  placement: site
                isFallback: false

````

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