This is an old revision of the document!
Table of Contents
uMarketplace General API
Get list of Vendors (possible to filter)
In order to get list of vendors perform /V1/udapi/vendors GET API call. It expect searchCriteria as parameter. More details on how to construct the filter check can be found here http://devdocs.magento.com/guides/v2.1/rest/performing-searches.html
Get Single Vendor Info
In order to get single Vendor information perform /V1/udapi/vendor/info/:id GET API call. :id parameter could be either vendor entity id or his name.
Get list of Vendor Products (possible to filter)
In order to get list of vendors products perform /V1/udapi/products/:id GET API call. :id parameter could be either vendor entity id or his name. It expect searchCriteria as parameter. More details on how to construct the filter check can be found here http://devdocs.magento.com/guides/v2.1/rest/performing-searches.html
Get vendor reviews (possible to filter)
In order to get vendor reviews perform /V1/udapi/vendor/reviews/:id GET API call. :id parameter could be either vendor entity id or his name. It expect searchCriteria as parameter. More details on how to construct the filter check can be found here http://devdocs.magento.com/guides/v2.1/rest/performing-searches.html
Example:
GET http://magento.loc/rest/V1/udapi/vendor/reviews/1?searchCriteria=[]
RESPONSE
{
"items": [
{
"detail": "000000003 v1 desc",
"nickname": "Veronica",
"created_at": "2019-11-01 07:22:19",
"rating_votes": [
{
"rating_code": "Shipping and handling charges",
"is_aggregate": 1,
"percent": 60,
"value": 3
},
{
"rating_code": "Communication",
"is_aggregate": 1,
"percent": 80,
"value": 4
},
{
"rating_code": "Shipping time",
"is_aggregate": 1,
"percent": 80,
"value": 4
},
{
"rating_code": "Was delivery on time?",
"is_aggregate": 0,
"percent": 0,
"value": 0
},
{
"rating_code": "Merchandise in good condition?",
"is_aggregate": 0,
"percent": 20,
"value": 1
}
]
},
{
"detail": "000000006 v1 desc",
"nickname": "Veronica",
"created_at": "2019-11-01 07:22:53",
"rating_votes": [
{
"rating_code": "Shipping time",
"is_aggregate": 1,
"percent": 100,
"value": 5
},
{
"rating_code": "Shipping and handling charges",
"is_aggregate": 1,
"percent": 100,
"value": 5
},
{
"rating_code": "Communication",
"is_aggregate": 1,
"percent": 80,
"value": 4
},
{
"rating_code": "Was delivery on time?",
"is_aggregate": 0,
"percent": 20,
"value": 1
},
{
"rating_code": "Merchandise in good condition?",
"is_aggregate": 0,
"percent": 20,
"value": 1
}
]
}
]
}
Get product offers from multiple vendors
In order to get offers from multiple vendors perform /V1/udapi/vendor/product-offers/:sku GET API call. :sku parameter should be product's sku.
Example:
GET http://magento.loc/rest/V1/udapi/vendor/product-offers/24-WB04
RESPONSE
{
"items": [
{
"vendor_product_id": 14,
"vendor_id": 1,
"product_id": 14,
"priority": 1,
"vendor_sku": "v1-24-WB04",
"vendor_cost": null,
"stock_qty": 22,
"backorders": -1,
"status": 1,
"shipping_price": null,
"vendor_title": null,
"state": "new",
"state_descr": null,
"freeshipping": 0,
"vendor_price": 46.77,
"special_price": null,
"special_from_date": null,
"special_to_date": null
},
{
"vendor_product_id": 2061,
"vendor_id": 2,
"product_id": 14,
"priority": 2,
"vendor_sku": "v2-24-WB04",
"vendor_cost": null,
"stock_qty": 33,
"backorders": -1,
"status": 1,
"shipping_price": null,
"vendor_title": null,
"state": "new",
"state_descr": null,
"freeshipping": 0,
"vendor_price": 49.27,
"special_price": null,
"special_from_date": null,
"special_to_date": null
}
],
"search_criteria": null,
"total_count": 2
}
Get product questions to vendors (possible to filter)
In order to get product questions to vendors perform /V1/udapi/vendor/product-questions/:sku GET API call. :sku parameter should be product's sku. It expect searchCriteria as parameter. More details on how to construct the filter check can be found here http://devdocs.magento.com/guides/v2.1/rest/performing-searches.html
Example:
GET http://magento233.loc/rest/V1/udapi/vendor/product-questions/24-WB07?searchCriteria=[]
RESPONSE
{
"items": [
{
"question_text": "question 1",
"answer_text": "answer 1",
"customer_name": "test 1",
"vendor_id": 1,
"vendor_name": "vendor1",
"visibility": 1,
"question_date": "2019-11-01 09:32:18",
"answer_date": "2019-11-01 09:36:47"
},
{
"question_text": "question 2",
"answer_text": "answer 2",
"customer_name": "test 2",
"vendor_id": 2,
"vendor_name": "vendor2",
"visibility": 1,
"question_date": "2019-11-01 09:35:34",
"answer_date": "2019-11-01 09:36:30"
},
{
"question_text": "question 3",
"answer_text": "answer 3",
"customer_name": "test 3",
"vendor_id": 1,
"vendor_name": "vendor1",
"visibility": 1,
"question_date": "2019-11-01 09:35:54",
"answer_date": "2019-11-01 09:36:38"
}
]
}
Ask product question to vendor
In order to create new question to vendors perform /V1/udapi/vendor/product-question-ask/:id/:sku POST API call. :id parameter could be either vendor entity id or his name. :sku parameter should be product's sku. Other parameters are: name - customer name, question - question text, visibility - 0 / Private or 1 / Public
