Информация об API реселлера - Помощь ChimeraTool

Вы можете использовать наш PHP-класс для взаимодействия с серверами chimeratool.com.cn: переводить кредиты, отзывать кредитные переводы, собирать информацию о вашей учетной записи (например, ваш кредитный баланс), составлять список ваших переводов и идентифицировать пользователей chimeratool.

Наш PHP-класс взаимодействует по протоколу HTTPS и использует метод GET для извлечения данных в формате JSON.

Вы можете загрузить PHP-вызов здесь .

Коды ошибок и сообщения

Вызовы API могут возвращать различные коды ошибок, поэтому вы можете легко определить ошибку.

Ошибки соединения

Ошибки аутентификации

Ошибки передачи

Ошибки листинга

Отменить ошибки

Проверить ошибки пользователя

Проверьте ошибки ChimeraCard

Проверьте ошибки пользовательских лицензий

Ошибки в лицензии на продажу

Ошибки продления лицензии

Ошибки обновления лицензии

Ошибки отзыва лицензии

API-функции

Все функции возвращают ассоциативный массив, который всегда имеет элемент типа boolean с именем 'success'. Если его значение равно FALSE, то вызов API был неудачным, и вы также можете найти ключи 'code' и 'message' в массиве ответа. Элементы 'code' и 'message' описывают ошибку. Коды ошибок перечислены выше.

В случае отсутствия ошибки возможны различные ответы. В приведенном ниже списке объясняются все функции вместе с их параметрами и возвращаемыми значениями. Список возвращаемых значений обозначает ключи возвращаемого ассоциативного массива.

ChimeraApi::getTransferList($page = 1, $limit = 50)

Вы можете запросить/перечислить ваши транзакции с помощью этого метода. Вы можете получить идентификаторы транзакций, которые вы хотели бы отозвать. Сгенерированный список упорядочен по дате в порядке убывания.

Параметры:

• $page - страница набора результатов (первая страница - 1)
• $limit - количество результатов на одной странице (не может быть больше 200)

Это похоже на стандартную функцию разбиения по страницам. Если у вас 500 транзакций и $limit установлен на 50, то на первой странице будут показаны результаты транзакций 1-50, а на второй странице будут показаны транзакции 51-100.

Возвращаться:

• успех - указывает, был ли вызов успешным (логическое значение)
• переводы - список кредитных переводов (ассоциативный массив)
  • id - идентификатор перевода (целое)
  • дата - дата перевода (ассоциативный массив, сериализованный объект DateTime)
  • from - имя пользователя, откуда пришли кредиты (строка)
  • to - имя пользователя, которому были отправлены кредиты (строка)
  • сумма - сумма переведенного кредита (десятичная)
  • отозвано — указывает, что транзакция была отозвана (логическое значение)

ChimeraApi::getInfo()

Предоставляет информацию о вашем аккаунте.

Параметры: -

Возвращаться:

• успех - указывает, был ли вызов успешным (логическое значение)
• creditBalance - ваш текущий кредитный баланс
• transferCount - количество ваших кредитных переводов

ChimeraApi::transferCredit($userId, $amount)

Переводит кредит в размере «$amount» с вашего счета на счет «$userId».

Параметры:

• $userId — идентификатор пользователя, которому вы хотите отправить кредит
• $amount - количество кредитов, которые вы хотите перевести

Возвращаться:

• успех - указывает, был ли вызов успешным (логическое значение)

• transferId - идентификатор кредитного перевода (целое число)

• сообщение - понятное человеку сообщение об успешном завершении

ChimeraApi::revokeTransfer($transferId)

Отозвать перевод, идентифицированный как «$transferId».

Параметры:

• $transferId - идентификатор кредитного перевода, который вы хотите отозвать (получить из transferCredit)

Возвращаться:

• успех - указывает, был ли вызов успешным (логическое значение)
• сообщение - понятное человеку сообщение об успешном завершении

ChimeraApi::checkUser($имя_пользователя, $адрес_электронной_почты)

С помощью этой функции можно проверить пользователя. Она возвращает идентификатор указанного пользователя.

Параметры:

• $username - имя пользователя

Возвращаться:

• успех - указывает, был ли вызов успешным (логическое значение)
• userId - идентификатор данного пользователя

ChimeraApi::checkChimeraCard($serialnumber)

С помощью этой функции вы можете проверить ChimeraCard.

Параметры:

• $serialnumber - серийный номер карты

Возвращаться:

• успех - указывает, был ли вызов успешным (логическое значение)
• serialnumber - серийный номер ChimeraCard (строка)
• haslicence — указывает, есть ли у ChimeraCard лицензия (логическое значение)
• licensename - если у ChimeraCard есть лицензия, то здесь указывается имя лицензии (строка), в противном случае - null

ChimeraApi::checkUserLicences($имя пользователя, $адрес электронной почты)

Проверьте лицензии пользователя.

Параметры:

• $username - имя пользователя

Возвращаться:

• успех - указывает, был ли вызов успешным (логическое значение)
• userId - идентификатор данного пользователя
• лицензии - пользовательские лицензии (массив)

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

Продать лицензию.

Параметры:

• $targetid - идентификатор цели (userID или серийный номер карты ChimeraCard)
• $targettype - либо «пользователь», либо «химеракарта»
• $licencename - название лицензии

Возвращаться:

• успех - указывает, был ли вызов успешным (логическое значение)

• actionId - идентификатор действия реселлера (целое число)

ChimeraApi::extendLicence($userlicenceid)

Продлить лицензию.

Параметры:

• $userlicenceid - идентификатор лицензии пользователя

Возвращаться:

• успех - указывает, был ли вызов успешным (логическое значение)

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

Обновите лицензию.

Параметры:

• $userlicenceid - идентификатор лицензии пользователя
• $licencename — «Pro» или «Premium», по умолчанию «Pro» (необязательно)

Возвращаться:

• успех - указывает, был ли вызов успешным (логическое значение)

ChimeraApi::доступныеЛицензии()

Список доступных лицензий

Параметры:

• -

Возвращаться:

• лицензии - доступные лицензии (массив)

ChimeraApi::buyLicencePrices($userId)

Рассчитывает стоимость лицензии для пользователя

Параметры:

• $userId

Возвращаться:

• лицензии - доступные лицензии (массив)

ChimeraApi::getSoldLicenceList($page, $limit)

Возвращает список проданных лицензий

Параметры:

• $page - номер страницы
• $limit - результатов на страницу

Возвращаться:

• успех
• soldLicences - (массив)
• пагинация - информация для пагинации

ChimeraApi::revokeLicence($actionId)

Отменяет проданную лицензию (если возможно)

Параметры:

• $actionId — идентификатор действия (получить из sellLicence и getSoldLicenceList)

Возвращаться:

• успех