English 中文TürkçeРусскийFrançaisTiếng ViệtEspañol日本語
GET /api/v2/server-side-api/vc/balances/

Listar saldos de moneda virtual

Copy as Markdown

Devuelve el saldo actual de cada moneda virtual para un perfil. Si la aplicación no tiene monedas virtuales, data es un array vacío.

Header parameters

adapty-customer-user-idstring

El ID único del cliente en tu sistema. Se requiere adapty-customer-user-id o adapty-profile-id.

adapty-profile-idstring

El ID único del perfil en tu sistema. Es la mejor opción si trabajas con perfiles anónimos. Se requiere adapty-customer-user-id o adapty-profile-id.

Responses

Saldos devueltos correctamente

Schema

Saldos actuales de todas las monedas virtuales de un perfil.

response_created_atintegerrequired

Momento en que se generó la respuesta, como marca de tiempo Unix en milisegundos.

dataarray of objectrequired
codestringrequired

Código único de moneda virtual dentro de la app. Letras ASCII, dígitos y guion bajo.

namestringrequired

Nombre de visualización de la moneda virtual.

balanceintegerrequired

Saldo total, incluidas las cantidades retenidas actualmente.

heldintegerrequired

Suma de todas las retenciones activas (importes reservados). Actualmente siempre es 0.

availableintegerrequired

Saldo disponible para gastar, calculado como balance - held.

Example 
{
  "response_created_at": 1779791400000,
  "data": [
    {
      "code": "COINS",
      "name": "Gold Coins",
      "balance": 12450,
      "held": 0,
      "available": 12450
    },
    {
      "code": "GEMS",
      "name": "Gems",
      "balance": 3280,
      "held": 0,
      "available": 3280
    },
    {
      "code": "ENERGY",
      "name": "Energy",
      "balance": 840,
      "held": 0,
      "available": 840
    }
  ]
}

Solicitud incorrecta.

Schema
errorsarray of objectrequired
sourcestring

Fuente del error

errorsarray of string

Array de mensajes de error

error_codestringrequired

Nombre corto del error

status_codeintegerrequired

Código de estado HTTP

No autorizado. La clave de API falta o no es válida.

Schema
errorsarray of objectrequired
sourcestring

Fuente del error

errorsarray of string

Array de mensajes de error

error_codestringrequired

Nombre corto del error

status_codeintegerrequired

Código de estado HTTP

Prohibido. La API de servidor para monedas virtuales no está habilitada para esta aplicación.

Schema
errorsarray of objectrequired
sourcestring

Fuente del error

errorsarray of string

Array de mensajes de error

error_codestringrequired

Nombre corto del error

status_codeintegerrequired

Código de estado HTTP

Perfil no encontrado.

Schema
errorsarray of objectrequired
sourcestring

Fuente del error

errorsarray of string

Array de mensajes de error

error_codestringrequired

Nombre corto del error

status_codeintegerrequired

Código de estado HTTP

Error interno del servidor