activation_code_report
Para obtener datos históricos sobre las acciones con códigos de activación (asignaciones, desasignaciones y vencimientos) en un intervalo de tiempo indicado, utilice el método account/activation_code_report.
Endpoint
svc=account/activation_code_report¶ms={
"timeFrom": <long>,
"timeTo": <long>
}
Parámetros
La solicitud debe contener los siguientes parámetros:
| Parámetro | Descripción |
|---|---|
| timeFrom | Inicio del intervalo de tiempo (marca de tiempo Unix). Debe ser menor que timeTo. |
| timeTo | Fin del intervalo de tiempo (marca de tiempo Unix). Debe ser mayor que timeFrom. |
Respuesta
Si la solicitud se completa correctamente, la respuesta se devuelve como un array de objetos con el siguiente formato:
[
{
"guid": <text>, /* GUID del código de activación. */
"uid": <long>, /* ID de la unidad. Devuelve 0 si el código no estaba asignado en el momento de la acción. */
"uname": <text>, /* Nombre de la unidad. Vacío si el código no estaba asignado. */
"action": <int>, /* Tipo de acción: 0 — asignado, 1 — desasignado, 2 — vencido. */
"acc_id": <long>, /* ID de la cuenta en la que se creó la unidad. Devuelve 0 si no se asignó ninguna unidad. */
"acc_name": <text>, /* Nombre de la cuenta. Vacío si no se asignó ninguna unidad. */
"tmc": <long>, /* Marca de tiempo de creación del código (hora Unix). */
"ttl": <long>, /* Periodo de validez en segundos. */
"tma": <long>, /* Marca de tiempo de activación, es decir, cuándo se asignó el código a una unidad por primera vez (hora Unix). */
"tme": <long> /* Marca de tiempo estimada de vencimiento (hora Unix). */
}
]
Los datos devueltos dependen del rol del usuario:
- Usuario de la cuenta de nivel superior: se devuelven todas las acciones con códigos de activación del intervalo de tiempo indicado.
- Cuenta con derechos de distribuidor: solo se devuelven las acciones vinculadas a unidades sobre las que el usuario tiene el derecho de acceso Administrar códigos de activación.
Si no se produjo ninguna acción en el intervalo de tiempo indicado, se devuelve un array vacío.
Si la solicitud falla, se devuelve un código de error.
Códigos de error
| Código de error | Descripción |
|---|---|
| 4 | Parámetros de entrada no válidos (faltan parámetros o timeFrom >= timeTo). |
| 5 | Error al ejecutar la solicitud (error interno del servidor). |
| 7 | Acceso denegado, porque el usuario no pertenece a un servicio con billing_by_codes habilitado o no es el creador de una cuenta con derechos de distribuidor. |