Skip to content

Latest commit

 

History

History
191 lines (129 loc) · 7.27 KB

ReviewsApi.md

File metadata and controls

191 lines (129 loc) · 7.27 KB

Walmart\Apis\MP\US\ReviewsApi

All URIs are relative to https://marketplace.walmartapis.com, except if the operation defines another base path.

Method HTTP request Description
bulkUpdateItemStatus() PUT /v3/growth/reviews-accelerator/items/status Bulk update item status
getIrpCategories() POST /v3/growth/reviews-accelerator/categories Get categories
getIrpItems() POST /v3/growth/reviews-accelerator/items Get RAP post-purchase items

bulkUpdateItemStatus()

bulkUpdateItemStatus($bulkItemStatusUpdateRequest): \Walmart\Models\MP\US\Reviews\BulkItemUpdateResponse

Bulk update item status

To enroll a product in/out of the Reviews acceleration post-purchase program.

Example

<?php
use Walmart\Configuration;
use Walmart\Enums\Country;
use Walmart\Walmart;

require_once __DIR__ . '/vendor/autoload.php';

$config = new Walmart\Configuration([
    'clientId' => 'CLIENT_ID',          // May not be necessary for all endpoints, particularly outside the US
    'clientSecret' => 'CLIENT_SECRET',  // Ditto above
    'country' => Country::US,           // Default Country::US if not set
]);

$api = Walmart::marketplace($config)->reviews();

$bulkItemStatusUpdateRequest = {"status":"ENROLL","items":[{"itemId":"2719243"},{"itemId":"2719255"}]}; // \Walmart\Models\MP\US\Reviews\BulkItemStatusUpdateRequest | Request fields

try {
    $result = $api->bulkUpdateItemStatus($bulkItemStatusUpdateRequest);
    print_r($result);
} catch (Exception $e) {
    echo "Exception when calling ReviewsApi->bulkUpdateItemStatus: {$e->getMessage()}\n";
}

Parameters

Name Type Description Notes
bulkItemStatusUpdateRequest \Walmart\Models\MP\US\Reviews\BulkItemStatusUpdateRequest Request fields

Return type

\Walmart\Models\MP\US\Reviews\BulkItemUpdateResponse

Authorization

This endpoint requires the following authorization methods:

  • accessToken: Header authentication with a Walmart access token, which is automatically generated using your Client ID and Client Secret. The token is valid for 15 minutes, and will be passed in the WM_SEC.ACCESS_TOKEN header

See the Authorization section of the README for more information.

[Back to top] [Back to API list] [Back to Model list] [Back to README]

getIrpCategories()

getIrpCategories($getCategoriesRequest): \Walmart\Models\MP\US\Reviews\GetCategoriesResponse

Get categories

To get the set of categories the RAP post-purchase items belong to.

Example

<?php
use Walmart\Configuration;
use Walmart\Enums\Country;
use Walmart\Walmart;

require_once __DIR__ . '/vendor/autoload.php';

$config = new Walmart\Configuration([
    'clientId' => 'CLIENT_ID',          // May not be necessary for all endpoints, particularly outside the US
    'clientSecret' => 'CLIENT_SECRET',  // Ditto above
    'country' => Country::US,           // Default Country::US if not set
]);

$api = Walmart::marketplace($config)->reviews();

$getCategoriesRequest = {"itemStatus":["ENROLLED","ELIGIBLE","COMPLETE"]}; // \Walmart\Models\MP\US\Reviews\GetCategoriesRequest | Request payload

try {
    $result = $api->getIrpCategories($getCategoriesRequest);
    print_r($result);
} catch (Exception $e) {
    echo "Exception when calling ReviewsApi->getIrpCategories: {$e->getMessage()}\n";
}

Parameters

Name Type Description Notes
getCategoriesRequest \Walmart\Models\MP\US\Reviews\GetCategoriesRequest Request payload

Return type

\Walmart\Models\MP\US\Reviews\GetCategoriesResponse

Authorization

This endpoint requires the following authorization methods:

  • accessToken: Header authentication with a Walmart access token, which is automatically generated using your Client ID and Client Secret. The token is valid for 15 minutes, and will be passed in the WM_SEC.ACCESS_TOKEN header

See the Authorization section of the README for more information.

[Back to top] [Back to API list] [Back to Model list] [Back to README]

getIrpItems()

getIrpItems($scrollId, $getIrpItemsRequest): \Walmart\Models\MP\US\Reviews\GetIrpItemsResponse

Get RAP post-purchase items

To get all eligible products that can be enrolled into the Reviews accelerator post-purchase program. To get all products that are currently enrolled into the program. To get all products that have attained target reviews after enrolment into the program. Products can be filtered by category and price. Products can be sorted by Walmart-recommended item priorities. Searched using wildcards matching the product name and SKU.

Example

<?php
use Walmart\Configuration;
use Walmart\Enums\Country;
use Walmart\Walmart;

require_once __DIR__ . '/vendor/autoload.php';

$config = new Walmart\Configuration([
    'clientId' => 'CLIENT_ID',          // May not be necessary for all endpoints, particularly outside the US
    'clientSecret' => 'CLIENT_SECRET',  // Ditto above
    'country' => Country::US,           // Default Country::US if not set
]);

$api = Walmart::marketplace($config)->reviews();

$scrollId = '*'; // string | Optional parameter specifying the scrollId to return the next set of results.
$getIrpItemsRequest = {"filter":{"itemStatus":"ELIGIBLE"}}; // \Walmart\Models\MP\US\Reviews\GetIrpItemsRequest | Request payload

try {
    $result = $api->getIrpItems($scrollId, $getIrpItemsRequest);
    print_r($result);
} catch (Exception $e) {
    echo "Exception when calling ReviewsApi->getIrpItems: {$e->getMessage()}\n";
}

Parameters

Name Type Description Notes
scrollId string Optional parameter specifying the scrollId to return the next set of results. [default to '*']
getIrpItemsRequest \Walmart\Models\MP\US\Reviews\GetIrpItemsRequest Request payload

Return type

\Walmart\Models\MP\US\Reviews\GetIrpItemsResponse

Authorization

This endpoint requires the following authorization methods:

  • accessToken: Header authentication with a Walmart access token, which is automatically generated using your Client ID and Client Secret. The token is valid for 15 minutes, and will be passed in the WM_SEC.ACCESS_TOKEN header

See the Authorization section of the README for more information.

[Back to top] [Back to API list] [Back to Model list] [Back to README]