gigapod api ご紹介資料 -...

GIGAPOD API ご紹介資料トライポッドワークス株式会社

2014年11月

GIGAPODについて

Cipyright TripodWorks Co., Ltd. All right reserved. 2

「GIGAPOD」は、企業の大容量ファイル転送に最適な企業向けオンラインストレージです。

あなた

お客様

ダウンロードURL

アップロード

ダウンロード

ラインナップは、アプライアンス／ソフトウエア／クラウドサービス！

GIGAPODで何ができる？

Copyright TripodWorks Co., Ltd. All right reserved. 3

ファイル転送 .... ファイルリンク／フォルダリンク機能

それぞれのリンクにパスワード／有効期限／ダウンロード回数を設定できるからセキュリティも安心です。

取引先との共有 .... ゲストフォルダ機能

各ユーザーには、ゲストフォルダという機能があります。ゲスト用のURL／ユーザーID／パスワードで特定の取引先にGIGAPODのゲストIDを渡すことで円滑なファイル共有が可能になります。

社内のファイル共有 .... 共有フォルダ機能

グループでの権限設定もできるから部署間、プロジェクト間などに活用できます。

管理機能 .... 運用設定・認証管理・権限管理・ログ管理など

企業でも安心して運用できる管理機能でセキュリティ設定やユーザー管理、権限管理などができます。

企業向けオンラインストレージだからこそ安心して利用できる機能を提供

GIGAPOD APIで何ができる？


「GIGAPOD API」を利用することで外部プログラムからGIGAPODの機能を利用できます。

OS

GIGAPOD

認証

ユーザー情報

ファイル参照

アップロード

リンク作成・取得

API主要機能

Windowsプログラム

iOS／Androidアプリ

サーバーサイド言語

HTML5

業務システムやサービスに、オンラインストレージを活用できる。

安心できる品質


GIGAPOD APIの技術は、GIGAPODの関連アプリケーションで既に利用されているので安心して開発ができます。

企業向けファイルマネージャ「DirectPOD」

iOS / Android アプリ Microsoft Outlookアドイン Windowsクライアント

GIAGPOD API は、実行プラットフォームを限定せずに利用できます。

GIGAPOD APIを使うことで....


●作業コストの削減オンラインストレージを定型業務・定型処理にすることで作業工数を削減

●短期間でシステム開発基本機能を開発する必要が無い

ユーザー要望をスピーディーに対応

●シンプルな開発 GIGAPODはソフトウェアとして導入、サービスとしてインターネットで連携する事も可能

●柔軟な設置形態を活用 GIGAPODはソフトウェアとして導入、サービスとしてインターネットで連携する事も可能

バッチ処理

【事例】帳票の自動共有


支店をゲストフォルダ（私書箱機能）として管理。帳票の共有に利用していたファイル共有の自動化を目的にバッチプログラムを開発

月次の定型業務を効率化した事例。

Windowsファイルサーバー

Windows Runtime

GIGAPOD API

A支店

B支店

C支店

ファイル名規則に基づいて、格納先のゲストフォルダを判定。

プラットフォーム：Microsoft Windows Server 開発言語：VB

マクロ

【事例】見積業務の効率化


見積の依頼業務の効率化を検討した事例。

添付メールによる見積業務の負荷を軽減 EXCELのマクロで転送作業を自動化

Windows PC

VBA

GIGAPOD API

業者B

業者A

EXCEL（マクロ）

EXCEL （マクロ）

入力項目に記入して返送

入力項目に記入して返送

対象：Microsoft Excel 2013 開発言語：VBA

【事例】データ納品システムの構築


オンラインでのデータ入稿・データ納品の実現した事例。

データ納品のシステム化を目的にGIGAPODを導入 GIGAPODへアップロードしてダウンロードURLを発行

GIGAPOD連携機能

対象：Linux 開発言語：PHP

ダウンロードURL送信

URLリンク生成

納品メール納品データ取得

データ入稿

既存システム

【事例】Salesforceとオンラインストレージの連携サービス構築


Salesforceにファイル転送を拡張できるアプリを開発。大容量ファイルの共有・転送に伴うコストを削減。

多数の提案資料や商品カタログを添付する事で、Salesforceのストレージが肥大化。高コストなストレージを削減するために、GIGAPOD APIを活用

株式会社インタームーブ「AppMoveBox」 http://www.intermove.co.jp/service/appmovebox/

HTTP POST/GET

どうやって始める？


GIGAPOD APIは、HTTPで行われるため、プログラミング言語の選択肢が広く様々なプログラミング言語で開発することが可能です。

プログラミング言語

JSON パーサー

JSON形式の構文解析

JSON形式の例：[ { “A : { “Aa" : “Ab", “Ac" : “Ad" } } ]

プログラミング言語 Ruby / Python / PHP / VB.NET / C# / Java など

リクエスト（要求）

レスポンス（応答）

APIドキュメント（リクエスト）


URI /app/pb/auth/login Method POST Multipart/form-data No Certification 認証不要

Parameters Name Description

lang 言語ID（日、韓、中、英）エラーメッセージに反映されます。 jpn | kor | chi | eng

