Razi Web Tools

{'type': 'object', 'required': ['encoded'], 'properties': {'encoded': {'type': 'string', 'description': 'A percent-encoded string, such as one query-string value taken from a URL. Every %XX sequence must be well formed UTF-8 or the call fails.'}}}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'description': "The value to percent-encode, typically one query-string value or path segment. Everything outside A-Z a-z 0-9 - _ . ! ~ * ' ( ) is escaped, including slashes and colons."}}}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'description': 'The page to read, e.g. https://stripe.com/pricing. A bare domain is accepted and assumed to be https. It is the cache key verbatim, so two spellings of the same page are fetched twice.'}}}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'description': 'The website to inspect, e.g. https://stripe.com. A bare domain is accepted and assumed to be https. Up to 3 redirects are followed; more is refused with 400.'}, 'rehost': {'type': 'boolean', 'description': "Copy the top 3 fetchable candidates to razi.pro's CDN and expose them as `rehostedUrl` (default true). Prefer these for downloading or embedding: many origins block hotlinking or omit CORS headers, so the original URL can fail in a browser. Set false to skip the copy and get origin URLs only. A copy that fails is dropped silently, leaving that candidate with its origin URL only, and the two settings are cached separately."}}}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'description': 'The page to capture. Must be publicly reachable over http or https; the scheme is required. Part of the cache key, so two spellings of the same page render twice.'}, 'width': {'type': 'number', 'description': 'Viewport width in pixels. Default 1280; values outside 200-3840 are clamped into that range and fractions are truncated.'}, 'format': {'enum': ['webp', 'png', 'jpeg'], 'type': 'string', 'description': 'Image format. Default webp; an unrecognised value also falls back to webp.'}, 'height': {'type': 'number', 'description': 'Viewport height in pixels. Default 800; values outside 200-4320 are clamped. Ignored when fullPage is true, where the returned height is null.'}, 'delayMs': {'type': 'number', 'description': 'Extra wait after load, in milliseconds. Default 0, clamped to 0-5000. Use for pages with entrance animations or slow client-side rendering; it comes out of the same 50-second render budget.'}, 'darkMode': {'type': 'boolean', 'description': 'Render with prefers-color-scheme: dark. Default false. Has no effect on sites that do not implement a dark theme.'}, 'fullPage': {'type': 'boolean', 'description': 'Capture the entire scrollable page rather than just the viewport. Default false. Pages taller than 12000px are truncated at 12000px, which is a browser encoding limit, so a very long article returns only its top portion.'}}}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'description': 'The absolute destination URL to redirect to, including the scheme. Only http:// and https:// are accepted; anything that is not an absolute URL in one of those schemes is rejected with 400. It is normalised by the URL parser before being stored, so the redirect target may differ cosmetically from what you sent.'}, 'customCode': {'type': 'string', 'description': "Vanity code to use as the last path segment, e.g. 'launch' for razi.pro/launch. 3-32 characters, letters, digits, hyphen and underscore only. Fails with 409 if already taken and 400 if it is malformed or collides with a reserved site path such as 'api', 'blog' or 'tools'. Omit to get a random 8-character code drawn from an alphabet with no 0, O, 1 or l."}}}