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

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

概要

• 本WebAPIは48進法⇔10進法変換機能を提供するREST型のWebサービスです。
• 本WebAPIの結果は、XML・JSON・JSONP・PHP serialized・プレーンテキストのいずれかの形式で受け取ることができます。
• 本WebAPIの入出力に用いる文字セットはUTF-8とします。

利用条件

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

利用方法

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

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

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

10進法⇒48進法

48進法⇒10進法

問い合わせ例・戻り値

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

    ┬
    ├ 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.

メッセージ一覧

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

免責事項

• 小数点以下の値については、最終桁の丸め誤差によって正確に変換できない場合があります。利用するアプリケーションで適宜四捨五入するなどして使用してください。
• 本WebAPIは予告なくサービス内容を変更、一時的に停止、もしくは廃止する場合があります。
• 本WebAPIの提供する情報の正確性の欠如やそれらが原因で発生した損害については一切責任を負いません。