BokaMera.API.Host

<back to all web services

CreateWidgetConfigurationSchema

Requires Authentication
Requires the role:superadmin
The following routes are available for this service:
POST/widget/configurationschemaCreate a widget configuration schemaCreates a new schema. SuperAdmin only. Schemas are global and immutable: there is no PUT or DELETE.
import java.math.*
import java.util.*
import java.io.InputStream
import net.servicestack.client.*


@ApiResponse(Description="Returned if there is a validation error or the schema is invalid JSON Schema", StatusCode=400)
// @ApiResponse(Description="Returned if a schema with this Version already exists", StatusCode=409)
// @ApiResponse(Description="Returned if the current user is not a SuperAdmin", StatusCode=401)
@ValidateRequest(Validator="IsAuthenticated")
open class CreateWidgetConfigurationSchema
{
    /**
    * The schema version. Must be unique.
    */
    @ApiMember(Description="The schema version. Must be unique.", IsRequired=true)
    open var Version:Int? = null

    /**
    * The JSON Schema document.
    */
    @ApiMember(Description="The JSON Schema document.", IsRequired=true)
    open var Schema:HashMap<String,Object> = HashMap<String,Object>()
}

open class WidgetConfigurationSchemaResponse
{
    open var Id:Int? = null
    open var Version:Int? = null
    open var Schema:HashMap<String,Object> = HashMap<String,Object>()
    open var CreatedDate:Date? = null
    open var ResponseStatus:ResponseStatus? = null
}

Kotlin CreateWidgetConfigurationSchema DTOs

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 /widget/configurationschema HTTP/1.1 
Host: testapi.bokamera.se 
Accept: text/jsv
Content-Type: text/jsv
Content-Length: length

{
	Version: 0,
	Schema: 
	{
		String: {}
	}
}
HTTP/1.1 200 OK
Content-Type: text/jsv
Content-Length: length

{
	Id: 0,
	Version: 0,
	Schema: 
	{
		String: {}
	},
	ResponseStatus: 
	{
		ErrorCode: String,
		Message: String,
		StackTrace: String,
		Errors: 
		[
			{
				ErrorCode: String,
				FieldName: String,
				Message: String,
				Meta: 
				{
					String: String
				}
			}
		],
		Meta: 
		{
			String: String
		}
	}
}