隠レター API

このエントリーをはてなブックマークに追加

English Page

 本APIを利用することにより,隠レターで埋め込み処理された画像と同等の結果を得ることができ,隠レター/隠Readerで画像をあぶり出すことができます.いわば電子透かしAPIです.

・APIの使い方

http://api.samurai-apps.com/invisiletter/embed.cgiに,下記のクエリ変数を送信します.

<必須の項目>

signimage : 埋め込みたい画像のURI.画像は512KB以下のJPEG/PNGで,グレースケール画像(2値の画像が望ましい)としてください.
origimage : 埋め込み先の画像のURI.画像は512KB以下のJPEG/PNGで,カラー画像としてください.

<任意の項目>

strength : 1-255の半角数字.これ以外の範囲の数字や文字,指定しない場合は60がデフォルトで設定されます.数字が大きいほどより強くsignimageがorigimageに埋め込まれます(埋め込んだ画像を抽出する際によりはっきりとsignimageを見せることができます)が,埋め込み済み画像の色合いが大きく変化します.
requesturl : trueまたはfalseを設定してください.trueを設定すると,埋め込み結果が,埋め込み済み画像のURIが書かれたxmlで返却されます.falseを設定すると,画像そのものが返却されます.true/false以外の文字列を指定したり,指定しない場合はデフォルトでfalseが設定されます.

・返却されるxml

requesturl=trueを設定すると,埋め込みに成功した場合は,下記のようなxmlが返却されます.

 
 
    (埋め込み済み画像のURI) 
 

 指定されたsignimage/origimageが読み込めない,サイズが大きい,画像ではない場合,xml内に下記のようなerrorcodeが格納されて返却されます.

errorcode 901 : signimageのURIが不正,もしくはサイズが大きい
errorcode 902 : origimageのURIが不正,もしくはサイズが大きい
errorcode 903 : origimageで指定されたコンテンツがPNG/JPEGでない
errorcode 904 : signimageで指定されたコンテンツがPNG/JPEGでない

(901と902が同時に返却される例)

 
 
     
         
            901 
            A signature image cannot be read. 
         
         
            902 
            An original image cannot be read. 
         
     
 

・API使用例

http://api.samurai-apps.com/invisiletter/embed.cgi?signimage=http://samurai-apps.com/sign.png&origimage=http://samurai-apps.com/org.jpg&strength=70&requesturl=true

(上記のURIは901/902のエラーが返却されます)

・埋め込み処理された画像について

 origimageは最大480×320画素に収まるようにリサイズされ,埋め込み処理されます.origimageのリサイズでは,アスペクト比(縦横比)が維持されます.埋め込み処理された画像の大きさは,リサイズされたorigimageと同じサイズとなります.signimageは,リサイズされたorigimageと同じ解像度にリサイズされます.signimageのリサイズでは,アスペクト比は維持されません.
 例えば,origimageが1024×1024,signimageが800×600の場合,origimageは320×320,signimageは320×320にリサイズされ,320×320の埋め込み処理された画像が得られます.

 埋め込み処理された画像のフォーマットはフルカラーPNGです.

原画像

原画像


署名画像

埋め込む画像


埋め込まれた画像

埋め込まれた画像


あぶり出された画像(隠レター使用)

あぶり出された画像(隠レター使用)


・画像の取り扱いについてと免責事項
 送信されたorigimage,signimage,埋め込み処理された画像は,ランダムに名前が変更されサーバー内に一定期間保存されます.不慮の事故・事件により万一,これらの画像が流出しても一切責任を負いかねます.ご了承の上でのご使用をお願いします.非商用利用に限ります.商用利用をご検討の際はご連絡下さい.また,その他の使用条件につきましては下記の「アプリケーション使用許諾契約」をご確認ください.

・アプリケーション使用許諾契約(EULA)

End User Licence Agreement

This application program (hereinafter referred as “the Program”) is a computer application program provided by samurai-apps. You cannot download and use the Program without accepting the terms and conditions of this End User License Agreement (EULA). This terms and conditions of this EULA shall apply to all of the services in accordance with the Program. When you start using the Program, it is considered that you accepted all of the terms and conditions.

1. No Warranty.
the Program and other information is delivered to you “AS IS” and with all faults. samurai-apps do not and cannot warrant the performance or results you may obtain by using the Program. In the event that you or your computer devices suffer from any damage by using the Program, neither samurai-apps nor other companies will be liable for the damage.

2. Transfer.
You may not rent, lease, sublicense, assign or transfer your rights in the Program, or authorize all or any portion of the Program to be copied onto another user’s Computer except as may be expressly permitted by this agreement.

3. Intellectual Property Ownership, Reservation of Rights.
All the rights in the Program are owned by samurai-apps. You may not copy, license, transfer or distribute the Program to any other person than you.

4. Privacy
You acknowledge and agree that the Program use the information (including your images) in the database managed by the Program to store it to any local or remote storage through network connection, only as and to the extent necessary for the Program to achieve its functionality.

5. Validity of this Agreement.
Under all conditions, we can stop distributing the Program at our sole decision.

6. Changing the terms and conditions.
Upon your acceptance of EULA, it is considered that you agreed our changing the terms and conditions of EULA at any time without your separate acceptance. When such changes are made to EULA, you shall be bound to the updated version.

© 2017 samurai-apps. All rights reserved. Powered by WordPress Entries RSS Comments RSS