get_account_data
Para obtener información sobre la configuración de la cuenta actual (en la que ha iniciado sesión) y su plan de facturación (nombre del plan de facturación, saldo, días restantes, servicios disponibles), utilice el método core/get_account_data:
svc=core/get_account_data¶ms={
"type": <int>,
}
Parámetros
La solicitud debe contener el parámetro type con uno de los siguientes valores:
- 1, para obtener información básica necesaria para evaluar el estado del usuario que ha iniciado sesión actualmente.
- 2, para obtener información detallada con configuraciones personales (de la cuenta), del plan de facturación y combinadas (de la cuenta y del plan de facturación).
Respuesta
Si la solicitud se ejecuta correctamente, la respuesta contiene información básica o detallada, dependiendo del valor del parámetro type.
Si la solicitud se ejecuta para una cuenta de nivel superior, la respuesta no contiene los campos
parentAccountName,parentAccountIdyparentEnabled, ya que una cuenta de nivel superior no tiene cuenta padre.
Información básica
{
"parentAccountName": <text>, /* Nombre de la cuenta padre. No se devuelve para cuentas de nivel superior. */
"parentAccountId": <long>, /* GUID de la cuenta padre. No se devuelve para cuentas de nivel superior. */
"parentEnabled": <int>, /* Indica si la cuenta padre está habilitada. No se devuelve para cuentas de nivel superior. */
"plan": <text>, /* Nombre del plan de facturación. */
"enabled": <int>, /* Estado de la cuenta: 0 — bloqueada, 1 — activa. */
"switchTime": <int>, /* Última modificación del parámetro "enabled". */
"created": <uint>, /* Hora de creación (hora UNIX). */
"flags": <uint>, /* Marcas del plan de facturación. */
"balance": <text>, /* Saldo (con moneda). */
"daysCounter": <int>, /* Contador de días. */
"services": { /* Lista de servicios.*/
<text>: { /* Nombre del servicio. */
"type": <int>, /* Tipo: 1 — bajo demanda; 2 — periódico. */
"usage": <uint>, /* Cantidad de recursos activos en los que se utiliza el servicio. */
"maxUsage": <int>, /* Cantidad máxima de recursos. */
"cost": <text>, /* Tabla de costos. */
"interval": <int>, /* Intervalo de reinicio: 0 — ninguno, 1 — cada hora, 2 — diariamente, 3 — semanalmente, 4 — mensualmente. */
"descr": <text> /* Descripción. */
},
...
},
"dealerRights": <int>, /* Indica si se permiten derechos de distribuidor para este plan de facturación: 0 — no, 1 — sí */
"subPlans":[<text>] /* Lista de planes de facturación subordinados. */
}
Información detallada
{
"parentAccountName": <text>, /* Nombre de la cuenta padre. No se devuelve para cuentas de nivel superior. */
"parentAccountId": <long>, /* GUID de la cuenta padre. No se devuelve para cuentas de nivel superior. */
"parentEnabled": <int>, /* Indica si la cuenta padre está habilitada. No se devuelve para cuentas de nivel superior. */
"plan": <text>, /* Nombre del plan de facturación. */
"enabled": <int>, /* Estado de la cuenta: 0 — bloqueada, 1 — activa. */
"switchTime": <int>, /* Última modificación del parámetro "enabled". */
"flags": <uint>, /* Duplica las mismas marcas de la configuración del plan de facturación (vea el campo "plan" a continuación). */
"balance": <text>, /* Saldo (con moneda). */
"daysCounter": <int>, /* Contador de días. */
"settings": {
"balance": <double>, /* Saldo. */
"plan":{ /* Configuración del plan de facturación. */
"flags": <uint>, /* Marcas del plan de facturación. */
"blockBalance": <int>, /* Saldo de bloqueo. */
"denyBalance": <int>, /* Saldo mínimo requerido para que los servicios de pago estén disponibles. */
"minDaysCounter": <int>, /* Número mínimo de días requerido para que la cuenta esté habilitada. */
"historyPeriod": <int>, /* Período de historial durante el cual se almacenan los mensajes de unidades, en días (si se especifica 0 aquí, el período de almacenamiento es ilimitado). */
"currencyFormat": <text>, /* Formato de moneda. */
"services": { /* Lista de servicios. */
<text>: { /* Nombre. */
"type": <int>, /* Tipo: 1 — bajo demanda; 2 — periódico. */
"usage": <uint>, /* Número de elementos utilizados de este tipo. */
"maxUsage": <int>, /* Número máximo permitido de elementos de este tipo. */
"cost": <text>, /* Tabla de costos. */
"interval": <int>, /* Intervalo de reinicio: 0 — ninguno, 1 — cada hora, 2 — diariamente, 3 — semanalmente, 4 — mensualmente. */
"descr": <text> /* Descripción. */
},
...
}
},
"personal": { /* Configuración de la cuenta. */
... /* En el mismo formato que la configuración del plan de facturación. */
},
"combined": { /* Configuración combinada (configuración relacionada con el plan de facturación y la cuenta). */
... /* En el mismo formato que la configuración del plan de facturación */
}
},
"siteAccess": {
"<service_name>":"<dns_name>", /* Donde la clave es el nombre del servicio y el valor es el nombre DNS. */
...
},
"dealerRights": <int>, /* Indica si se permiten derechos de distribuidor para este plan de facturación: 0 — no, 1 — sí */
"subPlans": [<text>] /* Lista de planes de facturación subordinados. */
}
Puede encontrar los valores disponibles de las marcas de plan de facturación y cuenta, así como la lista de servicios en la página account/get_account_data.
Para obtener más información sobre la estructura de configuración de cuenta y plan de facturación, consulte account/update_billing_plan.
Códigos de error
Si la solicitud falla, se devuelve el código de error 4 que indica uno de los siguientes problemas:
- los parámetros de entrada son incorrectos,
- no se pudo obtener el usuario.