GET | /services/{ServiceId}/nextfreetime | Get the next available time for the service | Get the next available time for the service |
---|
import datetime
import decimal
from marshmallow.fields import *
from servicestack import *
from typing import *
from dataclasses import dataclass, field
from dataclasses_json import dataclass_json, LetterCase, Undefined, config
from enum import Enum, IntEnum
@dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE)
@dataclass
class ExceptionText:
reason: Optional[str] = None
reason_public: Optional[str] = None
@dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE)
@dataclass
class AvailableTimesSum(IAvailableTime):
from_: datetime.datetime = field(metadata=config(field_name='from'), default=datetime.datetime(1, 1, 1))
to: datetime.datetime = datetime.datetime(1, 1, 1)
free: int = 0
free_spots: int = 0
exception_texts: Optional[List[ExceptionText]] = None
@dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE)
@dataclass
class AvailableTimesResponse:
company_id: Optional[str] = None
service_id: int = 0
times_free_text_single: Optional[str] = None
times_free_text_multiple: Optional[str] = None
times: Optional[List[AvailableTimesSum]] = None
@dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE)
@dataclass
class AvailableTimesResourceTypeResource:
# @ApiMember(Description="The resourcetype id")
resource_type_id: int = 0
"""
The resourcetype id
"""
# @ApiMember(Description="The resource id")
resource_id: int = 0
"""
The resource id
"""
@dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE)
@dataclass
class NextFreeTimeQuery(IInterval):
# @ApiMember(Description="Company to show available time for", ParameterType="query")
company_id: Optional[str] = None
"""
Company to show available time for
"""
# @ApiMember(Description="Service id", IsRequired=true, ParameterType="path")
service_id: int = 0
"""
Service id
"""
# @ApiMember(DataType="dateTime", Description="From what datetime to search available times", IsRequired=true, ParameterType="query")
from_: datetime.datetime = field(metadata=config(field_name='from'), default=datetime.datetime(1, 1, 1))
"""
From what datetime to search available times
"""
# @ApiMember(DataType="dateTime", Description="To what datetime to show available times. Optional, if no datetime is set it will search one year", IsRequired=true, ParameterType="query")
to: datetime.datetime = datetime.datetime(1, 1, 1)
"""
To what datetime to show available times. Optional, if no datetime is set it will search one year
"""
# @ApiMember(Description="Here you can select one of the resource in each resource type connected to the service, if none is selected it will show available times for all", ParameterType="query")
resources: Optional[List[AvailableTimesResourceTypeResource]] = None
"""
Here you can select one of the resource in each resource type connected to the service, if none is selected it will show available times for all
"""
# @ApiMember(Description="Here you select number of resources to book (in each resource type). Default is 1.", ParameterType="query")
number_of_resources: int = 0
"""
Here you select number of resources to book (in each resource type). Default is 1.
"""
# @ApiMember(DataType="bool", Description="The duration you want to book. Needs to withing the service Min and Max. If not set it will use the service duration", ParameterType="query")
duration: Optional[int] = None
"""
The duration you want to book. Needs to withing the service Min and Max. If not set it will use the service duration
"""
# @ApiMember(Description="If you want to include the connected resource types and resources", ParameterType="query")
show_per_resource: bool = False
"""
If you want to include the connected resource types and resources
"""
To override the Content-type in your clients, use the HTTP Accept Header, append the .jsv suffix or ?format=jsv
The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.
GET /services/{ServiceId}/nextfreetime HTTP/1.1 Host: api.bokamera.se Accept: text/jsv
HTTP/1.1 200 OK Content-Type: text/jsv Content-Length: length { ServiceId: 0, TimesFreeTextSingle: String, TimesFreeTextMultiple: String, Times: [ { Free: 0, FreeSpots: 0 } ] }