id ユーザーID password パスワード

リクエスト仕様

このURIに対して結果をリクエスト

リクエストするパラメーター

GIGAPOD APIでは、ドキュメントを参考に認証、ユーザー情報、ファイル名、アップロード、リンク生成などの要求を開発することができます。

APIドキュメント（レスポンス）


Key Description

lang 言語ID。jpn | kor | chi | eng のいずれか。同値のCookieが発行され、"NBoxUserLang"に格納されます。

user_id ユーザーID 同値のCookieが発行され、"NBoxUser"に格納されます。

user_name ユーザー名

session_id セッションID 同値のCookieが発行され、"NBoxSession"に格納されます。

password_timelimit_exceed パスワードの有効期限を超過しているか否かの判定

password_secure |-operation_authority |-create |-upload |-download |-readonly |-filelink |-guestfolder `-sharedfolder

パスワードポリシーに合致しているか否かの判定操作権限 create = フォルダ作成権限の有無。（通常ユーザーは常にtrue） upload = アップロード権限の有無。（通常ユーザーは常にtrue） download = ダウンロード権限の有無。（通常ユーザーは常にtrue） readonly = 読み取り専用かどうかの有無。（通常ユーザーは常にtrue） filelink = リンクが利用可能かどうか guestfolder = ゲストフォルダが利用可能かどうか sharedfolder = 共有フォルダが利用可能かどうか

license falseの場合、ライセンスの有効期限を超過しています。

administrator trueの場合は管理者権限です。管理者の場合のみキーが存在します。

guestid ゲストの場合のみキーが存在します。ゲストのIDが返されます。同値のCookieが発行され "NBoxGuest" に格納されます。

guestkey ゲストの場合のみキーが存在します。ゲストキーが返されます。同値のCookieが発行され "NBoxGuestSha" に格納されます。

{

"lang": "jpn",

"operation_authority": {

"download": true,

"filelink": true,

"guestfolder": true,

"readonly": true,

"sharedfolder": true,

"upload": true,

"create”:true

},

"password_secure": true,

"password_timelimit_exceed": false,

"session_id": "20110202172852024125",

"success": true,

"user_id": "demo",

"username": "山田太郎"

}

レスポンスの例レスポンス仕様

{

"success":false,

"all":"Incorrect ID or password.“

}

APIの処理フロー概要


例えば、フォルダを作成して、ファイルをアップロードして、そのファイルのリンクを取得したい場合は、下記のような流れになります。

認証処理

/app/pb/auth/login

フォルダ作成

/app/item/folder/add

アップロード

/app/item/upload

リンク取得

/app/link/edit

認証を行い、セッションを確立します。認証Cookieを受け取ります。

フォルダIDとフォルダ名を指定してフォルダを作成します。

フォルダIDを指定して、ファイルをアップロードします。（マルチパート形式）

リンクのセキュリティ設定を指定してリンクを取得します。（有効期限、パスワード、ダウンロード回数）

実装モデルイメージ


実際にGIGAPOD APIを用いた場合は、様々なモデリングが考えられます。頻繁に利用するAPI処理は、クラス化するなどして冗長にならないなどの工夫も大切です。

ユーザーインターフェース

コントローラークラス

メイン処理クラス

認証クラスファイルクラス

UP/DLクラスセッションクラス

など

JSONパーサーライブラリ

HTTPライブラリ

GIGAPOD

ラッパークラス GIGAPOD APIを汎用化したクラス群

GIGAPODコマンド


■OSシェルからGIGAPODを操作するツール ―共有・転送・ログ取得など ■クロスプラットフォームで動作 ■ソースコードを同梱

「GIGAPOD API」を利用して、Windowsのコマンドプロンプトや、Linuxのbashスクリプトから実行できるアプリケーションです。「GIGAPODコマンド」は、様々な環境で簡単にファイル転送処理の自動化を行うことができます。同梱されるソースコード（開発言語： Python ）は、開発者がカスタマイズ可能で「GIGAPOD API」の実装リファレンスとしても利用することができます。

GIGAPODコマンドは下記URLよりダウンロードできます。 http://www.tripodworks.co.jp/product/gigapod/option.html

http://www.tripodworks.co.jp/product/gigapod/option.html

http://www.tripodworks.co.jp/product/gigapod/option.html

お問い合わせ


GIGAPOD製品、GIGAPOD APIについては、下記URLよりお問い合わせください。

https://www.tripodworks.co.jp/contact/

トライポッドワークス ―お問い合わせ―

注意事項本書に関する著作権は、トライポッドワークス株式会社に帰属します。トライポッドワークス株式会社が事前に承諾している場合を除き、形態および手段を問わず本書またはその一部を複製することは禁じられています。本書の作成にあたっては細心の注意を払っていますが、本書の記述に誤りや欠落があってもトライポッドワークス株式会社はいかなる責任も負わないものとします。本書及びその記述内容は予告なしに変更される場合があります。

トライポッドワークス株式会社 GIGAPOD API ご紹介資料 2014年11月

https://www.tripodworks.co.jp/contact/

gigapod api ご紹介資料 -...

Documents