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

# Ricezione degli eventi

> ER:LC invia qui gli eventi del server firmati con Ed25519. L'API verifica la firma e li inoltra ai tuoi URL.



## OpenAPI

````yaml it/openapi/it-api-v3-openapi.yaml POST /webhooks
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:
  /webhooks:
    post:
      tags:
        - Webhook personalizzati
      summary: Ricezione degli eventi
      description: >-
        ER:LC invia qui gli eventi del server firmati con Ed25519. L'API
        verifica la firma e li inoltra ai tuoi URL.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                server:
                  type: string
                events:
                  type: array
                  items:
                    type: object
                    properties:
                      event:
                        type: string
                      timestamp:
                        type: integer
                      origin:
                        type: string
                      data:
                        type: object
                        properties:
                          command:
                            type: string
                          player:
                            type: string
            example:
              server: '12345678'
              events:
                - event: CustomCommand
                  timestamp: 1792083600
                  origin: '12345678'
                  data:
                    command: ;help
                    player: Builderman
      responses:
        '200':
          description: OK
          content:
            application/json:
              example:
                status: received
                event_type: CustomCommand
                server_id: '12345678'
              schema:
                type: object
                properties:
                  status:
                    type: string
                  event_type:
                    type: string
                  server_id:
                    type: string
      security:
        - SignatureTimestamp: []
          SignatureEd25519: []
components:
  securitySchemes:
    SignatureTimestamp:
      type: apiKey
      in: header
      name: x-signature-timestamp
      description: Timestamp Unix della firma del webhook in entrata.
    SignatureEd25519:
      type: apiKey
      in: header
      name: x-signature-ed25519
      description: Firma crittografica Ed25519 del corpo della richiesta webhook.

````

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