APS Edit Wizard data manager
In this document:
The considered APS type (download
)
extends the Resource APS type(s) and looks as follows:
{
"name": "EditWizardManager",
"id": "http://odin.com/edit-wizard/edit-wizard-management/1.4",
"apsVersion": "2.0",
"implements": [
"http://aps-standard.org/types/core/resource/1.0"
],
"operations": {
"parseVendorConfiguration": {
"path": "/parseVendorConfiguration/{appId}",
"verb": "POST",
"response": {
"type": "object"
},
"errorResponse": {
"type": "object"
},
"parameters": {
"appId": {
"kind": "path",
"type": "string"
}
}
},
"applyWizardData": {
"path": "/applyWizardData/{appId}",
"verb": "POST",
"response": {
"type": "object"
},
"errorResponse": {
"type": "object"
},
"parameters": {
"appId": {
"kind": "path",
"type": "string"
}
}
},
"checkWizardData": {
"path": "/checkWizardData",
"verb": "POST",
"response": {
"type": "object"
},
"errorResponse": {
"type": "object"
}
},
"getWizardData": {
"path": "/getWizardData/{appId}",
"verb": "GET",
"response": {
"type": "object"
},
"errorResponse": {
"type": "object"
},
"parameters": {
"appId": {
"kind": "path",
"type": "string"
}
}
},
"getServicePlans": {
"path": "/getServicePlans",
"verb": "GET",
"response": {
"type": "object"
},
"errorResponse": {
"type": "object"
},
"parameters": {
"serviceTemplates": {
"kind": "query",
"type": "string"
}
}
},
"getDetailedServicePlans": {
"path": "/getDetailedServicePlans",
"verb": "GET",
"response": {
"type": "object"
},
"errorResponse": {
"type": "object"
},
"parameters": {
"servicePlans": {
"kind": "query",
"type": "string"
}
}
},
"getServicePlansList": {
"path": "/getServicePlansList",
"verb": "GET",
"response": {
"type": "array",
"items": {
"type": "GetServicePlanBasic"
}
},
"errorResponse": {
"type": "object"
},
"parameters": {
"serviceTemplates": {
"kind": "query",
"type": "string"
}
}
},
"getResourceRates": {
"path": "/getResourceRates",
"verb": "GET",
"response": {
"type": "object"
},
"errorResponse": {
"type": "object"
},
"parameters": {
"servicePlan": {
"kind": "query",
"type": "string"
}
}
},
"getBillingData": {
"path": "/getBillingData",
"verb": "GET",
"response": {
"type": "object"
},
"errorResponse": {
"type": "object"
},
"parameters": {
"resellers": {
"kind": "query",
"type": "string"
},
"serviceTemplateIds": {
"kind": "query",
"type": "string"
}
}
}
},
"structures": {
"GetPlanCategory": {
"type": "object",
"properties": {
"id": {
"type": "integer"
},
"name": {
"type": "string"
},
"description": {
"type": "string"
}
}
},
"GetServicePlanBasic": {
"type": "object",
"properties": {
"id": {
"type": "integer"
},
"originalEnName": {
"type": "string"
},
"name": {
"type": "object"
},
"planCategory": {
"type": "GetPlanCategory"
},
"vendorId": {
"type": "integer"
},
"serviceTemplateId": {
"type": "integer"
},
"isAvailableForSale": {
"type": "boolean"
},
"billingPeriodType": {
"type": "integer"
},
"billingPeriod": {
"type": "integer"
},
"isEnableVolumePricingModel": {
"type": "boolean"
}
}
}
}
}
OPERATION |
VERB |
PATH |
RETURNS |
Description |
---|---|---|---|---|
POST |
/parseVendorConfiguration/{appId} |
“parseVendorConfiguration” custom operation (POST) |
||
POST |
/applyWizardData/{appId} |
“applyWizardData” custom operation (POST) |
||
POST |
/checkWizardData |
“checkWizardData” custom operation (GET) Though HTTP method used is POST (to send a payload), the method just validates ConfSync mappings indeed. |
||
GET |
/getWizardData/{appId} |
Response. |
“getWizardData” custom operation (GET) return AIW WD |
|
GET |
/getServicePlans |
Service plans list |
Return service plans for given service templates |
|
GET |
/getDetailedServicePlans |
Service plans list |
Return detailed service plan info for given ids |
|
GET |
/getServicePlansList |
Service plans list |
Return service plans for given service templates |
|
GET |
/getResourceRates |
Resource rates for given service plans |
Return resource rates for given service plans |
|
GET |
/getBillingData |
Billing specific data |
Return billing specific data |
HTTP Request
POST /aps/2/resources/{aps-id}/parseVendorConfiguration/{appId}
Description
“parseVendorConfiguration” custom operation (POST)
Parameters
PARAMETER |
TYPE |
DESCRIPTION |
---|---|---|
appId |
String |
Returns
HTTP Request
POST /aps/2/resources/{aps-id}/applyWizardData/{appId}
Description
“applyWizardData” custom operation (POST)
Parameters
PARAMETER |
TYPE |
DESCRIPTION |
---|---|---|
appId |
String |
Returns
HTTP Request
POST /aps/2/resources/{aps-id}/checkWizardData
Description
“checkWizardData” custom operation (GET) Though HTTP method used is POST (to send a payload), the method just validates ConfSync mappings indeed.
Returns
HTTP Request
GET /aps/2/resources/{aps-id}/getWizardData/{appId}
Description
“getWizardData” custom operation (GET) return AIW WD
Parameters
PARAMETER |
TYPE |
DESCRIPTION |
---|---|---|
appId |
String |
Returns
Response.
HTTP Request
GET /aps/2/resources/{aps-id}/getServicePlans
Description
Return service plans for given service templates
Parameters
PARAMETER |
TYPE |
DESCRIPTION |
---|---|---|
serviceTemplates |
String |
List of service templates ids |
Returns
Service plans list
HTTP Request
GET /aps/2/resources/{aps-id}/getDetailedServicePlans
Description
Return detailed service plan info for given ids
Parameters
PARAMETER |
TYPE |
DESCRIPTION |
---|---|---|
servicePlans |
String |
Returns
Service plans list
HTTP Request
GET /aps/2/resources/{aps-id}/getServicePlansList
Description
Return service plans for given service templates
Parameters
PARAMETER |
TYPE |
DESCRIPTION |
---|---|---|
serviceTemplates |
String |
List of service templates ids |
Returns
Service plans list
HTTP Request
GET /aps/2/resources/{aps-id}/getResourceRates
Description
Return resource rates for given service plans
Parameters
PARAMETER |
TYPE |
DESCRIPTION |
---|---|---|
servicePlan |
String |
Returns
Resource rates for given service plans
HTTP Request
GET /aps/2/resources/{aps-id}/getBillingData
Description
Return billing specific data
Parameters
PARAMETER |
TYPE |
DESCRIPTION |
---|---|---|
resellers |
String |
List of resellers ids |
serviceTemplateIds |
String |
Returns
Billing specific data
Every service plan must be bound to a plan category.
NAME |
TYPE |
ATTRIBUTES |
DEFAULT |
DESCRIPTION |
---|---|---|---|---|
id |
Integer |
Not Required |
Plan category ID in the platform. |
|
name |
String |
Not Required |
Name.. |
|
description |
String |
Not Required |
Description.. |
Service plans are the main products used to sell application services.
NAME |
TYPE |
ATTRIBUTES |
DEFAULT |
DESCRIPTION |
---|---|---|---|---|
id |
Integer |
Not Required |
A digital ID unique in scope of the wizard data. For the sake of reliability, assign a negative digit to avoid confusion with an ID of a service plan existing in the platform. The platform will assign a unique ID when creating the required service plan. |
|
originalEnName |
String |
Not Required |
||
name |
Object |
Not Required |
Name.. |
|
planCategory |
Not Required |
|||
vendorId |
Integer |
Not Required |
Service plan vendor internal ID. |
|
serviceTemplateId |
Integer |
Not Required |
The ID of the service template the service plan is based on. |
|
isAvailableForSale |
Boolean |
Not Required |
||
billingPeriodType |
Integer |
Not Required |
||
billingPeriod |
Integer |
Not Required |
||
isEnableVolumePricingModel |
Boolean |
Not Required |
Since the considered APS type contains custom operations, refer to Custom Operations for the general explanation of their structure and examples of operation calls.