| PUT | /widget/configuration/{Id} | Update a widget configuration | Updates an existing widget configuration. The Configuration JSON is re-validated against the schema for SchemaVersion. |
|---|
Imports System
Imports System.IO
Imports System.Collections
Imports System.Collections.Generic
Imports System.Runtime.Serialization
Imports ServiceStack
Imports ServiceStack.DataAnnotations
Imports BokaMera.API.ServiceModel.Dtos
Namespace Global
Namespace BokaMera.API.ServiceModel.Dtos
<ApiResponse(Description:="Returned if there is a validation error on the input parameters", StatusCode:=400)>
<ApiResponse(Description:="Returned if the configuration was not found", StatusCode:=404)>
<ApiResponse(Description:="Returned if the current user is not allowed to perform the action", StatusCode:=401)>
<ValidateRequest(Validator:="IsAuthenticated")>
Public Partial Class UpdateWidgetConfiguration
Implements ICompany
'''<Summary>
'''The company id, if empty will use the company id for the user you are logged in with.
'''</Summary>
<ApiMember(Description:="The company id, if empty will use the company id for the user you are logged in with.")>
Public Overridable Property CompanyId As Guid? Implements ICompany.CompanyId
'''<Summary>
'''The widget configuration id (6-character NanoID).
'''</Summary>
<ApiMember(Description:="The widget configuration id (6-character NanoID).", IsRequired:=true, ParameterType:="path")>
Public Overridable Property Id As String
'''<Summary>
'''The widget configuration name.
'''</Summary>
<ApiMember(Description:="The widget configuration name.", IsRequired:=true)>
Public Overridable Property Name As String
'''<Summary>
'''Optional slug (URL-friendly identifier). The API will append the last 3 characters of the company ID. Example: 'hairsalon' becomes 'hairsalon-001'.
'''</Summary>
<ApiMember(Description:="Optional slug (URL-friendly identifier). The API will append the last 3 characters of the company ID. Example: 'hairsalon' becomes 'hairsalon-001'.")>
Public Overridable Property Slug As String
'''<Summary>
'''Optional description.
'''</Summary>
<ApiMember(Description:="Optional description.")>
Public Overridable Property Description As String
'''<Summary>
'''The widget configuration as a JSON string. Must validate against the schema for SchemaVersion.
'''</Summary>
<ApiMember(Description:="The widget configuration as a JSON string. Must validate against the schema for SchemaVersion.", IsRequired:=true)>
Public Overridable Property Configuration As String
'''<Summary>
'''Version of the configuration schema this Configuration adheres to.
'''</Summary>
<ApiMember(Description:="Version of the configuration schema this Configuration adheres to.", IsRequired:=true)>
Public Overridable Property SchemaVersion As Integer
End Class
Public Partial Class WidgetConfigurationResponse
Public Overridable Property Id As String
Public Overridable Property CompanyId As Guid
Public Overridable Property Name As String
Public Overridable Property Slug As String
Public Overridable Property Description As String
Public Overridable Property Configuration As String
Public Overridable Property SchemaVersion As Integer
Public Overridable Property CreatedDate As Date
Public Overridable Property UpdatedDate As DateTimeOffset?
Public Overridable Property ResponseStatus As ResponseStatus
End Class
End Namespace
End Namespace
VB.NET UpdateWidgetConfiguration DTOs
To override the Content-type in your clients, use the HTTP Accept Header, append the .xml suffix or ?format=xml
The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.
PUT /widget/configuration/{Id} HTTP/1.1
Host: testapi.bokamera.se
Accept: application/xml
Content-Type: application/xml
Content-Length: length
<UpdateWidgetConfiguration xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/BokaMera.API.ServiceModel.Dtos">
<CompanyId>00000000-0000-0000-0000-000000000000</CompanyId>
<Configuration>String</Configuration>
<Description>String</Description>
<Id>String</Id>
<Name>String</Name>
<SchemaVersion>0</SchemaVersion>
<Slug>String</Slug>
</UpdateWidgetConfiguration>
HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: length
<WidgetConfigurationResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/BokaMera.API.ServiceModel.Dtos">
<CompanyId>00000000-0000-0000-0000-000000000000</CompanyId>
<Configuration>String</Configuration>
<CreatedDate>0001-01-01T00:00:00</CreatedDate>
<Description>String</Description>
<Id>String</Id>
<Name>String</Name>
<ResponseStatus xmlns:d2p1="http://schemas.servicestack.net/types">
<d2p1:ErrorCode>String</d2p1:ErrorCode>
<d2p1:Message>String</d2p1:Message>
<d2p1:StackTrace>String</d2p1:StackTrace>
<d2p1:Errors>
<d2p1:ResponseError>
<d2p1:ErrorCode>String</d2p1:ErrorCode>
<d2p1:FieldName>String</d2p1:FieldName>
<d2p1:Message>String</d2p1:Message>
<d2p1:Meta xmlns:d5p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
<d5p1:KeyValueOfstringstring>
<d5p1:Key>String</d5p1:Key>
<d5p1:Value>String</d5p1:Value>
</d5p1:KeyValueOfstringstring>
</d2p1:Meta>
</d2p1:ResponseError>
</d2p1:Errors>
<d2p1:Meta xmlns:d3p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
<d3p1:KeyValueOfstringstring>
<d3p1:Key>String</d3p1:Key>
<d3p1:Value>String</d3p1:Value>
</d3p1:KeyValueOfstringstring>
</d2p1:Meta>
</ResponseStatus>
<SchemaVersion>0</SchemaVersion>
<Slug>String</Slug>
<UpdatedDate xmlns:d2p1="http://schemas.datacontract.org/2004/07/System">
<d2p1:DateTime>0001-01-01T00:00:00Z</d2p1:DateTime>
<d2p1:OffsetMinutes>0</d2p1:OffsetMinutes>
</UpdatedDate>
</WidgetConfigurationResponse>