Realask - verified answers from the physical world

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['job_id', 'job_token'], 'properties': {'job_id': {'type': 'string', 'description': "job_id returned by purchase_quote, e.g. 'job_gf8t5wwfrtgpjcdc'"}, 'job_token': {'type': 'string', 'description': 'job_token returned once by purchase_quote; the bearer token for this job. Not recoverable if lost - a new job would have to be purchased.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['job_id', 'job_token'], 'properties': {'job_id': {'type': 'string', 'description': "job_id returned by purchase_quote, e.g. 'job_gf8t5wwfrtgpjcdc'"}, 'job_token': {'type': 'string', 'description': 'job_token returned once by purchase_quote; the bearer token for this job. Not recoverable if lost - a new job would have to be purchased.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['quote_id'], 'properties': {'quote_id': {'type': 'string'}, 'idempotency_key': {'type': 'string', 'description': 'Client-generated UUID; reuse it when retrying'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['action', 'what', 'business_name', 'postal_code', 'customer_name', 'customer_callback_phone', 'authorized'], 'properties': {'what': {'type': 'string', 'maxLength': 500, 'minLength': 3, 'description': "Exactly what to arrange, e.g. 'two Michelin Pilot Sport 4S 235/40R19 installed'"}, 'when': {'type': 'string', 'description': "Time window, e.g. 'tomorrow afternoon'"}, 'notes': {'type': 'string', 'description': 'Constraints the caller must honour'}, 'action': {'enum': ['book', 'hold', 'request_quote', 'cancel'], 'type': 'string'}, 'place_id': {'type': 'string', 'description': 'Google place_id, if known - more reliable than a name'}, 'quantity': {'type': 'integer', 'maximum': 9007199254740991, 'exclusiveMinimum': 0}, 'reference': {'type': 'string', 'description': 'Existing confirmation reference. Required for cancel.'}, 'authorized': {'type': 'boolean', 'const': True, 'description': 'You confirm the end user authorized this commitment on their behalf'}, 'postal_code': {'type': 'string'}, 'business_name': {'type': 'string', 'description': 'The business to act on'}, 'customer_name': {'type': 'string', 'description': 'Name to hold the booking under. Shared with the business.'}, 'max_price_minor': {'type': 'integer', 'maximum': 9007199254740991, 'description': 'Ceiling in cents the caller may agree to. Required for book and hold.', 'exclusiveMinimum': 0}, 'customer_callback_phone': {'type': 'string', 'description': 'Number the business can call back. Shared with the business.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['request', 'location'], 'properties': {'limits': {'type': 'object', 'properties': {'max_businesses': {'type': 'integer', 'maximum': 5, 'minimum': 1}, 'deadline_seconds': {'type': 'integer', 'maximum': 600, 'minimum': 60}, 'max_call_attempts_per_target': {'type': 'integer', 'maximum': 2, 'minimum': 1}}}, 'request': {'type': 'string', 'maxLength': 2000, 'minLength': 8, 'description': "Natural-language question, e.g. 'Does ABC Tire in 33312 have two Michelin Pilot Sport 4S 235/40R19 in stock today and what is the installed price?'"}, 'location': {'type': 'object', 'properties': {'lat': {'type': 'number'}, 'lng': {'type': 'number'}, 'city': {'type': 'string'}, 'region': {'type': 'string'}, 'country': {'type': 'string', 'default': 'US'}, 'postal_code': {'type': 'string'}, 'radius_miles': {'type': 'number'}}}, 'callback_url': {'type': 'string', 'format': 'uri'}, 'verification_mode': {'enum': ['digital_fast', 'live_verified', 'auto'], 'type': 'string', 'description': 'auto reuses fresh cached facts when safe; live_verified forces a new call'}}}