MCP 서버

Samuelz Chauffeur Booking

io.github.samuelzcom/chauffeur-booking
여행 및 호스피탈리티 공개 · 연결 가능 MCP 2025-11-25

이 MCP로 할 수 있는 일

Provides chauffeur service options, ride price previews, customer policies, and prepared unpaid offers for transfers or hourly service.

get_customer_policy
Published customer terms
Use after get_service_options and before prepare_offer to retrieve current account, guest-booking and minimum-lead-time rules. Returns observedAt and revalidationRequired: refresh the rules before preparing an offer; no terms-validity window is promised. Review bound waiting and cancellation terms on the current offer before confirmation. On unavailable, report that the rules could not be read; do not invent them. For a price use quote_ride.
읽기 전용 멱등성
입력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'locale': {'enum': ['de', 'en'], 'type': 'string', 'default': 'en', 'description': "Use the customer's requested language for text and booking links: en by default, de for German. Preserve it on retries; pickup times stay in the provider time zone."}, 'offerKey': {'type': 'string', 'pattern': '^[a-z0-9][a-z0-9_-]{0,79}$', 'description': 'Optional existing published provider offer key. Selects its configured service location; not booking authority.'}}, 'additionalProperties': False}
출력 스키마
{'type': 'object', 'oneOf': [{'type': 'object', 'required': ['status'], 'properties': {'status': {'type': 'string', 'const': 'invalid_request'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['status'], 'properties': {'status': {'type': 'string', 'const': 'unavailable'}, 'bookingUrl': {'type': 'string', 'format': 'uri'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['status', 'bookingUrl', 'timeZone', 'observedAt', 'scope', 'revalidationRequired', 'terms', 'bookingConfirmed'], 'properties': {'scope': {'type': 'string', 'const': 'booking_preparation'}, 'terms': {'type': 'object', 'required': ['minimumLeadTimeMinutes', 'accountRequired', 'bookerForGuestAllowed', 'bookingConfirmation', 'serviceSpecificTerms'], 'properties': {'accountRequired': {'type': 'boolean'}, 'bookingConfirmation': {'type': 'string', 'const': 'after_confirmed_full_payment'}, 'serviceSpecificTerms': {'type': 'string', 'const': 'review_the_current_offer_before_confirmation'}, 'bookerForGuestAllowed': {'type': 'boolean'}, 'minimumLeadTimeMinutes': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}}, 'additionalProperties': False}, 'status': {'type': 'string', 'const': 'available'}, 'timeZone': {'type': 'string'}, 'bookingUrl': {'type': 'string', 'format': 'uri'}, 'observedAt': {'type': 'string'}, 'bookingConfirmed': {'type': 'boolean', 'const': False}, 'revalidationRequired': {'type': 'boolean', 'const': True}}, 'additionalProperties': False}], '$schema': 'https://json-schema.org/draft/2020-12/schema'}
get_offer_status
Read prepared offer status
Use to read one existing request with its original submissionId/resumeToken pair within the original 24-hour window. Returns offer state or recorded booking/payment/fulfillment after payment; no pricing call or new business action. For pending, wait retryAfterSeconds and retry that pair. For ambiguous/conflict inspect that intent; not_found denies access and unavailable is not vehicle evidence. Open customerPortalUrl for private login. No locale (original language), history, cancellation or modification.
읽기 전용 멱등성
입력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['submissionId', 'resumeToken'], 'properties': {'resumeToken': {'type': 'string', 'pattern': '^[a-f0-9]{64}$', 'description': 'Private 64-character hexadecimal secret generated for this submission. Reuse its original pair with submissionId for retries and status; never substitute account credentials.'}, 'submissionId': {'type': 'string', 'format': 'uuid', 'pattern': '^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$', 'description': 'Identifies one offer intent. Generate a UUID for a requested new offer; keep it with the same resumeToken for unchanged retries and status.'}}, 'additionalProperties': False}
출력 스키마
{'type': 'object', 'oneOf': [{'type': 'object', 'required': ['status'], 'properties': {'status': {'type': 'string', 'const': 'invalid_request'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['status'], 'properties': {'status': {'type': 'string', 'const': 'unavailable'}, 'bookingUrl': {'type': 'string', 'format': 'uri'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['status', 'retryAfterSeconds'], 'properties': {'status': {'type': 'string', 'const': 'pending'}, 'retryAfterSeconds': {'type': 'integer', 'maximum': 9007199254740991, 'exclusiveMinimum': 0}}, 'additionalProperties': False}, {'type': 'object', 'required': ['status', 'retryAfterSeconds'], 'properties': {'status': {'type': 'string', 'const': 'rate_limited'}, 'retryAfterSeconds': {'type': 'integer', 'maximum': 9007199254740991, 'exclusiveMinimum': 0}}, 'additionalProperties': False}, {'type': 'object', 'required': ['status'], 'properties': {'status': {'enum': ['conflict', 'ambiguous', 'not_found'], 'type': 'string'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['status', 'bookingKey', 'bookingReference', 'booking', 'payment', 'fulfillment', 'customerPortalUrl'], 'properties': {'status': {'type': 'string', 'const': 'available'}, 'booking': {'type': 'object', 'required': ['recordedStatus'], 'properties': {'recordedStatus': {'type': 'string', 'maxLength': 64, 'minLength': 1}}, 'additionalProperties': False}, 'payment': {'type': 'object', 'required': ['recordedStatus'], 'properties': {'recordedStatus': {'type': 'string', 'maxLength': 64, 'minLength': 1}}, 'additionalProperties': False}, 'bookingKey': {'type': 'string', 'maxLength': 128, 'minLength': 1}, 'fulfillment': {'type': 'object', 'required': ['chauffeurAssignmentRecorded', 'vehicleAssignmentRecorded', 'completionRecorded'], 'properties': {'completionRecorded': {'type': 'boolean'}, 'vehicleAssignmentRecorded': {'type': 'boolean'}, 'chauffeurAssignmentRecorded': {'type': 'boolean'}}, 'additionalProperties': False}, 'bookingReference': {'type': 'string', 'minLength': 1}, 'customerPortalUrl': {'type': 'string', 'format': 'uri'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['status', 'bookingUrl', 'message', 'review'], 'properties': {'review': {'type': 'object', 'required': ['code', 'customerContactRequired', 'availabilityConfirmed', 'nextAction'], 'properties': {'code': {'enum': ['additional_requirements_review', 'model_guarantee_review', 'address_review', 'service_scope_review', 'booking_window_review', 'route_review'], 'type': 'string'}, 'nextAction': {'type': 'string', 'const': 'review_requirements'}, 'availabilityConfirmed': {'type': 'boolean', 'const': False}, 'customerContactRequired': {'type': 'boolean', 'const': False}}, 'additionalProperties': False}, 'status': {'type': 'string', 'const': 'review_required'}, 'message': {'type': 'string'}, 'bookingUrl': {'type': 'string', 'format': 'uri'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['status'], 'properties': {'status': {'type': 'string', 'const': 'expired'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['status', 'bookingConfirmed', 'checkoutUrl', 'termsUrl', 'offer', 'nextAction'], 'properties': {'offer': {'type': 'object', 'required': ['currency', 'grossTotalCents', 'expiresAt', 'customerConfirmationRequired', 'completeTermsBound'], 'properties': {'currency': {'type': 'string', 'const': 'EUR'}, 'expiresAt': {'type': 'string'}, 'grossTotalCents': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'completeTermsBound': {'type': 'boolean', 'const': True}, 'customerConfirmationRequired': {'type': 'boolean', 'const': True}}, 'additionalProperties': False}, 'status': {'type': 'string', 'const': 'prepared'}, 'termsUrl': {'type': 'string', 'format': 'uri'}, 'nextAction': {'type': 'string'}, 'checkoutUrl': {'type': 'string', 'format': 'uri'}, 'bookingConfirmed': {'type': 'boolean', 'const': False}, 'customerPortalUrl': {'type': 'string', 'format': 'uri'}}, 'additionalProperties': False}], '$schema': 'https://json-schema.org/draft/2020-12/schema'}
get_service_options
Chauffeur service options
Use first to learn this provider's service scope, required ride facts and local timeZone. Read current published facts; do not assume additional locations. Language defaults to English; pass locale=de for German, without changing timeZone. It gives no price or availability confirmation. Use get_customer_policy for booking rules, quote_ride for a price, or prepare_offer only after an explicit offer request.
읽기 전용 멱등성
입력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'locale': {'enum': ['de', 'en'], 'type': 'string', 'default': 'en', 'description': "Use the customer's requested language for text and booking links: en by default, de for German. Preserve it on retries; pickup times stay in the provider time zone."}, 'offerKey': {'type': 'string', 'pattern': '^[a-z0-9][a-z0-9_-]{0,79}$', 'description': 'Optional existing published provider offer key. Selects its configured service location; not booking authority.'}}, 'additionalProperties': False}
출력 스키마
{'type': 'object', 'oneOf': [{'type': 'object', 'required': ['status'], 'properties': {'status': {'type': 'string', 'const': 'invalid_request'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['status'], 'properties': {'status': {'type': 'string', 'const': 'unavailable'}, 'bookingUrl': {'type': 'string', 'format': 'uri'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['status', 'provider', 'timeZone', 'bookingUrl', 'services', 'requiredRideFacts', 'returnRideFacts', 'hourlyRideFacts', 'nextAction'], 'properties': {'status': {'type': 'string', 'const': 'available'}, 'location': {'type': 'object', 'required': ['key', 'countryCode', 'label'], 'properties': {'key': {'type': 'string'}, 'label': {'type': 'string'}, 'countryCode': {'type': 'string'}}, 'additionalProperties': False}, 'provider': {'type': 'string'}, 'services': {'type': 'array', 'items': {'type': 'object', 'required': ['key', 'tripTypes', 'availability'], 'properties': {'key': {'type': 'string'}, 'tripTypes': {'type': 'array', 'items': {'enum': ['one_way', 'return'], 'type': 'string'}}, 'availability': {'type': 'string', 'const': 'requires_offer_review'}}, 'additionalProperties': False}}, 'timeZone': {'type': 'string'}, 'bookingUrl': {'type': 'string', 'format': 'uri'}, 'nextAction': {'type': 'string'}, 'hourlyRideFacts': {'type': 'array', 'items': {'type': 'string'}}, 'returnRideFacts': {'type': 'array', 'items': {'type': 'string'}}, 'requiredRideFacts': {'type': 'array', 'items': {'type': 'string'}}}, 'additionalProperties': False}], '$schema': 'https://json-schema.org/draft/2020-12/schema'}
prepare_offer
Prepare an unpaid chauffeur offer
Use only for an explicit offer request with offerRequested=true, complete ride facts and email OR E.164 phone. Creates one unpaid draft and an offer link; the customer reviews bound terms and confirms via checkoutUrl. No charge or booking confirmation. Use quote_ride for price-only questions. Keep submissionId, resumeToken and inputs unchanged on retries; inspect get_offer_status on ambiguous/conflict. On rate_limited wait retryAfterSeconds. Changed facts need an explicitly requested new intent; expired or revised offers require current review.
외부 접근 가능 멱등성
입력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['submissionId', 'resumeToken', 'offerRequested', 'contact', 'ride'], 'properties': {'ride': {'type': 'object', 'required': ['pickup', 'destination', 'date', 'time', 'passengers', 'tripType'], 'properties': {'date': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'Service date as YYYY-MM-DD in the provider timeZone returned by get_service_options; resolve relative dates first.'}, 'time': {'type': 'string', 'pattern': '^(?:[01]\\d|2[0-3]):[0-5]\\d$', 'description': 'Local pickup time in 24-hour HH:mm format, in the provider timeZone (Samuelz: Europe/Berlin); not UTC or an offset timestamp.'}, 'hours': {'type': 'integer', 'maximum': 24, 'minimum': 1, 'description': 'Booked duration for hourly service; omit for transfers.'}, 'pickup': {'type': 'string', 'maxLength': 240, 'minLength': 2, 'description': 'Pickup address or named place with city/municipality or postcode; e.g. Flughafen München (MUC), 85356 München-Flughafen.'}, 'luggage': {'type': 'string', 'maxLength': 240, 'minLength': 1, 'description': 'Luggage count/type or fit requirements; unusual luggage may require review.'}, 'tripType': {'enum': ['one_way', 'return'], 'type': 'string', 'description': 'one_way for a single transfer or hourly service; return for outbound plus a separate later return transfer.'}, 'passengers': {'type': 'integer', 'maximum': 60, 'minimum': 1, 'description': 'Total people travelling; determines vehicle requirements, not availability or acceptance.'}, 'returnDate': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'Return pickup date in the same local format as date, in the provider timeZone; provide only for return trips, after the outbound pickup.'}, 'returnTime': {'type': 'string', 'pattern': '^(?:[01]\\d|2[0-3]):[0-5]\\d$', 'description': 'Return pickup time in the same local format as time and the same provider timeZone; provide only for return trips.'}, 'destination': {'type': 'string', 'maxLength': 240, 'minLength': 2, 'description': 'Destination distinct from pickup, with city/municipality or postcode; e.g. München Hauptbahnhof, 80335 München. For hourly service describe the planned route or As directed.'}, 'serviceType': {'enum': ['hourly'], 'type': 'string', 'description': 'Set hourly for service booked by duration; omit for transfers.'}, 'flightNumber': {'type': 'string', 'maxLength': 240, 'minLength': 1, 'description': 'Flight number for an airport pickup, such as LH123; omit when not applicable.'}, 'vehiclePreference': {'type': 'string', 'maxLength': 240, 'minLength': 1, 'description': 'Volunteered vehicle preference only; no class, price or availability guarantee. Additional requirements may require review.'}}, 'description': 'Ride facts with distinct pickup/destination and valid local dates/times. Return requires returnDate/returnTime after pickup; one_way omits both. Hourly requires one_way and hours; transfers omit hours.', 'additionalProperties': False}, 'locale': {'enum': ['de', 'en'], 'type': 'string', 'default': 'en', 'description': "Use the customer's requested language for text and booking links: en by default, de for German. Preserve it on retries; pickup times stay in the provider time zone."}, 'contact': {'type': 'object', 'properties': {'email': {'type': 'string', 'format': 'email', 'pattern': "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$", 'maxLength': 254, 'description': 'Reachable customer/booker email, at most 254 characters; required if no phone is supplied.'}, 'phone': {'type': 'string', 'pattern': '^\\+[1-9][0-9]{6,14}$', 'description': 'Reachable international E.164 phone, + followed by 7â\x80\x9315 digits, no spaces; required if no email is supplied.'}, 'fullName': {'type': 'string', 'maxLength': 120, 'minLength': 2, 'description': 'Optional customer/booker full name, 2â\x80\x93120 characters.'}}, 'description': 'Customer/booker contact for this explicitly requested offer: email OR E.164 phone is required. Contact does not authorize private booking/history access.', 'additionalProperties': False}, 'offerKey': {'type': 'string', 'pattern': '^[a-z0-9][a-z0-9_-]{0,79}$', 'description': 'Optional existing published provider offer key. Selects its configured service location; not booking authority.'}, 'resumeToken': {'type': 'string', 'pattern': '^[a-f0-9]{64}$', 'description': 'Private 64-character hexadecimal secret generated for this submission. Reuse its original pair with submissionId for retries and status; never substitute account credentials.'}, 'submissionId': {'type': 'string', 'format': 'uuid', 'pattern': '^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$', 'description': 'Identifies one offer intent. Generate a UUID for a requested new offer; keep it with the same resumeToken for unchanged retries and status.'}, 'offerRequested': {'type': 'boolean', 'const': True, 'description': 'Must be true only after the customer explicitly requests an offer; a price question alone is insufficient consent.'}, 'specialRequests': {'type': 'string', 'maxLength': 500, 'minLength': 1, 'description': 'Optional ride requirements, at most 500 characters. Additional stops or unusual requirements may require review; do not include contact details in a quote.'}, 'firstTouchTrackingToken': {'type': 'string', 'pattern': '^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$', 'description': 'Optional existing server-issued first-touch UUID token for this tenant and consented attribution. Omit if none; never invent a token or source.'}, 'distributionPartnerCapability': {'type': 'string', 'pattern': '^dp_live_[a-f0-9]{64}$', 'description': 'Optional existing opaque dp_live_ capability issued to an approved distribution partner. Omit for normal customers; do not create or guess one.'}}, 'additionalProperties': False}
출력 스키마
{'type': 'object', 'oneOf': [{'type': 'object', 'required': ['status'], 'properties': {'status': {'type': 'string', 'const': 'invalid_request'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['status'], 'properties': {'status': {'type': 'string', 'const': 'unavailable'}, 'bookingUrl': {'type': 'string', 'format': 'uri'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['status', 'retryAfterSeconds'], 'properties': {'status': {'type': 'string', 'const': 'pending'}, 'retryAfterSeconds': {'type': 'integer', 'maximum': 9007199254740991, 'exclusiveMinimum': 0}}, 'additionalProperties': False}, {'type': 'object', 'required': ['status', 'retryAfterSeconds'], 'properties': {'status': {'type': 'string', 'const': 'rate_limited'}, 'retryAfterSeconds': {'type': 'integer', 'maximum': 9007199254740991, 'exclusiveMinimum': 0}}, 'additionalProperties': False}, {'type': 'object', 'required': ['status'], 'properties': {'status': {'enum': ['conflict', 'ambiguous', 'not_found'], 'type': 'string'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['status', 'bookingKey', 'bookingReference', 'booking', 'payment', 'fulfillment', 'customerPortalUrl'], 'properties': {'status': {'type': 'string', 'const': 'available'}, 'booking': {'type': 'object', 'required': ['recordedStatus'], 'properties': {'recordedStatus': {'type': 'string', 'maxLength': 64, 'minLength': 1}}, 'additionalProperties': False}, 'payment': {'type': 'object', 'required': ['recordedStatus'], 'properties': {'recordedStatus': {'type': 'string', 'maxLength': 64, 'minLength': 1}}, 'additionalProperties': False}, 'bookingKey': {'type': 'string', 'maxLength': 128, 'minLength': 1}, 'fulfillment': {'type': 'object', 'required': ['chauffeurAssignmentRecorded', 'vehicleAssignmentRecorded', 'completionRecorded'], 'properties': {'completionRecorded': {'type': 'boolean'}, 'vehicleAssignmentRecorded': {'type': 'boolean'}, 'chauffeurAssignmentRecorded': {'type': 'boolean'}}, 'additionalProperties': False}, 'bookingReference': {'type': 'string', 'minLength': 1}, 'customerPortalUrl': {'type': 'string', 'format': 'uri'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['status', 'bookingUrl', 'message', 'review'], 'properties': {'review': {'type': 'object', 'required': ['code', 'customerContactRequired', 'availabilityConfirmed', 'nextAction'], 'properties': {'code': {'enum': ['additional_requirements_review', 'model_guarantee_review', 'address_review', 'service_scope_review', 'booking_window_review', 'route_review'], 'type': 'string'}, 'nextAction': {'type': 'string', 'const': 'review_requirements'}, 'availabilityConfirmed': {'type': 'boolean', 'const': False}, 'customerContactRequired': {'type': 'boolean', 'const': False}}, 'additionalProperties': False}, 'status': {'type': 'string', 'const': 'review_required'}, 'message': {'type': 'string'}, 'bookingUrl': {'type': 'string', 'format': 'uri'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['status'], 'properties': {'status': {'type': 'string', 'const': 'expired'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['status', 'bookingConfirmed', 'checkoutUrl', 'termsUrl', 'offer', 'nextAction'], 'properties': {'offer': {'type': 'object', 'required': ['currency', 'grossTotalCents', 'expiresAt', 'customerConfirmationRequired', 'completeTermsBound'], 'properties': {'currency': {'type': 'string', 'const': 'EUR'}, 'expiresAt': {'type': 'string'}, 'grossTotalCents': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'completeTermsBound': {'type': 'boolean', 'const': True}, 'customerConfirmationRequired': {'type': 'boolean', 'const': True}}, 'additionalProperties': False}, 'status': {'type': 'string', 'const': 'prepared'}, 'termsUrl': {'type': 'string', 'format': 'uri'}, 'nextAction': {'type': 'string'}, 'checkoutUrl': {'type': 'string', 'format': 'uri'}, 'bookingConfirmed': {'type': 'boolean', 'const': False}, 'customerPortalUrl': {'type': 'string', 'format': 'uri'}}, 'additionalProperties': False}], '$schema': 'https://json-schema.org/draft/2020-12/schema'}
quote_ride
Chauffeur price preview
Use after get_service_options to calculate an anonymous price preview for complete ride facts in the provider timeZone. No contact is needed. Resolve missing return or hourly facts before quoting. The calculatedAt preview requires revalidation; no price-validity window is guaranteed. For rate_limited wait retryAfterSeconds. For review_required follow the returned guidance; it does not prove vehicle unavailability. No offer, reservation, charge or message is created. Call prepare_offer only for an explicit offer request.
읽기 전용 외부 접근 가능
입력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['ride'], 'properties': {'ride': {'type': 'object', 'required': ['pickup', 'destination', 'date', 'time', 'passengers', 'tripType'], 'properties': {'date': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'Service date as YYYY-MM-DD in the provider timeZone returned by get_service_options; resolve relative dates first.'}, 'time': {'type': 'string', 'pattern': '^(?:[01]\\d|2[0-3]):[0-5]\\d$', 'description': 'Local pickup time in 24-hour HH:mm format, in the provider timeZone (Samuelz: Europe/Berlin); not UTC or an offset timestamp.'}, 'hours': {'type': 'integer', 'maximum': 24, 'minimum': 1, 'description': 'Booked duration for hourly service; omit for transfers.'}, 'pickup': {'type': 'string', 'maxLength': 240, 'minLength': 2, 'description': 'Pickup address or named place with city/municipality or postcode; e.g. Flughafen München (MUC), 85356 München-Flughafen.'}, 'luggage': {'type': 'string', 'maxLength': 240, 'minLength': 1, 'description': 'Luggage count/type or fit requirements; unusual luggage may require review.'}, 'tripType': {'enum': ['one_way', 'return'], 'type': 'string', 'description': 'one_way for a single transfer or hourly service; return for outbound plus a separate later return transfer.'}, 'passengers': {'type': 'integer', 'maximum': 60, 'minimum': 1, 'description': 'Total people travelling; determines vehicle requirements, not availability or acceptance.'}, 'returnDate': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'Return pickup date in the same local format as date, in the provider timeZone; provide only for return trips, after the outbound pickup.'}, 'returnTime': {'type': 'string', 'pattern': '^(?:[01]\\d|2[0-3]):[0-5]\\d$', 'description': 'Return pickup time in the same local format as time and the same provider timeZone; provide only for return trips.'}, 'destination': {'type': 'string', 'maxLength': 240, 'minLength': 2, 'description': 'Destination distinct from pickup, with city/municipality or postcode; e.g. München Hauptbahnhof, 80335 München. For hourly service describe the planned route or As directed.'}, 'serviceType': {'enum': ['hourly'], 'type': 'string', 'description': 'Set hourly for service booked by duration; omit for transfers.'}, 'flightNumber': {'type': 'string', 'maxLength': 240, 'minLength': 1, 'description': 'Flight number for an airport pickup, such as LH123; omit when not applicable.'}, 'vehiclePreference': {'type': 'string', 'maxLength': 240, 'minLength': 1, 'description': 'Volunteered vehicle preference only; no class, price or availability guarantee. Additional requirements may require review.'}}, 'description': 'Ride facts with distinct pickup/destination and valid local dates/times. Return requires returnDate/returnTime after pickup; one_way omits both. Hourly requires one_way and hours; transfers omit hours.', 'additionalProperties': False}, 'locale': {'enum': ['de', 'en'], 'type': 'string', 'default': 'en', 'description': "Use the customer's requested language for text and booking links: en by default, de for German. Preserve it on retries; pickup times stay in the provider time zone."}, 'offerKey': {'type': 'string', 'pattern': '^[a-z0-9][a-z0-9_-]{0,79}$', 'description': 'Optional existing published provider offer key. Selects its configured service location; not booking authority.'}, 'specialRequests': {'type': 'string', 'maxLength': 500, 'minLength': 1, 'description': 'Optional ride requirements, at most 500 characters. Additional stops or unusual requirements may require review; do not include contact details in a quote.'}}, 'additionalProperties': False}
출력 스키마
{'type': 'object', 'oneOf': [{'type': 'object', 'required': ['status'], 'properties': {'status': {'type': 'string', 'const': 'invalid_request'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['status'], 'properties': {'status': {'type': 'string', 'const': 'unavailable'}, 'bookingUrl': {'type': 'string', 'format': 'uri'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['status', 'bookingUrl', 'retryAfterSeconds'], 'properties': {'status': {'type': 'string', 'const': 'rate_limited'}, 'bookingUrl': {'type': 'string', 'format': 'uri'}, 'retryAfterSeconds': {'type': 'integer', 'maximum': 9007199254740991, 'exclusiveMinimum': 0}}, 'additionalProperties': False}, {'type': 'object', 'required': ['status', 'bookingUrl', 'message'], 'properties': {'review': {'type': 'object', 'required': ['code', 'customerContactRequired', 'availabilityConfirmed', 'nextAction'], 'properties': {'code': {'enum': ['additional_requirements_review', 'model_guarantee_review', 'address_review', 'service_scope_review', 'booking_window_review', 'route_review'], 'type': 'string'}, 'nextAction': {'type': 'string', 'const': 'review_requirements'}, 'availabilityConfirmed': {'type': 'boolean', 'const': False}, 'customerContactRequired': {'type': 'boolean', 'const': False}}, 'additionalProperties': False}, 'status': {'type': 'string', 'const': 'review_required'}, 'message': {'type': 'string'}, 'bookingUrl': {'type': 'string', 'format': 'uri'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['status', 'bookingUrl', 'bookingConfirmed', 'quote', 'nextAction'], 'properties': {'quote': {'type': 'object', 'required': ['currency', 'grossTotalCents', 'pricesIncludeVat', 'vatRateBasisPoints', 'parkingIncluded', 'tollsIncluded', 'vehicleCount', 'billableHoursPerServiceLine', 'serviceLines', 'calculatedAt', 'revalidationRequired'], 'properties': {'currency': {'type': 'string'}, 'calculatedAt': {'type': 'string'}, 'serviceLines': {'type': 'array', 'items': {'type': 'object', 'required': ['direction', 'grossAmountCents'], 'properties': {'direction': {'enum': ['outbound', 'return'], 'type': 'string'}, 'grossAmountCents': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}}, 'additionalProperties': False}}, 'vehicleCount': {'type': 'integer', 'maximum': 9007199254740991, 'exclusiveMinimum': 0}, 'tollsIncluded': {'type': 'boolean'}, 'grossTotalCents': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'parkingIncluded': {'type': 'boolean'}, 'pricesIncludeVat': {'type': 'boolean'}, 'vatRateBasisPoints': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'revalidationRequired': {'type': 'boolean', 'const': True}, 'billableHoursPerServiceLine': {'type': 'number', 'exclusiveMinimum': 0}}, 'additionalProperties': False}, 'status': {'type': 'string', 'const': 'quoted'}, 'bookingUrl': {'type': 'string', 'format': 'uri'}, 'nextAction': {'type': 'string'}, 'bookingConfirmed': {'type': 'boolean', 'const': False}}, 'additionalProperties': False}], '$schema': 'https://json-schema.org/draft/2020-12/schema'}
변경됨
get_offer_status
2026년 10월 5일 2:43 AM
변경됨
prepare_offer
2026년 10월 5일 2:43 AM
변경됨
quote_ride
2026년 10월 5일 2:43 AM
변경됨
get_customer_policy
2026년 10월 5일 2:43 AM
변경됨
get_service_options
2026년 10월 5일 2:43 AM
변경됨
get_offer_status
2026년 10월 3일 2:50 AM
변경됨
prepare_offer
2026년 10월 3일 2:50 AM
변경됨
quote_ride
2026년 10월 3일 2:50 AM
변경됨
get_customer_policy
2026년 10월 3일 2:50 AM
변경됨
get_service_options
2026년 10월 3일 2:50 AM
변경됨
prepare_offer
2026년 9월 29일 2:50 AM
변경됨
quote_ride
2026년 9월 29일 2:50 AM
변경됨
prepare_offer
2026년 9월 25일 2:49 AM
변경됨
quote_ride
2026년 9월 25일 2:49 AM
추가됨
get_offer_status
2026년 9월 23일 2:40 AM
추가됨
prepare_offer
2026년 9월 23일 2:40 AM
추가됨
quote_ride
2026년 9월 23일 2:40 AM
추가됨
get_customer_policy
2026년 9월 23일 2:40 AM
추가됨
get_service_options
2026년 9월 23일 2:40 AM