リセラーAPI情報 - ChimeraTool ヘルプ

chimeratool.com.cnサーバーとの通信には、当社のPHPクラスを使用できます：クレジットの転送、クレジット転送の取り消し、アカウント情報の取得（例：クレジット残高）、転送のリスト表示、chimeratoolユーザーの識別が可能です。

当社のPHPクラスは、HTTPSプロトコルで通信し、GETメソッドを使用してJSON形式でデータを取得します。

PHP呼び出しはこちらからダウンロードできます。

エラーコードとメッセージ

API呼び出しは、さまざまなエラーコードで応答するため、エラーを簡単に識別できます。

接続エラー

認証エラー

転送エラー

リスト表示エラー

取り消しエラー

ユーザー確認エラー

ChimeraCard確認エラー

ユーザーライセンス確認エラー

ライセンス販売エラー

ライセンス延長エラー

ライセンスアップグレードエラー

ライセンス取り消しエラー

API関数

すべての関数は連想配列を返し、常に'success'という名前のブール型要素を持ちます。値がFALSEの場合、API呼び出しは失敗しており、応答配列には'code'と'message'キーも含まれます。'code'と'message'要素はエラーを説明します。エラーコードは上記にリストされています。

エラーがない場合、さまざまな応答があります。以下のリストは、すべての関数とそのパラメータおよび戻り値を説明しています。戻り値のリストは、返される連想配列のキーを示しています。

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

このメソッドでトランザクションを照会/リスト表示できます。取り消したいトランザクションのIDを取得できます。生成されたリストは、日付の降順で並べられます。

パラメータ：

• $page - 結果セットのページ（最初のページは1）
• $limit - 1ページあたりの結果数（200より大きくできません）

これは標準的なページング機能のようなものです。500件のトランザクションがあり、$limitが50に設定されている場合、最初のページにはトランザクション1-50の結果が表示され、2ページ目にはトランザクション51-100が表示されます。

戻り値：

• success - 呼び出しが成功したかどうかを示します（ブール値）
• transfers - クレジット転送のリスト（連想配列）
  • id - 転送ID（整数）
  • date - 転送日（連想配列、シリアル化されたDateTimeオブジェクト）
  • from - クレジットの送信元ユーザー名（文字列）
  • to - クレジットの送信先ユーザー名（文字列）
  • amount - 転送されたクレジット量（小数）
  • revoked - トランザクションが取り消されたかどうかを示します（ブール値）

ChimeraApi::getInfo()

アカウントに関する情報を提供します。

パラメータ：-

戻り値：

• success - 呼び出しが成功したかどうかを示します（ブール値）
• creditBalance - 現在のクレジット残高
• transfersCount - クレジット転送の数

ChimeraApi::transferCredit($userId, $amount)

アカウントから'$userId'に'$amount'クレジットを転送します。

パラメータ：

• $userId - クレジットを送信したいユーザーのID
• $amount - 転送したいクレジット数

戻り値：

• success - 呼び出しが成功したかどうかを示します（ブール値）

• transferId - クレジット転送のID（整数）

• message - 人間が読める成功メッセージ

ChimeraApi::revokeTransfer($transferId)

'$transferId'で識別される転送を取り消します。

パラメータ：

• $transferId - 取り消したいクレジット転送のID（transferCreditから取得）

戻り値：

• success - 呼び出しが成功したかどうかを示します（ブール値）
• message - 人間が読める成功メッセージ

ChimeraApi::checkUser($username, $email)

この関数でユーザーを確認できます。指定されたユーザーのIDで応答します。

パラメータ：

• $username - ユーザー名

戻り値：

• success - 呼び出しが成功したかどうかを示します（ブール値）
• userId - 指定されたユーザーのID

ChimeraApi::checkChimeraCard($serialnumber)

この関数でChimeraCardを確認できます。

パラメータ：

• $serialnumber - カードのシリアル番号

戻り値：

• success - 呼び出しが成功したかどうかを示します（ブール値）
• serialnumber - ChimeraCardのシリアル番号（文字列）
• haslicence - ChimeraCardがライセンスを持っているかどうかを示します（ブール値）
• licencename - ChimeraCardがライセンスを持っている場合はライセンス名（文字列）、それ以外の場合はnull

ChimeraApi::checkUserLicences($username, $email)

ユーザーのライセンスを確認します。

パラメータ：

• $username - ユーザー名

戻り値：

• success - 呼び出しが成功したかどうかを示します（ブール値）
• userId - 指定されたユーザーのID
• licences - ユーザーのライセンス（配列）

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

ライセンスを販売します。

パラメータ：

• $targetid - ターゲットのID（userIDまたはChimeraCardシリアル番号）
• $targettype - 'user'または'chimeracard'のいずれか
• $licencename - ライセンス名

戻り値：

• success - 呼び出しが成功したかどうかを示します（ブール値）

• actionId - リセラーアクションのID（整数）

ChimeraApi::extendLicence($userlicenceid)

ライセンスを延長します。

パラメータ：

• $userlicenceid - ユーザーのライセンスのID

戻り値：

• success - 呼び出しが成功したかどうかを示します（ブール値）

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

ライセンスをアップグレードします。

パラメータ：

• $userlicenceid - ユーザーのライセンスのID
• $licencename - 'Pro'または'Premium'のいずれか、デフォルトは'Pro'（オプション）

戻り値：

• success - 呼び出しが成功したかどうかを示します（ブール値）

ChimeraApi::availableLicences()

利用可能なライセンスをリスト表示します

パラメータ：

• -

戻り値：

• licences - 利用可能なライセンス（配列）

ChimeraApi::buyLicencePrices($userId)

ユーザーのライセンス価格を計算します

パラメータ：

• $userId

戻り値：

• licences - 利用可能なライセンス（配列）

ChimeraApi::getSoldLicenceList($page, $limit)

販売されたライセンスのリストを返します

パラメータ：

• $page - ページ番号
• $limit - ページあたりの結果数

戻り値：

• success
• soldLicences - （配列）
• pagination - ページングのための情報

ChimeraApi::revokeLicence($actionId)

販売されたライセンスを取り消します（可能な場合）

パラメータ：

• $actionId - アクションのID（sellLicenceとgetSoldLicenceListから取得）

戻り値：

• success