概要

ベイズ推定(Paul Graham式)を用いて、指定した文章がスパムかどうかを判定するWeb APIです。また、学習APIも備えているため、必要に応じて学習させることも可能です。お使いの掲示板スクリプトなどに組み込んでご利用ください。

制限

  • Yahoo! APIの日本語形態素解析を使用しているため、1日の処理数が50000件に制限されます。
  • 判定・学習に用いるデータベースが1つしかないため、他のユーザの学習操作が反映されてしまいます。

利用について

  • マナーを守ってご自由にご利用ください。
  • ただし、Yahoo! APIは非商用のみですので、商用目的の方のご利用はお控えください。
  • Web APIの設計についてなど、助言大歓迎です。
  • バグ報告などもお待ちしております。

お試しかっ!

http://coelacanth.on.coocan.jp/api/bayesian/sample/index.phpで体験できます。

仕様

判定API

リクエスト

  • メソッド
     
    POST

パラメータ

  • sentence
     
    判定対象の文章を指定します。

応答

/result/api/productソフトウェア名
/result/api/versionAntiSpamAPIのバージョン
/result/api/copyrightAntiSpamAPIの著作権情報
/result/api/urlサイトURL
/result/timecost/step処理時間(秒)
/result/codeエラーコード
/result/descriptionエラーコードの説明
/result/probスパム確率(%)
  • 例)
    <?xml version="1.0" encoding="utf-8" ?>
    <result>
    <api>
    <product>AntiSpamAPI</product>
    <version>1.00b1</version>
    <copyright>Copyright(c) 2009 シーラカンス</copyright>
    <url>http://coelacanth.on.coocan.jp/</url>
    </api>
    <timecost>
    <step>0.37896483</step>
    <step>2.33496353</step>
    </timecost>
    <code>0000</code>
    <description>正常に処理しました。</description>
    <prob>95</prob>
    </result>

学習API

リクエスト

  • メソッド
     
    POST

パラメータ

  • type
     
    学習の種類を表します。非スパム学習を行う場合は"good"、スパム学習を行う場合は"bad"を指定します。
  • sentence
     
    判定対象の文章を指定します。

応答

/result/api/productソフトウェア名
/result/api/versionAntiSpamAPIのバージョン
/result/api/copyrightAntiSpamAPIの著作権情報
/result/api/urlサイトURL
/result/timecost/step処理時間(秒)
/result/codeエラーコード
/result/descriptionエラーコードの説明
  • 例)
    <?xml version="1.0" encoding="utf-8" ?>
    <result>
    <api>
    <product>AntiSpamAPI</product>
    <version>1.00b1</version>
    <copyright>Copyright(c) 2009 シーラカンス</copyright>
    <url>http://coelacanth.on.coocan.jp/</url>
    </api>
    <timecost>
    <step>0.37896483</step>
    <step>2.33496353</step>
    </timecost>
    <code>0000</code>
    <description>正常に処理しました。</description>
    </result>

応答コード(判定・学習共通)

HTTPレスポンス

200正常
400パラメータエラー
500サーバ内部エラー
503サーバが利用できない状態にある

エラーコード

0000正常
0001不正なパラメータエラーです。
0002Yahoo! APIにリクエスト中にエラーが発生しました。
0003Yahoo! APIの利用制限に達しました。
0004Yahoo! APIの内部エラーです。

改版履歴

2009/02/261.00b1初版公開
2009/02/271.00b2チューニングしました

連絡先

シーラカンス - coreless.corenon@gmail.com


トップ   編集 凍結解除 差分 バックアップ 添付 複製 名前変更 リロード   新規 一覧 単語検索 最終更新   ヘルプ   最終更新のRSS
Last-modified: 2010-06-22 (火) 10:02:56 (597d)