BokaMera.API.Host

<back to all web services

CreateWebhookEndpoint

Requires Authentication
Requires any of the roles:bookingsupplier-administrator-write, superadmin
The following routes are available for this service:
POST/webhook/endpointsCreate webhook endpoint
import 'package:servicestack/servicestack.dart';

class WebhookEndpoint implements IConvertible
{
    String? Description;
    String? Url;
    String? Id;
    bool? Disabled;
    List<String>? EventTypes;

    WebhookEndpoint({this.Description,this.Url,this.Id,this.Disabled,this.EventTypes});
    WebhookEndpoint.fromJson(Map<String, dynamic> json) { fromMap(json); }

    fromMap(Map<String, dynamic> json) {
        Description = json['Description'];
        Url = json['Url'];
        Id = json['Id'];
        Disabled = json['Disabled'];
        EventTypes = JsonConverters.fromJson(json['EventTypes'],'List<String>',context!);
        return this;
    }

    Map<String, dynamic> toJson() => {
        'Description': Description,
        'Url': Url,
        'Id': Id,
        'Disabled': Disabled,
        'EventTypes': JsonConverters.toJson(EventTypes,'List<String>',context!)
    };

    getTypeName() => "WebhookEndpoint";
    TypeContext? context = _ctx;
}

// @ApiResponse(Description="You were unauthorized to call this service", StatusCode=401)
// @ValidateRequest(Validator="IsAuthenticated")
class CreateWebhookEndpoint implements ICompany, IConvertible
{
    /**
    * The company id, if empty will use the company id for the user you are logged in with.
    */
    // @ApiMember(Description="The company id, if empty will use the company id for the user you are logged in with.", IsRequired=true, ParameterType="query")
    String? CompanyId;

    /**
    * The webhook endpoint URL.
    */
    // @ApiMember(Description="The webhook endpoint URL.", IsRequired=true)
    Uri? Url;

    /**
    * List of event types. At least one event type is required.
    */
    // @ApiMember(Description="List of event types. At least one event type is required.", IsRequired=true)
    // @Validate(Validator="NotEmpty", ErrorCode="At least one event type is required.")
    List<String>? EventTypes;

    String? Description;
    // @ApiMember()
    bool? Disabled;

    CreateWebhookEndpoint({this.CompanyId,this.Url,this.EventTypes,this.Description,this.Disabled});
    CreateWebhookEndpoint.fromJson(Map<String, dynamic> json) { fromMap(json); }

    fromMap(Map<String, dynamic> json) {
        CompanyId = json['CompanyId'];
        Url = JsonConverters.fromJson(json['Url'],'Uri',context!);
        EventTypes = JsonConverters.fromJson(json['EventTypes'],'List<String>',context!);
        Description = json['Description'];
        Disabled = json['Disabled'];
        return this;
    }

    Map<String, dynamic> toJson() => {
        'CompanyId': CompanyId,
        'Url': JsonConverters.toJson(Url,'Uri',context!),
        'EventTypes': JsonConverters.toJson(EventTypes,'List<String>',context!),
        'Description': Description,
        'Disabled': Disabled
    };

    getTypeName() => "CreateWebhookEndpoint";
    TypeContext? context = _ctx;
}

TypeContext _ctx = TypeContext(library: 'api.bokamera.se', types: <String, TypeInfo> {
    'WebhookEndpoint': TypeInfo(TypeOf.Class, create:() => WebhookEndpoint()),
    'CreateWebhookEndpoint': TypeInfo(TypeOf.Class, create:() => CreateWebhookEndpoint()),
    'Uri': TypeInfo(TypeOf.Class, create:() => Uri()),
});

Dart CreateWebhookEndpoint DTOs

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

HTTP + XML

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

POST /webhook/endpoints HTTP/1.1 
Host: api.bokamera.se 
Accept: application/xml
Content-Type: application/xml
Content-Length: length

<CreateWebhookEndpoint 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>
  <Description>String</Description>
  <Disabled>false</Disabled>
  <EventTypes xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
    <d2p1:string>String</d2p1:string>
  </EventTypes>
  <Url i:nil="true" />
</CreateWebhookEndpoint>
HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: length

<WebhookEndpoint xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/BokaMera.API.ServiceModel.Dtos">
  <Description>String</Description>
  <Disabled>false</Disabled>
  <EventTypes xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
    <d2p1:string>String</d2p1:string>
  </EventTypes>
  <Id>String</Id>
  <Url>String</Url>
</WebhookEndpoint>