| Requires any of the roles: | bookingsupplier-administrator-write, superadmin |
| POST | /tags | Create a new tag | Creates a new tag for the company. |
|---|
import 'package:servicestack/servicestack.dart';
class TagResponse implements IConvertible
{
int Id = 0;
String CompanyId = "";
String Name = "";
int Scope = 0;
String Color = "";
int SortOrder = 0;
bool Active;
DateTime CreatedDate = DateTime(0);
ResponseStatus ResponseStatus;
TagResponse({this.Id,this.CompanyId,this.Name,this.Scope,this.Color,this.SortOrder,this.Active,this.CreatedDate,this.ResponseStatus});
TagResponse.fromJson(Map<String, dynamic> json) { fromMap(json); }
fromMap(Map<String, dynamic> json) {
Id = json['Id'];
CompanyId = json['CompanyId'];
Name = json['Name'];
Scope = json['Scope'];
Color = json['Color'];
SortOrder = json['SortOrder'];
Active = json['Active'];
CreatedDate = JsonConverters.fromJson(json['CreatedDate'],'DateTime',context!);
ResponseStatus = JsonConverters.fromJson(json['ResponseStatus'],'ResponseStatus',context!);
return this;
}
Map<String, dynamic> toJson() => {
'Id': Id,
'CompanyId': CompanyId,
'Name': Name,
'Scope': Scope,
'Color': Color,
'SortOrder': SortOrder,
'Active': Active,
'CreatedDate': JsonConverters.toJson(CreatedDate,'DateTime',context!),
'ResponseStatus': JsonConverters.toJson(ResponseStatus,'ResponseStatus',context!)
};
getTypeName() => "TagResponse";
TypeContext? context = _ctx;
}
enum TagScope
{
Booking,
Customer,
}
// @ApiResponse(Description="Returned if there is a validation error on the input parameters", StatusCode=400)
// @ApiResponse(Description="Returned if the current user is not allowed to perform the action", StatusCode=401)
// @ValidateRequest(Validator="IsAuthenticated")
class CreateTag 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.")
String? CompanyId;
/**
* The tag name.
*/
// @ApiMember(Description="The tag name.", IsRequired=true)
String Name = "";
/**
* The scope this tag applies to. 0 = Booking, 1 = Customer.
*/
// @ApiMember(Description="The scope this tag applies to. 0 = Booking, 1 = Customer.", IsRequired=true)
TagScope Scope;
/**
* The display color for the tag, e.g. '#FF5733' or 'red'.
*/
// @ApiMember(Description="The display color for the tag, e.g. '#FF5733' or 'red'.")
String Color = "";
/**
* The sort order for the tag.
*/
// @ApiMember(Description="The sort order for the tag.")
int SortOrder = 0;
CreateTag({this.CompanyId,this.Name,this.Scope,this.Color,this.SortOrder});
CreateTag.fromJson(Map<String, dynamic> json) { fromMap(json); }
fromMap(Map<String, dynamic> json) {
CompanyId = json['CompanyId'];
Name = json['Name'];
Scope = JsonConverters.fromJson(json['Scope'],'TagScope',context!);
Color = json['Color'];
SortOrder = json['SortOrder'];
return this;
}
Map<String, dynamic> toJson() => {
'CompanyId': CompanyId,
'Name': Name,
'Scope': JsonConverters.toJson(Scope,'TagScope',context!),
'Color': Color,
'SortOrder': SortOrder
};
getTypeName() => "CreateTag";
TypeContext? context = _ctx;
}
TypeContext _ctx = TypeContext(library: 'api.bookmore.com', types: <String, TypeInfo> {
'TagResponse': TypeInfo(TypeOf.Class, create:() => TagResponse()),
'TagScope': TypeInfo(TypeOf.Enum, enumValues:TagScope.values),
'CreateTag': TypeInfo(TypeOf.Class, create:() => CreateTag()),
});
To override the Content-type in your clients, use the HTTP Accept Header, append the .csv suffix or ?format=csv
The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.
POST /tags HTTP/1.1
Host: api.bookmore.com
Accept: text/csv
Content-Type: text/csv
Content-Length: length
{"CompanyId":"00000000-0000-0000-0000-000000000000","Name":"String","Scope":"Booking","Color":"String","SortOrder":0}
HTTP/1.1 200 OK
Content-Type: text/csv
Content-Length: length
{"Id":0,"Name":"String","Scope":0,"Color":"String","SortOrder":0,"Active":false,"ResponseStatus":{"ErrorCode":"String","Message":"String","StackTrace":"String","Errors":[{"ErrorCode":"String","FieldName":"String","Message":"String","Meta":{"String":"String"}}],"Meta":{"String":"String"}}}