SHANON MARKETING PLATFORM API GUIDE
  • APIの利用方法
    • APIの利用方法
    • 認証
    • APIコールとメソッドリファレンス
    • 検索
    • 登録・更新
  • クライアントアプリケーション認証
    • authentication.get
  • 画面ユーザ認証
    • authapi.login
    • authinfo.getToken
    • authinfo.getCheck
    • authinfo.logout
    • authapi.agencynavigation
    • authapi.agencynavigation.back
  • 管理者
    • admin.get
    • admin.post
    • admin.put
    • admin.delete
  • キャンペーン
    • seminar.get
    • seminar.post
    • seminar.put
    • seminar.delete
    • seminaritemsetting.get
    • seminar.getSession
    • seminar.postSession
    • seminar.putSession
    • seminar.deleteSession
    • sessionitemsetting.get
  • 担当者割当
    • admin.getAssinmentSeminar
    • admin.postAssinmentSeminar
    • admin.deleteAssinmentSeminar
  • アンケート
    • enquetetemplate.get
    • enquetetemplate.getQuestion
  • 講演者
    • speaker.get
    • speakersetting.get
  • 資料
    • document.get
  • リスト
    • staticlist.get
    • staticlist.post
    • staticlist.put
    • staticlist.delete
  • リスト・リード管理
    • staticlist.getVisitor
    • staticlist.postVisitor
    • staticlist.deleteVisitor
  • 企業
    • company.get
    • company.post
    • company.put
    • company.delete
  • 企業・リード管理
    • company.getVisitor
    • company.postVisitor
    • company.deleteVisitor
  • リード
    • visitor.get
    • visitor.post
    • visitor.put
    • visitor.delete
    • visitor.getFile
    • visitor.postFile
    • visitor.putFile
    • visitor.deleteFile
    • visitorsetting.get
  • 申込
    • application.post
    • application.delete
    • seminar.getDiscount
    • visitor.getDiscounthistory
    • visitor.getBilling
    • visitor.getApplication
    • visitor.putApplication
    • counting.getApplication
  • キャンペーン申込情報
    • visitor.getApplicationSeminar
    • visitor.getApplicationSession
  • 申込フロー
    • seminar.getFlow
  • 来場
    • visitor.getAttendance
    • visitor.getAttendanceSeminar
    • visitor.postAttendanceSeminar
    • visitor.deleteAttendanceSeminar
    • visitor.getAttendanceSession
    • visitor.postAttendanceSession
    • visitor.deleteAttendanceSession
    • counting.getAttendance
  • メール送信
    • visitor.postMail
    • 一斉メール送信APIの利用方法
    • mailtemplate.get
    • mailtemplate.post
    • mailtemplate.put
    • mailtemplate.delete
    • mailsender.get
    • mailsender.post
    • mailsender.delete
  • クリックカウント
    • clickcounturl.get
  • トラッキング
    • trackingurl.get
  • メール履歴情報
    • visitor.getMail
  • アンケート履歴情報
    • visitor.getEnquete
    • enquetehistory.get
  • クリックカウント履歴情報
    • visitor.getClickcount
  • トラッキング履歴情報
    • visitor.getTrackingaccesslog
    • visitor.getTrackingsession
  • 資料履歴情報
    • visitor.getDocumentdownload
  • 活動履歴情報
    • visitor.getActivity
    • visitor.postActivity
    • visitor.putActivity
    • visitor.deleteActivity
    • activitysetting.get
  • リード変更履歴情報
    • visitor.getChangelog
    • visitor.getAddlog
    • visitor.getDeletelog
    • visitor.getMergelog
  • DM個別送信履歴情報
    • visitor.getDirectMail
  • キャンペーン設定
    • seminarsettingdata.get
    • seminarsettingdata.put
  • メッセージ
    • messagestr.get
    • messagestr.put
  • ファイル情報
    • file.get
    • file.post
  • 検索条件
    • searchcondition.get
  • バルクAPI
    • 概要
    • bulkapi.get
    • bulkapi.post
  • APPENDIX
    • APIメソッドリファレンス
    • 用語について
    • 共通エラーコード一覧
    • 都道府県IDと都道府県名の対応表
    • タイムゾーンIDとタイムゾーン名の対応表
    • 非推奨API
    • 改訂履歴
Home >> Visitor.post

リード情報登録API

マーケティングプラットフォームのリード情報を新規登録するためのAPIです。

メソッド名

visitor.post

リクエスト情報

アクセスURL

メソッド URL
POST https://{domainname}/services/rest/visitor

URL部パラメータ

パラメータ名 必須 内容
ignore_itemcheck オプション 要素のエラーチェック(必須チェック、型チェック)を行いたくない場合は「1」を指定します。

