Home      API一覧     お気に入りブックマーク削除API

楽天お気に入りブックマーク削除APIは楽天のお気に入りブックマークの情報を削除することが可能なAPIです。
デベロッパーはOAuth2.0（API認可方式）を使用して、
ユーザーにユーザー自身のお気に入りブックマークを削除させることが可能です。
削除には取得、追加時に返却されるbookmark_idが必要です。

リクエスト方法


  1. OAuth2.0（API認可方式）で、access_tokenを取得します。
    ※アプリ登録後に表示されるアプリIDとapplication_secretを使用します。
       アプリ未登録の方は登録してください。
    ※OAuth2.0（API認可方式）を使用したaccess_token取得方法についてはこちらをご覧ください。
  2. 取得したaccess_tokenを利用して、リクエストします。
    ※APIテストフォームでテストすることができます。
https://app.rakuten.co.jp/services/api/FavoriteBookmark/Delete/20120627?
format=json&
access_token=[access_token]&
bookmark_id=[bookmark_id]

※短い時間の間に大量に、同一のリクエストURLへアクセスすると、一定時間利用できなくなる場合がございます。テストの際にはご注意ください。

ページの先頭へ

使用許可スコープ


rakuten_favoritebookmark_update
ページの先頭へ

入力パラメーター


お気に入り商品削除API 入力パラメータ

ID 項目名 パラメーター 型(括弧内は最大バイト数) 必須 デフォルト 備考
1 アクセストークン access_token String Affiliate対応あり - アクセストークンの取得方法はこちらを参照してください
2 レスポンス形式 format String json json か xml かどちらかを指定することができます。
3 ブックマークID bookmarkId String Affiliate対応あり - お気に入りブックマーク取得時と追加時に取得できます
ページの先頭へ

出力パラメーター


お気に入り商品削除API 出力パラメータ

ID 項目名 パラメーター 型(括弧内は最大バイト数） 備考
1 削除数 affectedCount int ブックマーク削除数を返却します

ページの先頭へ

Error

Error messages are displayed in the form of HTTP status code and its response body

HTTP Status Code Description Response body example (JSON)
400 Parameter error (or required parameters were insufficient)

If applicationId is not set

{
    "error": "wrong_parameter",
    "error_description": "specify valid applicationId"
}

If keyword is not valid (only 1 character given, etc.)

{
    "error": "wrong_parameter",
    "error_description": "keyword parameter is not valid"
}
401 access_token is unauthorized (expired or invalid)

If access_token is expired

{
    "error": "invalid_token",
    "error_description": "specified access token is expired"
}

If access_token is invalid

{
    "error": "invalid_token",
    "error_description": "specify valid access token"
}
403 access_token is forbidden(scope is insufficient)

Insufficient scope (a required scope name will be display in xxxxx)

{
    "error": "insufficient_scope",
    "error_description": "specified access token has no permission for xxxxx"
}
404 If data not found. 
{
    "error": "not_found",
    "error_description": "not found"
}
429 Too many requests

This error will be displayed if the number of API requests has been exceeded.
Please try access again after an amount of time.

{
    "error": "too_many_requests",
    "error_description": "number of allowed requests has been exceeded for this API. please try again soon."
}
500 Internal error in Rakuten Web Service

An internal system error occured. If you continue seeing this message for a long period, please give your inquiry via this link

{
    "error": "system_error",
    "error_description": "api logic error"
}
503 Unavailable due to maintenance or overloaded

Maintenance (the API name will be displayed in XXX/XXX)

{
    "error": "service_unavailable",
    "error_description": "XXX/XXX is under maintenance"
}

Response body format is display in format.

format Error output example
json 
{
    "error": "wrong_parameter",
    "error_description": "page must be a number"
}
xml 
<?xml version="1.0" encoding="UTF-8"?>
<root>
    <error>wrong_parameter</error>
    <error_description>page must be a number</error_description>
</root>
To the top of the page
)
開発方法