BokaMera.API.Host

<back to all web services

CreateIncentiveAction

Requires Authentication
Requires the role:superadmin
The following routes are available for this service:
POST/superadmin/incentives/actionAdd a new incentive action
CreateIncentiveAction Parameters:
NameParameterData TypeRequiredDescription
IdbodyintNo
ActionTypebodyIncentiveActionTypeNo
DescriptionbodystringNo
PagebodystringNo
SegmentbodystringNo
ElementbodystringNo
LicenseTypeIdbodyint?No
IncentiveActionType Enum:
NameValue
Upgrade1
AddOn2
Information3
IncentiveActionResponse Parameters:
NameParameterData TypeRequiredDescription
IdformintNo
DescriptionformstringNo
ActionTypeformIncentiveActionTypeNo
PageformstringNo
SegmentformstringNo
ElementformstringNo
LicenseTypeIdformint?No
SuggestedLicenseToUpgradeformLicenseTypeQueryResponseNo
LicenseTypeQueryResponse Parameters:
NameParameterData TypeRequiredDescription
IdformintNoThe license type id
NameformstringNoThe license type name
DescriptionformstringNoThe license type description
IsExtraLicenseOptionformboolNoIf the license type is not a standard license but instead an extra license option. An example would be sending new letter license.
PeriodOfNoticeDaysformintNoThe period of notice for the license in days.
ItemsformList<LicenseItemsResponse>NoThe license items for the license type
PricesformList<LicensePrice>NoThe license prices in each country for the license type
LicenseItemsResponse Parameters:
NameParameterData TypeRequiredDescription
IdformintNo
NameformstringNo
AllowedItemsformintNo
LicensePrice Parameters:
NameParameterData TypeRequiredDescription
CountryformCountryNo
MonthlyPaymentformboolNo
LicenseTypeIdformintYes
CountryIdformstringYes
PriceformintYes
ModifiedDateformDateTimeOffset?No
Country Parameters:
NameParameterData TypeRequiredDescription
CurrencyIdformstringNo
CurrencyInfoformCurrencyNo
NameformstringYes
CultureformstringNo
TimeZoneformstringNo
ModifiedDateformDateTimeOffset?No
IdformstringYes
Currency Parameters:
NameParameterData TypeRequiredDescription
NameformstringYes
CurrencySignformstringYes
ActiveformboolYes
ModifiedDateformDateTimeOffset?No
IdformstringYes

To override the Content-type in your clients, use the HTTP Accept Header, append the .jsv suffix or ?format=jsv

HTTP + JSV

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

POST /superadmin/incentives/action HTTP/1.1 
Host: api.bokamera.se 
Accept: text/jsv
Content-Type: text/jsv
Content-Length: length

{
	Id: 0,
	ActionType: Upgrade,
	Description: String,
	Page: String,
	Segment: String,
	Element: String,
	LicenseTypeId: 0
}
HTTP/1.1 200 OK
Content-Type: text/jsv
Content-Length: length

{
	Id: 0,
	Description: String,
	ActionType: Upgrade,
	Page: String,
	Segment: String,
	Element: String,
	LicenseTypeId: 0,
	SuggestedLicenseToUpgrade: 
	{
		Id: 0,
		Name: String,
		Description: String,
		IsExtraLicenseOption: False,
		PeriodOfNoticeDays: 0,
		Items: 
		[
			{
				Id: 0,
				Name: String,
				AllowedItems: 0
			}
		],
		Prices: 
		[
			{
				Country: 
				{
					CurrencyId: String,
					CurrencyInfo: 
					{
						Name: String,
						CurrencySign: String,
						Active: False,
						ModifiedDate: 0001-01-01T00:00:00.0000000+00:00,
						Id: String
					},
					Name: String,
					Culture: String,
					TimeZone: String,
					ModifiedDate: 0001-01-01T00:00:00.0000000+00:00,
					Id: String
				},
				MonthlyPayment: True,
				LicenseTypeId: 0,
				CountryId: String,
				Price: 0,
				ModifiedDate: 0001-01-01T00:00:00.0000000+00:00
			}
		]
	}
}