48進いろは記数法⇔10進法 変換機 - WebAPI

当サイトの48進法⇔10進法変換機をサイトに組み込むことが出来るWebAPIを公開しております。

概要

利用条件

特に制限はありませんが、1日1万回以上のAPI利用が見込まれる場合にはk2.works のお問い合わせフォームからご連絡ください。

利用方法

本WebAPIでは、10進数また48進数をパラメータ指定して呼び出すと、それに対応する48進数または10進数を得ることができます。

WebAPIを呼び出すには、以下のURLに必要なパラメータをURLの一部として渡す必要があります。

パラメータ指定には PATH_INFO として渡す方法と QUERY_STRING として渡す方法の2通りが可能です。いずれかをお選びください。

10進法⇒48進法

HTTPメソッドGET
エントリポイントURLhttps://base48.systems/api/v1/10248
パラメータ指定方式https://base48.systems/api/v1/10248/10進数/output=出力形式
または
https://base48.systems/api/v1/10248?query=10進数&output=出力形式
10進数50桁以内の正または負の実数値を指定してください。
出力形式xmlXML形式にて出力します。
json
jsonp
JSON/JSONP形式にて出力します。
JSONP形式で出力したい場合は、コールバック関数の名称をオプション callback にて /callback=callBackFunc と追加で指定してください。
phpPHPのハッシュシリアライズ形式にて出力します。
指定なし変換後の値のみをプレーンテキスト形式で返します。

48進法⇒10進法

HTTPメソッドGET
エントリポイントURLhttps://base48.systems/api/v1/48210/48進数/output=出力形式
パラメータ指定方式https://base48.systems/api/v1/48210/48進数/output=出力形式
または
https://base48.systems/api/v1/48210?query=48進数&output=出力形式
48進数30桁以内の正または負の48進実数値をURLエンコードして指定してください。
出力形式xmlXML形式にて出力します。
json
jsonp
JSON/JSONP形式にて出力します。
JSONP形式で出力したい場合は、コールバック関数の名称をオプション callback にて /callback=callBackFunc と追加で指定してください。
phpPHPのハッシュシリアライズ形式にて出力します。
指定なし変換後の値のみをプレーンテキスト形式で返します。

問い合わせ例・戻り値

プレーンテキスト以外の形式については、共通で次のような構造が返ります。

    ┬
    ├ request
    │  ├ query       : 入力された変換対象の文字列
    │  └ options     : 設定された出力オプションの一覧
    │       ├ mode   : 処理モードの内部コード
    │       └ output : 出力形式
    ├ status
    │  ├ code        : 正常なら "OK" 異常なら "ERROR"
    │  └ description : ステータス詳細
    └ value           : 出力結果。エラーが発生した場合 NULL

XML

正常例
https://base48.systems/api/v1/10248/1/output=xml
<?xml version="1.0" encoding="UTF-8" ?>
<Result>
<Request>
<Query>1</Query>
<Options>
<mode>10to48</mode>
<output>xml</output>
</Options>
</Request>
<Status>
<Code>OK</Code>
<Description>Completed successfully.</Description>
</Status>
<Value>い</Value>
</Result>
エラー例
https://base48.systems/api/v1/10248/a/output=xml
<?xml version="1.0" encoding="UTF-8" ?>
<Result>
<Request>
<Query>a</Query>
<Options>
<mode>10to48</mode>
<output>xml</output>
</Options>
</Request>
<Status>
<Code>ERROR</Code>
<Description>Invalid character found.</Description>
</Status>
<Value />
</Result>

JSON/JSONP

正常例
https://base48.systems/api/v1/10248/1/output=json
{"request":{"query":"1","options":{"mode":"10to48","output":"json"}},
"status":{"code":"OK","description":"Completed successfully."},"value":"\u3044"}
エラー例
https://base48.systems/api/v1/10248/a/output=json
{"request":{"query":"a","options":{"mode":"10to48","output":"json"}},
"status":{"code":"ERROR","description":"Invalid character found."},"value":null}
コールバック指定例
https://base48.systems/api/v1/10248/1/callback=SAMPLE.jsonpFunc
SAMPLE.jsonpFunc({"request":{"query":"1","options":{"mode":"10to48","output":"jsonp","callback":"SAMPLE.jsonpFunc"}},
"status":{"code":"OK","description":"Completed successfully."},"value":"\u3044"})

PHP Serialized

実際のレスポンスには改行は含まれません。

正常例
https://base48.systems/api/v1/10248/1/output=php
a:3:{s:7:"request";a:2:{s:5:"query";s:1:"1";s:7:"options";a:2:{s:4:"mode";s:6:"10to48";s:6:"output";s:3:"php";}}
s:6:"status";a:2:{s:4:"code";s:2:"OK";s:11:"description";s:23:"Completed successfully.";}s:5:"value";s:3:"い";}
エラー例
https://base48.systems/api/v1/10248/a/output=php
a:3:{s:7:"request";a:2:{s:5:"query";s:1:"a";s:7:"options";a:2:{s:4:"mode";s:6:"10to48";s:6:"output";s:3:"php";}}
s:6:"status";a:2:{s:4:"code";s:5:"ERROR";s:11:"description";s:24:"Invalid character found.";}s:5:"value";N;}

プレーンテキスト

正常に処理できた場合にはその値のみを、エラーが発生した場合 "ERROR:" から始まる文字列を返します。

正常例
https://base48.systems/api/v1/10248/1
エラー例
https://base48.systems/api/v1/10248/a
ERROR: Invalid character found.

メッセージ一覧

エラー等の際に表示されるメッセージには次の種類があります。

0Completed successfully.正常終了した場合に出力されます。
1No input.有効な入力がない場合に出力されます。
2Too large value to handle.入力された数値が処理可能な範囲を超えている場合に表示されます。
3Invalid character found.入力された文字に、処理の対象外となる文字が含まれていた場合に表示されます。
4No output.以上の原因とは異なる何らかの理由で出力が得られなかった場合に表示されます。

免責事項