Bulk Leads APIの仕様に関して | Community
Skip to main content
事業システム開発部_共通アカウ
事業システム開発部_共通アカウ
New Participant
June 9, 2017
Solved

Bulk Leads APIの仕様に関して

  • June 9, 2017
  • 1 reply
  • 187 views

Bulk Leads API（/bulk/v1/leads.json）を使用して、csvファイルのデータをマルケトデータベースに登録する処理を行う予定なのですが、

エラー、ワーニングが出た際の挙動について2点ほどわからないことが有ります。

また、マルケト管理画面の表示について教えていただきたいことがあります。

①Bulk Leads　failures.jsonAPIについて

・/bulk/v1/leads/batch/{batchId}/failures.json

上記のfailures.json APIを呼び出した時に、以下のようなレスポンスが返ってきます。

{"requestId":"f7ec#15c8a46f000","success":false,"errors":[{"code":"610","message":"Requested resource not found"}]}

このとき、csvファイルの何行目のデータがエラーになっているかという情報はレスポンスに表示されないのでしょうか？

もし、されないのであれば何行目のデータがエラーになっているという情報を取る方法があるのか、教えていただきたいです。

②Bulk Leads　warnings.jsonAPIについて

・/bulk/v1/leads/batch/{batchId}/warnings.json

こちらのAPIを呼び出した時に、success：trueになっていた場合、

その行データは登録されていないのでしょうか。

また、warningsはどのようなデータの場合、起こり得るのでしょうか。

③API実行後の、マルケト管理画面の表示について

APIでリードデータを登録後、マルケト管理画面で、

API実行結果や実行日時などの情報を確認するすべはあるのでしょうか。

以上3点について、ご存じの方がいらっしゃいましたら教えて頂けると嬉しいです。

This post is no longer active and is closed to new replies. Need help? Start a new post to ask your question.
Best answer by

こんにちは

使ったことがないですが、他のREST APIと同じはずということでコメントさせていただきます。

{"requestId":"f7ec#15c8a46f000","success":false,"errors":[{"code":"610","message":"Requested resource not found"}]}

RESTのエンドポイントが間違っている時にこのレスポンスになります。

http://developers.marketo.com/rest-api/error-codes/

610Requested resource not foundThe URI in the call did not match a REST API resource type. This is often due to an incorrectly spelled or incorrectly formatted request URI

たとえばバッチIDの誤りとか。

ですので、

・/bulk/v1/leads/batch/{batchId}/failures.json

・/bulk/v1/leads/batch/{batchId}/warnings.json

このどちらもリクエストが間違っていること以外は何も返しておらず、ファイルが処理されたか否か、このレスポンスだけではわかりません。

1 reply

A
Anonymous
Accepted solution
June 9, 2017

こんにちは

使ったことがないですが、他のREST APIと同じはずということでコメントさせていただきます。

{"requestId":"f7ec#15c8a46f000","success":false,"errors":[{"code":"610","message":"Requested resource not found"}]}

RESTのエンドポイントが間違っている時にこのレスポンスになります。

http://developers.marketo.com/rest-api/error-codes/

610Requested resource not foundThe URI in the call did not match a REST API resource type. This is often due to an incorrectly spelled or incorrectly formatted request URI

たとえばバッチIDの誤りとか。

ですので、

・/bulk/v1/leads/batch/{batchId}/failures.json

・/bulk/v1/leads/batch/{batchId}/warnings.json

このどちらもリクエストが間違っていること以外は何も返しておらず、ファイルが処理されたか否か、このレスポンスだけではわかりません。

事業システム開発部_共通アカウ
事業システム開発部_共通アカウAuthor
New Participant
June 9, 2017

返信ありがとうございます。

つまり、このエラー（エラーコード:610）はfailresのを呼出した時のエラーの中身ではなく、

そもそもfailures.json APIへの通信が失敗している。ということなのですね。

さきほど、

・/bulk/v1/leads/import/{batchId}/failures.json

をしたところ、エラー内容を取得することができました。

・/bulk/v1/leads/batch/{batchId}/failures.json

・/bulk/v1/leads/import/{batchId}/failures.json

この二つのAPIは何が違うのでしょうか？

もしご存じであれば、教えて頂けると幸いです。

よろしくお願い致します。

A
Anonymous
June 12, 2017

そもそもfailures.json APIへの通信が失敗している。ということなのですね。

そうです。他のAPIでもURI間違えるとおきます。

今回のだとバッチIDに9999とかいれると簡単におきます。

この二つのAPIは何が違うのでしょうか？

２種類あったかなぁーと思っていたら、今日のAPIリファレンスから/bulk/v1/leads/importは消えていましたよ。

Terms & ConditionsAccessibility statement

Loading footer...