1. AdLantis Ad Server APIについて

AdLantis Ad Server API(以下API)はAdLantisの管理画面で行える一連の作業を実行することができるインターフェースです。
使用者はクライアントプログ ラムからAPIを呼び出すことで、管理画面にログインすることなく広告枠やキャンペーンを作成したり、必要なレポート情報を取得することができます。

API を使用するには

現在、APIは限定されたユーザー様にのみ提供しております。一般公開の予定は追ってお知らせ致します。

レ スポンスフォーマット

XML若しくはJSONを指定できます。各アクションの最後にフォーマット指定を追加します。

  • XML フォーマットの場合 : .xml

  • JSON フォーマットの場合 : .json

例). 広告枠一覧を取得する場合のURL
http://api.adlantis.jp/api/mobile/zone/list.xml?page=1&per_page=10

エ ンコード

全レスポンスデータはUTF-8エンコードで返されます。

戻 り値

成功
results : 正常にクエリーが処理された場合、クエリ毎に返ってくる値が異なります。例えば広告枠の一覧を
    取得する リクエストではzonesがルート要素となります。
    検索等で該当レコードがない場合は空が返り ます。

失 敗
errors :
code : エラーコード。
message
: エラーメッセージ。

尚、XMLフォーマットで出力する場合、仕様上「_」は全て「-」に置換されます。

エ ラーコード

コード
メッセージ
説明
1000
認証に失敗しました。
認証しないでAPIにアクセスした際に発生します。
1001
パラメータが不足しています。
指定したアクションに必要な必須パラメータが送られていません。
1002
該当APIを利用する権限若しくは指定されたオブジェクトをアクセスする権限 がありません。
指定したアクションにアクセスする 権限がありません。
1003
不適切な 値が入力されました。
送られたパラメータの中に、 予期せぬ値が入力されています。
-1
例 外が発生しました。
システムエラーです。 Atlantis管理者にお問い合わせ下さい。

日付及び日時の指定方法

レ ポート等で日付を指定する場合は、YYYY/MM/DD形式で指定します。
例). 2010/02/03

また、クリエイティブの配信日時などを指定する場合はYYYY/MM /DD HH:mm:ss形式で指定します。
例). 2010/02/03 12:00:00

尚、配信日時の指定は時間単位までしか対応していません。例えば 2010/02/03 12:45:39と指定しても
2010/02/03 12:00:00に設定されたことになります。

Comments