配信一覧取得 API、フォーマット一覧取得 API

概要

配信済みのインフォメーションを含め、全てのインフォメーションを返却します。

注意事項

ManagementApi v3 では、v2及びWeb管理画面にて登録したメッセージは返却されません。

URL

配信一覧取得 API

https://${hostname}/mapi/3.1/info/

フォーマット一覧取得 API

https://${hostname}/mapi/3.1/draft/

メソッド

GET/POST

結果タイプ

複数を返却する

リクエストパラメータ

キー名	必須	タイプ	説明
count	x	整数	参照したい配信の数 ※最大100まで
page	x	整数	ページ番号
filter	x	object	次のキーを持つオブジェクト creator .. インフォメーション作成者（ログインユーザー名）。文字列で指定。

filter項目について

filterパラメータはベータ版です。予告なく仕様を変更する可能性がございます。

リクエストのサンプル

{
  "count": 5,
  "page": 3,
  "filter": {
    "creator": "operator_1"
  }
}

レスポンス

キー名	タイプ	説明
page	整数	現在何ページ目を表示しているか
has_next_page	真偽値	次のページが存在するかどうか
total_results	整数	(現在は未使用。固定値で -1 を返却)
pages	整数	(現在は未使用。固定値で -1 を返却)
result	配列	以下参照

レスポンス(Result)

キー名	タイプ	表示条件	説明
id	整数	-	配信またはフォーマットのID
type	文字列	-	次のうちいずれかの文字列 instant ... 即時送信 scheduled ... 予約送信 location ... 位置連動型送信 wifi ... wifi連動型送信 bluetooth ... bluetooth連動型送信
content_type	文字列	-	text/plain ... テキスト配信 text/html ... HTML配信
platform	配列	-	配信対象のプラットフォーム iphone, androidのいずれか、もしくは両方
popup	文字列	-	ポップアップフリーワード。入稿時、popup_itemsでポップアップフリーワードを設定した際は、bodyキーの値が返される。 delivery_typeを3にした場合、空文字が返される。
popup_items	object	-	プッシュ通知のペイロード設定。入稿時、popupでポップアップフリーワードを設定した際は、{"body": "(指定した文字列)"}が返される。 delivery_typeを3にした場合、nullが返される。
title	文字列	-	件名。delivery_typeを2にした場合、空文字が返される。
content	文字列	-	本文。delivery_typeを2にした場合、空文字が返される。
delivery_type	整数	-	1 ... プッシュ通知/お知らせ表示利用 2 ... プッシュ通知のみ利用 3 ... お知らせ通知のみ利用 4 ... プッシュ通知が許諾されているユーザにはプッシュ通知/お知らせ表示。されていないユーザにはお知らせのみ通知
url	文字列	-	リンク先URL
category	文字列	-	カテゴリー
canceled	bool値	-	配信がキャンセルされたか否か
send_time	文字列	typeがscheduled、もしくは配信情報取得APIでのtypeがinstant	送信日時 (日本時間) ※ yyyy-mm-dd HH:MM:SS フォーマット
period	配列	typeが location, wifi, bluetooth の場合	配信期間次の値を持つオブジェクトの配列 start ... 開始日時、JST(文字列) end ... 終了日時、JST(文字列)
wifissid	配列	typeがwifi	配信Wi-Fi SSID情報次の値を持つオブジェクトの配列 essid .. Wi-FiスポットのESSID(文字列) bssid .. Wi-FiスポットのBSSID(文字列) rssi .. 電波強度(整数)
bluetooth	配列	typeがbluetooth	bluetooth端末情報次の値を持つオブジェクトの配列 type .. iBeacon uuid .. uuid major .. メジャー番号 minor .. マイナー番号 rssi .. 電波強度(デシベル)
status	文字列	配信情報取得API	finished ... 配信完了 canceled ... 配信キャンセル delivering ... 配信中
info_status	文字列	配信情報取得API	typeとstatusから生成される文字列次のルールに従って返される文字列 (予約`\|`GPS`\|`Wifi`\|`Bluetooth`\|`継続)(配信キャンセル`\|`配信中`\|`配信完了) ただし、この文言は変更されることがあります
sent	object	配信情報取得API	配信人数 iphone, android, total, updatedを持つオブジェクト iphone, android のうち配信対象のプラットフォームに含まれないものは、キー自体が返されません。また、個別集計が未対応の場合または仕様上人数を把握できない場合は、-1 が返されます。 updatedにはiphone, android, totalの集計値が更新された日時(日本時間)が返されます ※typeがinstant,scheduledの場合、準リアルタイムに集計された値が返却されます。 ※typeがinstant,scheduled以外の場合、日次集計された値が返却されます。
open	object	配信情報取得API	開封数オブジェクトの形式は sent と同じ ※日次集計された値が返却されます。未集計の場合、-1が返却されます。
view	object	配信情報取得API	閲覧数オブジェクトの形式は sent と同じ ※日次集計された値が返却されます。未集計の場合、-1が返却されます。
click	object	配信情報取得API	サイト閲覧数オブジェクトの形式は sent と同じ ※日次集計された値が返却されます。未集計の場合、-1が返却されます。
created_at	文字列	フォーマット情報取得API、かつ繰り返し機能を利用している	登録日時(日本時間) ※ yyyy-mm-dd HH:MM:SS フォーマット
repeated	object	フォーマット情報取得API、かつ繰り返し機能を利用している	繰り返し機能の設定。次の値を持つオブジェクト frequency .. 繰り返す頻度(daily:毎日配信, weekly:毎週配信, monthly:毎月配信) start .. 繰り返し機能の開始日 end .. 繰り返し機能の終了日 time .. 繰り返し機能の配信時刻(HH:MMの形式で返される) period .. 繰り返し機能の配信期間({"start": "HH:MM": "end": "HH:MM"}が返される) week .. 繰り返し機能の配信曜日の配列(例: ['monday', 'thuesday']) day .. 繰り返し機能の配信日付の配列(例: [1, 2])

レスポンスのサンプル

{
  "status": "OK",
  "result": [
    {
      "category": "カテゴリー",
      "status": "finished",
      "popup": "ポップアップ文字列",
      "popup_items": {
        "body": "popup文言",
        "title": "ポップアップタイトル"
      },
      "title": "件名",
      "url": "http://google.com",
      "open": {
        "android": 1,
        "total": 2,
        "iphone": 1,
        "updated": "2020-01-01 05:00:00"
      },
      "canceled": false,
      "click": {
        "android": 1,
        "total": 2,
        "iphone": 1,
        "updated": "2020-01-01 05:00:00"
      },
      "content": "本文",
      "platform": [
        "iphone",
        "android"
      ],
      "info_status": "送信済み",
      "content_type": "text/plain",
      "send_time": "2016-02-24 03:41:20",
      "type": "instant",
      "id": 11,
      "sent": {
        "android": 36,
        "total": 72,
        "iphone": 36,
        "updated": "2020-01-01 12:30:00"
      },
      "view": {
        "android": 1,
        "total": 2,
        "iphone": 1,
        "updated": "2020-01-01 05:00:00"
      }
    }
  ],
  "page": 3,
  "has_next_page": true,
  "total_results": -1,
  "pages": -1
}

参照可能データ期間について

本APIで参照が保証できる配信情報は、登録日から1年以内の配信となります。 1年を経過した配信に対する本APIのレスポンスは、保証されません。 1年以上経過した配信を参照したい場合は、サポートまでお問い合わせください。