2020年5月21日
NEOのAPI連携機能に関連する「メルマガ一覧データ取得」の説明ページです。
メルマガ一覧データ取得のためのAPIリクエスト
メルマガ一覧データを、APIを利用して取得します。
APIリクエストには、まず、アクセストークンリクエストで
アクセストークンを取得する必要があります。
取得後、アクセストークンを利用してリクエストを行います。
サンプルスクリプトのダウンロードはコチラをクリックしてください。
url
services.php
method
post/get
parameter
path=magazine
読者データ取得API 入力パラメータ
| 項目名 | パラメーター | 型(括弧内は最大バイト数) | 必須 | デフォルト | 備考 |
| アクセストークン | access_token | String | 必須 | – | アクセストークンはアクセストークンリクエストで取得したものです。 |
リクエスト例
services.php?path=magazine& access_token=abzdfefdfggadse
access_token: アクセストークンリクエストで取得したものを設定してください。
レスポンス
読者データ取得API 出力パラメータ
| 項目名 | パラメーター | 型(括弧内は最大バイト数) | 備考 |
| メルマガリスト | 未記入 | 配列 | 未記入 |
レスポンス例
{
{
"id": 1,
"name": "メルマガA"
},
{
"id": 4,
"name": "メルマガB"
},
{
"id": 5,
"name": "メルマガC"
}
}
エラー
リクエストが正常に処理されなかった場合、以下のような
HTTPステータスコードとJSONがレスポンスされます。
| HTTPステータスコード | 説明 | エラー例 | 401 | アクセストークンが期限切れの場合 | { “error”: “invalid_token”, “error_description”: “specified access token is expired” } |
| 402 | 正しくないアクセストークンを指定した場合 | { “error”: “invalid_token”, “error_description”: “specify valid access token” } |
| 500 | システムエラー | { “error”: “system_error”, “error_description”: “api logic error” } |
