Información de API de revendedor - Ayuda de ChimeraTool

Puede utilizar nuestra clase PHP para comunicarse con los servidores de chimeratool.com.cn: transferir créditos, revocar transferencias de créditos, recopilar información sobre su cuenta (por ejemplo, su saldo de crédito), enumerar sus transferencias e identificar usuarios de chimeratool.

Nuestra clase PHP se comunica a través del protocolo HTTPS y utiliza el método GET para recuperar datos en formato JSON.

Puedes descargar la llamada PHP aquí .

Códigos y mensajes de error

Las llamadas a la API pueden responder con diferentes códigos de error, por lo que puede identificar el error fácilmente.

Errores de conexión

Errores de autenticación

Errores de transferencia

Errores en el listado

Revocar errores

Comprobar errores de usuario

Comprobar errores de ChimeraCard

Comprobar errores de licencias de usuario

Errores en la licencia de venta

Errores de extensión de licencia

Errores de actualización de licencia

Errores en la revocación de licencia

Funciones API

Todas las funciones devuelven una matriz asociativa, que siempre tiene un elemento de tipo booleano llamado "success". Si su valor es FALSE, entonces la llamada a la API no se realizó correctamente y también puede encontrar las claves "code" y "message" en la matriz de respuesta. Los elementos "code" y "message" describen el error. Los códigos de error se enumeran arriba.

En caso de que no haya ningún error, puede haber varias respuestas. La lista siguiente explica cada función junto con sus parámetros y valores de retorno. La lista de valores de retorno indica las claves de la matriz asociativa devuelta.

ChimeraApi::getTransferList($página = 1, $límite = 50)

Con este método, puede consultar o listar sus transacciones. Puede obtener los identificadores de las transacciones que desea revocar. La lista generada está ordenada por fecha en orden descendente.

Parámetros:

• $page - página del conjunto de resultados (la primera página es 1)
• $limit - número de resultados en una página (no puede ser mayor a 200)

Es como una función de paginación estándar. Si tiene 500 transacciones y el límite está establecido en 50, la primera página mostrará los resultados de las transacciones 1 a 50, y la segunda página mostrará las transacciones 51 a 100.

Devolver:

• éxito - indica si la llamada fue exitosa (booleano)
• transferencias - lista de transferencias de créditos (matriz asociativa)
  • id - ID de transferencia (int)
  • fecha - fecha de transferencia (matriz asociativa, objeto DateTime serializado)
  • from - nombre del usuario de donde provienen los créditos (cadena)
  • para - nombre del usuario a quien se enviaron los créditos (cadena)
  • cantidad - importe del crédito transferido (decimal)
  • revocado - indica que la transacción fue revocada (booleano)

ChimeraApi::getInfo()

Proporciona información sobre su cuenta.

Parámetros: -

Devolver:

• éxito - indica si la llamada fue exitosa (booleano)
• creditBalance - su saldo de crédito actual
• transfersCount - número de sus transferencias de crédito

ChimeraApi::transferCredit($userId, $monto)

Transfiere el crédito '$amount' de tu cuenta a '$userId'.

Parámetros:

• $userId - ID del usuario al que desea enviar crédito
• $amount - número de créditos que desea transferir

Devolver:

• éxito - indica si la llamada fue exitosa (booleano)

• transferId - ID de la transferencia de crédito (entero)

• mensaje - mensaje de éxito legible para humanos

ChimeraApi::revokeTransfer($transferId)

Revocar la transferencia identificada por '$transferId'.

Parámetros:

• $transferId - ID de la transferencia de crédito que desea revocar (obtener de transferCredit)

Devolver:

• éxito - indica si la llamada fue exitosa (booleano)
• mensaje - mensaje de éxito legible para humanos

ChimeraApi::checkUser($nombre de usuario, $correo electrónico)

Puedes verificar un usuario con esta función. Responde con el ID del usuario indicado.

Parámetros:

• $username - nombre del usuario

Devolver:

• éxito - indica si la llamada fue exitosa (booleano)
• userId - ID del usuario indicado

ChimeraApi::checkChimeraCard($número de serie)

Puedes verificar una ChimeraCard con esta función.

Parámetros:

• $serialnumber - número de serie de la tarjeta

Devolver:

• éxito - indica si la llamada fue exitosa (booleano)
• serialnumber - número de serie de la ChimeraCard (cadena)
• haslicence - indica si la ChimeraCard tiene licencia (booleano)
• licensename: si la ChimeraCard tiene una licencia, el nombre de la licencia (cadena) está aquí; de lo contrario, es nulo.

ChimeraApi::checkUserLicences($nombre de usuario, $correo electrónico)

Comprobar licencias de usuario.

Parámetros:

• $username - nombre del usuario

Devolver:

• éxito - indica si la llamada fue exitosa (booleano)
• userId - ID del usuario indicado
• licencias - licencias de usuario (matriz)

ChimeraApi::sellLicence($id de destino, $tipo de destino, $nombre de licencia)

Vender una licencia.

Parámetros:

• $targetid - id del objetivo (ID de usuario o número de serie de ChimeraCard)
• $targettype - ya sea 'usuario' o 'chimeracard'
• $licencename - nombre de la licencia

Devolver:

• éxito - indica si la llamada fue exitosa (booleano)

• actionId - ID de la acción del revendedor (entero)

ChimeraApi::extendLicence($idlicenciausuario)

Extender una licencia.

Parámetros:

• $userlicenceid - ID de la licencia del usuario

Devolver:

• éxito - indica si la llamada fue exitosa (booleano)

ChimeraApi::upgradeLicence($idlicenciausuario, $nombrelicencia = 'Pro')

Actualizar una licencia.

Parámetros:

• $userlicenceid - ID de la licencia del usuario
• $licencename - ya sea 'Pro' o 'Premium', el valor predeterminado es 'Pro' (opcional)

Devolver:

• éxito - indica si la llamada fue exitosa (booleano)

ChimeraApi::licenciadisponible()

Lista de licencias disponibles

Parámetros:

• -

Devolver:

• licencias - licencias disponibles (matriz)

ChimeraApi::buyLicencePrices($userId)

Calcula los precios de licencia para el usuario

Parámetros:

• $ID de usuario

Devolver:

• licencias - licencias disponibles (matriz)

ChimeraApi::getSoldLicenceList($página, $límite)

Devuelve la lista de licencias vendidas

Parámetros:

• $page - número de página
• $limit - resultados por página

Devolver:

• éxito
• Licencias vendidas - (matriz)
• paginación - información para paginación

ChimeraApi::revokeLicence($actionId)

Revoca una licencia vendida (si es posible)

Parámetros:

• $actionId - ID de la acción (obtener de sellLicence y getSoldLicenceList)

Devolver:

• éxito