配信一覧取得 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年以上経過した配信を参照したい場合は、サポートまでお問い合わせください。