1 Summary 2 Architecture design 2.1 Component diagram 2.2 Integration diagram 3 Environment 3.1 Development 3.1.1 CloudSocket Marketplace front-end 3.2 Production 4 Test Cases 5 API specification 5.1 Product API 5.1.1 url: http://csmarket.ymens.com:5050/api/product 5.1.2 authorization method: Header - OAuth2 authorization token 5.1.3 JSON sample 5.2 Category API 5.2.1 url: http://csmarket.ymens.com:5050/api/category 5.2.2 authorization method: Header - OAuth2 authorization token 5.2.3 JSON sample 5.3 Order API 5.3.1 url: http://csmarket.ymens.com:5050/api/order 5.3.2 authorization method: Header - OAuth2 authorization token 5.3.3 JSON sample

Summary

The Marketplace’s role is to link the Allocation to the Execution, giving the client the opportunity to buy and configure the BPaaS bundles received from the Allocation and to send the configured bundles to the Execution for provisioning.

CloudSocket Marketplace provides a collection of REST APIs in order in ensure connection and operability inside CloudSocket concept. CloudSocket is secured by YIDPB (Ymens Identity Provider Broker). YIDPB is build around three standards, OpenIDConnect for authentication, OAuth2 for authorization and SCIM 2 for user profile.

Architecture design

Component diagram

Integration diagram

Environment

Development

CloudSocket Marketplace front-end

http://csmarket.ymens.com:8080

Production

N/A

Test Cases

API specification

Product API

url: http://csmarket.ymens.com:5050/api/product

authorization method: Header - OAuth2 authorization token

JSON sample

{
 "businessProcessSection" : {
   "businessProcess" : {
     "resourcePath" : "business-process/business-process.bpmn"
   },
   "image" : {
     "resourcePath" : "business-process/business-process.jpg"
   }
 },
 "deploymentSection" : {
   "deploymentPlan" : {
     "resourcePath" : "deployment.camel"
   }
 },
 "marketplaceSection" : {
   "businessDescription" : "This is a business description of the BPaaS Bundle.",
   "category" : {
     "name" : "Christmas Greetings",
     "parent" : {
       "name" : "Greetings"
     }
   },
   "icon" : {
     "resourcePath" : "images/icon.png"
   },
   "pictureList" : [ {
     "resourcePath" : "images/picture1.png"
   }, {
     "resourcePath" : "images/picture2.png"
   } ],
   "pricing" : {
     "formula" : "10",
     "frequency" : "MONTHLY",
     "currency" : "EURO",
     "description" : "This is the Pricing natural language description (e.g. 10€ per month)."
   },
   "seller" : {
     "organization" : "BrokerOrganization SRL",
     "name" : "Mario Rossi"
   },
   "serviceLevelAgreement" : {
     "description" : "This is the SLA natural language description."
   },
   "tagList" : [ "christmas", "xmas", "greetings" ],
   "technicalDescription" : "This is a technical description of the BPaaS Bundle.",
   "title" : "Christmas Card Greetings Bundle v1.0"
 },
 "workflowSection" : {
   "image" : {
     "resourcePath" : "workflow/workflow.jpg"
   },
   "workflow" : {
     "resourcePath" : "workflow/workflow.bpmn"
   }
 }
}

Category API

url: http://csmarket.ymens.com:5050/api/category

authorization method: Header - OAuth2 authorization token

JSON sample

{
   "name": "",
   "description": "",
   "parent": {}
}

Order API

url: http://csmarket.ymens.com:5050/api/order

authorization method: Header - OAuth2 authorization token

JSON sample

{
   "description": "...",
   "status":"PROCESSING/INSTALLED/FAILED",
   "createdDate":"",
   "completedDate":"",
   "customer":{}
}