Informações da API do revendedor - Ajuda do ChimeraTool

Você pode usar nossa classe PHP para se comunicar com os servidores do chimeratool.com.cn: transferir créditos, revogar transferências de créditos, coletar informações sobre sua conta (por exemplo, seu saldo de créditos), listar suas transferências e identificar usuários do chimeratool.

Nossa classe PHP se comunica pelo protocolo HTTPS e usa o método GET para recuperar dados no formato JSON.

Você pode baixar a chamada PHP aqui .

Códigos e mensagens de erro

As chamadas de API podem responder com diferentes códigos de erro, para que você possa identificar o erro facilmente.

Erros de conexão

Erros de autenticação

Erros de transferência

Erros de listagem

Revogar erros

Verifique os erros do usuário

Verifique os erros do ChimeraCard

Verifique erros de licenças de usuário

Erros de licença de venda

Estender erros de licença

Erros de atualização de licença

Erros de revogação de licença

Funções da API

Todas as funções retornam com um array associativo, que sempre tem um elemento do tipo booleano chamado 'success'. Se seu valor for FALSE, então a chamada da API não foi bem-sucedida e você pode encontrar as chaves 'code' e 'message' no array de resposta também. Os elementos 'code' e 'message' descrevem o erro. Os códigos de erro estão listados acima.

No caso de não haver erro, pode haver várias respostas. A listagem abaixo explica todas as funções junto com seus parâmetros e valores de retorno. A listagem de valores de retorno significa as chaves do array associativo retornado.

ChimeraApi::getTransferList($página = 1, $limite = 50)

Você pode consultar/listar suas transações com este método. Você pode obter os IDs das transações que você gostaria de revogar. A lista gerada é ordenada por data em ordem decrescente.

Parâmetros:

• $page - página do conjunto de resultados (a primeira página é 1)
• $limit - número de resultados em uma página (não pode ser maior que 200)

É como uma função de paginação padrão. Se você tem 500 transações e o $limit está definido como 50, então a primeira página mostrará os resultados das transações 1-50, e a segunda página mostrará as transações 51-100.

Retornar:

• sucesso - indica se a chamada foi bem-sucedida (booleano)
• transferências - lista de transferências de crédito (matriz associativa)
  • id - ID de transferência (int)
  • data - data da transferência (matriz associativa, objeto DateTime serializado)
  • de - nome do usuário de onde os créditos vieram (string)
  • para - nome do usuário para onde os créditos foram enviados (string)
  • montante - valor do crédito transferido (decimal)
  • revogado - indica que a transação foi revogada (booleano)

ChimeraApi::getInfo()

Fornece informações sobre sua conta.

Parâmetros: -

Retornar:

• sucesso - indica se a chamada foi bem-sucedida (booleano)
• creditBalance - seu saldo de crédito atual
• transfersCount - número de suas transferências de crédito

ChimeraApi::transferCredit($userId, $quantidade)

Transfere o crédito '$amount' da sua conta para '$userId'.

Parâmetros:

• $userId - ID do usuário para o qual você deseja enviar crédito
• $amount - número de créditos que você deseja transferir

Retornar:

• sucesso - indica se a chamada foi bem-sucedida (booleano)

• transferId - ID da transferência de crédito (inteiro)

• mensagem - mensagem de sucesso legível por humanos

ChimeraApi::revokeTransfer($transferId)

Revogar a transferência identificada por '$transferId'.

Parâmetros:

• $transferId - ID da transferência de crédito que você deseja revogar (obtido de transferCredit)

Retornar:

• sucesso - indica se a chamada foi bem-sucedida (booleano)
• mensagem - mensagem de sucesso legível por humanos

ChimeraApi::checkUser($nomedeusuário, $email)

Você pode verificar um usuário com esta função. Ela responde com o ID do usuário fornecido.

Parâmetros:

• $username - nome do usuário

Retornar:

• sucesso - indica se a chamada foi bem-sucedida (booleano)
• userId - ID do usuário fornecido

ChimeraApi::checkChimeraCard($númerodesérie)

Você pode verificar um ChimeraCard com esta função.

Parâmetros:

• $serialnumber - número de série do cartão

Retornar:

• sucesso - indica se a chamada foi bem-sucedida (booleano)
• serialnumber - número de série do ChimeraCard (string)
• haslicence - indica se o ChimeraCard tem uma licença (booleano)
• licensename - se o ChimeraCard tiver uma licença, o nome da licença (string) estará aqui, caso contrário, nulo

ChimeraApi::checkUserLicences($nomedeusuário, $email)

Verifique as licenças do usuário.

Parâmetros:

• $username - nome do usuário

Retornar:

• sucesso - indica se a chamada foi bem-sucedida (booleano)
• userId - ID do usuário fornecido
• licenças - licenças de usuário (matriz)

ChimeraApi::sellLicence($targetid, $targettype, $licencename)

Vender uma licença.

Parâmetros:

• $targetid - id do alvo (userID ou número de série do ChimeraCard)
• $targettype - 'usuário' ou 'chimeracard'
• $licencename - nome da licença

Retornar:

• sucesso - indica se a chamada foi bem-sucedida (booleano)

• actionId - ID da ação do revendedor (inteiro)

ChimeraApi::extendLicence($userlicenceid)

Estender uma licença.

Parâmetros:

• $userlicenceid - ID da licença do usuário

Retornar:

• sucesso - indica se a chamada foi bem-sucedida (booleano)

ChimeraApi::upgradeLicence($userlicenceid, $licencename = 'Pro')

Atualizar uma licença.

Parâmetros:

• $userlicenceid - ID da licença do usuário
• $licencename - 'Pro' ou 'Premium', o padrão é 'Pro' (opcional)

Retornar:

• sucesso - indica se a chamada foi bem-sucedida (booleano)

ChimeraApi::disponíveisLicenças()

Lista as licenças disponíveis

Parâmetros:

• -

Retornar:

• licenças - licenças disponíveis (matriz)

ChimeraApi::buyLicencePrices($userId)

Calcula preços de licença para usuário

Parâmetros:

• $ID do usuário

Retornar:

• licenças - licenças disponíveis (matriz)

ChimeraApi::getSoldLicenceList($página, $limite)

Retorna a lista de licenças vendidas

Parâmetros:

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

Retornar:

• sucesso
• soldLicences - (matriz)
• paginação - informações para paginação

ChimeraApi::revokeLicence($actionId)

Revoga uma licença vendida (se possível)

Parâmetros:

• $actionId - ID da ação (obtido de sellLicence e getSoldLicenceList)

Retornar:

• sucesso