HTTPリクエストヘッダ

なし

HTTPリクエストボディ

★ エレメント名:VisitorData ★ データ型:VisitorDataType

カラム名 データ型 内容
LoginId string ログインID
LoginPassword string ログインパスワード
Name1 string 姓
Name2 string 名
Name3 string ミドルネーム
Name1Ka string 姓フリガナ
Name2Ka string 名フリガナ
CompanyName string 会社名
CompanyNameKa string 会社名フリガナ
Division string 部署
Position string 役職
Zip1 string 郵便番号1
Zip2 string 郵便番号2
Zip3 string 郵便番号3
Country CountryType 国名
CountryId : CountryName
Prefecture PrefectureType 都道府県IDと都道府県名の対応表参照
Address1 string 住所1
Address2 string 住所2
Address3 string 住所3
Address4 string 住所4
Address5 string 住所5
Tel string 電話番号
SubTel string 電話番号予備
Fax string ファックス番号
Email string E-Mailアドレス
SubEmail string E-mailアドレス予備
PermissionType PermissionTypeType 最新情報等をメールで受け取りますか
PermissionTypeId : PermissionTypeName
1 : 希望する
2 : 希望しない
Language LanguageType 使用言語
LanguageId : LanguageName
1 : 日本語
2 : 英語
※ 他言語も利用可能(SMP環境毎に異なるため、「設定」タブの「言語設定」に登録されている言語をご確認ください)
Memo string メモ
Attribute{aid} - 追加項目 追加項目について/追加項目のデータ型参照
Membership MembershipType ログインIDの使用
MembershipId : MembershipName
1 : 使用する
0 : 使用しない
EmailValid EmailValidType E-mailアドレスの有効フラグ
EmailValidId : EmailValidName
0 : 無効
1 : 有効
SubEmailValid SubEmailValidType E-mailアドレス予備の有効フラグ
SubEmailValidId : SubEmailValidName
0 : 無効
1 : 有効

レスポンス情報

レスポンスコード

コード 内容
201 正常終了

HTTPレスポンスヘッダ

パラメータ名 データ型 内容
Location string 登録されたリソースへのURL
https://{domainname}/services/rest/visitor/{id}

HTTPレスポンスボディ

なし

XMLサンプル

リクエストXMLサンプル

<?xml version='1.0' encoding='UTF-8'?>
<VisitorData xmlns="http://smartseminar.jp/" version="1.5">
 <LoginId>testuser001</LoginId>
 <LoginPassword>testpass001</LoginPassword>
 <Name1>テスト</Name1>
 <Name2>太郎</Name2>
 <Name3>J</Name3>
 <Name1Ka>テスト</Name1Ka>
 <Name2Ka>タロウ</Name2Ka>
 <CompanyName>会社名1</CompanyName>
 <CompanyNameKa>カイシャメイフリガナ1</CompanyNameKa>
 <Division>部署1</Division>
 <Position>役職1</Position>
 <Zip1>111</Zip1>
 <Zip2>1111</Zip2>
 <Zip3>11</Zip3>
 <Country>
  <CountryId>1</CountryId>
  <CountryName>Japan</CountryName>
 </Country>
 <Prefecture>
  <PrefectureId>1</PrefectureId>
  <PrefectureName>北海道</PrefectureName>
 </Prefecture>
 <Address1>札幌市</Address1>
 <Address2>中央区</Address2>
 <Address3>双子山</Address3>
 <Address4>1-1-1</Address4>
 <Address5>ハイツ○○×××号室</Address5>
 <Tel>111-111-1111</Tel>
 <SubTel>222-222-2222</SubTel>
 <Fax>333-333-3333</Fax>
 <Email>failure01@shanon.co.jp</Email>
 <SubEmail>failure02@shanon.co.jp</SubEmail>
 <PermissionType>
  <PermissionTypeId>1</PermissionTypeId>
  <PermissionTypeName>許可</PermissionTypeName>
 </PermissionType>
 <Memo>メモメモ</Memo>
 <Attribute1>追加属性1</Attribute1>
 <Attribute2List>
  <Attribute2>
   <Attribute2Id>1</Attribute2Id>
   <Attribute2Name>選択肢1</Attribute2Name>
  </Attribute2>
 </Attribute2List>
</VisitorData>

レスポンスXMLサンプル

なし

制限事項

  • マーケティングプラットフォームAPIのリクエストパラメータに記載されている必須カラムと、対応するマーケティングプラットフォームの必須カラムは、整合性がとれている必要があります。
  • 例えば、マーケティングプラットフォームAPIでは必須でないカラムであっても、マーケティングプラットフォームのカラムが必須であった場合、APIによるデータ登録処理時に必須エラーが発生します。