{
 "openapi": "3.1.0",
 "info": {
  "title": "Developer Utilities",
  "description": "Twenty-five data, validation and utility APIs served from one server at separate path prefixes.",
  "version": "0.1.0"
 },
 "paths": {
  "/tools/v1/user-agent": {
   "get": {
    "tags": [
     "Developer Utilities"
    ],
    "summary": "Parse a User-Agent string",
    "description": "Browser, operating system, device type and whether the client is a bot.",
    "operationId": "Parse a User-Agent string",
    "parameters": [
     {
      "name": "ua",
      "in": "query",
      "required": true,
      "schema": {
       "type": "string",
       "minLength": 1,
       "maxLength": 1000,
       "description": "The User-Agent header value.",
       "examples": [
        "Mozilla/5.0 (iPhone; CPU iPhone OS 17_4 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.4 Mobile/15E148 Safari/604.1"
       ],
       "title": "Ua"
      },
      "description": "The User-Agent header value."
     }
    ],
    "responses": {
     "200": {
      "description": "Successful Response",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "additionalProperties": true,
         "title": "Response User Agent Tools V1 User Agent Get"
        }
       }
      }
     },
     "422": {
      "description": "Validation Error",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/HTTPValidationError"
        }
       }
      }
     }
    }
   }
  },
  "/tools/v1/user-agent/batch": {
   "post": {
    "tags": [
     "Developer Utilities"
    ],
    "summary": "Parse up to 200 User-Agent strings",
    "operationId": "Parse up to 200 User-Agent strings",
    "requestBody": {
     "content": {
      "application/json": {
       "schema": {
        "$ref": "#/components/schemas/AgentsIn"
       }
      }
     },
     "required": true
    },
    "responses": {
     "200": {
      "description": "Successful Response",
      "content": {
       "application/json": {
        "schema": {
         "additionalProperties": true,
         "type": "object",
         "title": "Response User Agent Batch Tools V1 User Agent Batch Post"
        }
       }
      }
     },
     "422": {
      "description": "Validation Error",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/HTTPValidationError"
        }
       }
      }
     }
    }
   }
  },
  "/tools/v1/cron": {
   "get": {
    "tags": [
     "Developer Utilities"
    ],
    "summary": "Explain a cron expression and list its next runs",
    "operationId": "Explain a cron expression and list its next runs",
    "parameters": [
     {
      "name": "expression",
      "in": "query",
      "required": true,
      "schema": {
       "type": "string",
       "minLength": 5,
       "maxLength": 120,
       "description": "Five fields, or six with seconds last. @daily style shortcuts work too.",
       "examples": [
        "*/15 9-17 * * 1-5"
       ],
       "title": "Expression"
      },
      "description": "Five fields, or six with seconds last. @daily style shortcuts work too."
     },
     {
      "name": "zone",
      "in": "query",
      "required": false,
      "schema": {
       "type": "string",
       "maxLength": 64,
       "description": "IANA time zone the schedule runs in.",
       "default": "UTC",
       "title": "Zone"
      },
      "description": "IANA time zone the schedule runs in."
     },
     {
      "name": "count",
      "in": "query",
      "required": false,
      "schema": {
       "type": "integer",
       "maximum": 50,
       "minimum": 1,
       "default": 5,
       "title": "Count"
      }
     },
     {
      "name": "after",
      "in": "query",
      "required": false,
      "schema": {
       "anyOf": [
        {
         "type": "string",
         "format": "date-time"
        },
        {
         "type": "null"
        }
       ],
       "description": "List runs after this time. Defaults to now.",
       "title": "After"
      },
      "description": "List runs after this time. Defaults to now."
     }
    ],
    "responses": {
     "200": {
      "description": "Successful Response",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "additionalProperties": true,
         "title": "Response Cron Tools V1 Cron Get"
        }
       }
      }
     },
     "422": {
      "description": "Validation Error",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/HTTPValidationError"
        }
       }
      }
     }
    }
   }
  },
  "/tools/v1/password-strength": {
   "post": {
    "tags": [
     "Developer Utilities"
    ],
    "summary": "Estimate password strength",
    "description": "Scores a password from 0 (very weak) to 4 (very strong) by estimating how many guesses an attacker needs, catching dictionary words, names, dates, keyboard patterns and repeats. The password is never stored, logged or returned.",
    "operationId": "Estimate password strength",
    "requestBody": {
     "content": {
      "application/json": {
       "schema": {
        "$ref": "#/components/schemas/PasswordIn"
       }
      }
     },
     "required": true
    },
    "responses": {
     "200": {
      "description": "Successful Response",
      "content": {
       "application/json": {
        "schema": {
         "additionalProperties": true,
         "type": "object",
         "title": "Response Password Strength Tools V1 Password Strength Post"
        }
       }
      }
     },
     "422": {
      "description": "Validation Error",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/HTTPValidationError"
        }
       }
      }
     }
    }
   }
  },
  "/tools/v1/jwt/decode": {
   "post": {
    "tags": [
     "Developer Utilities"
    ],
    "summary": "Decode a JSON Web Token",
    "description": "Returns the header and claims and whether the token has expired. The signature is NOT verified, so do not treat the claims as trusted. The token is not stored or logged.",
    "operationId": "Decode a JSON Web Token",
    "requestBody": {
     "content": {
      "application/json": {
       "schema": {
        "$ref": "#/components/schemas/TokenIn"
       }
      }
     },
     "required": true
    },
    "responses": {
     "200": {
      "description": "Successful Response",
      "content": {
       "application/json": {
        "schema": {
         "additionalProperties": true,
         "type": "object",
         "title": "Response Jwt Decode Tools V1 Jwt Decode Post"
        }
       }
      }
     },
     "422": {
      "description": "Validation Error",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/HTTPValidationError"
        }
       }
      }
     }
    }
   }
  },
  "/tools/v1/hash": {
   "post": {
    "tags": [
     "Developer Utilities"
    ],
    "summary": "Hash a text with one or more algorithms",
    "operationId": "Hash a text with one or more algorithms",
    "requestBody": {
     "content": {
      "application/json": {
       "schema": {
        "$ref": "#/components/schemas/HashIn"
       }
      }
     },
     "required": true
    },
    "responses": {
     "200": {
      "description": "Successful Response",
      "content": {
       "application/json": {
        "schema": {
         "additionalProperties": true,
         "type": "object",
         "title": "Response Hash Text Tools V1 Hash Post"
        }
       }
      }
     },
     "422": {
      "description": "Validation Error",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/HTTPValidationError"
        }
       }
      }
     }
    }
   }
  },
  "/tools/v1/uuid": {
   "get": {
    "tags": [
     "Developer Utilities"
    ],
    "summary": "Generate UUIDs",
    "operationId": "Generate UUIDs",
    "parameters": [
     {
      "name": "version",
      "in": "query",
      "required": false,
      "schema": {
       "type": "integer",
       "description": "4 (random) or 7 (time-ordered, sortable).",
       "default": 4,
       "title": "Version"
      },
      "description": "4 (random) or 7 (time-ordered, sortable)."
     },
     {
      "name": "count",
      "in": "query",
      "required": false,
      "schema": {
       "type": "integer",
       "maximum": 100,
       "minimum": 1,
       "default": 1,
       "title": "Count"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Successful Response",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "additionalProperties": true,
         "title": "Response Make Uuid Tools V1 Uuid Get"
        }
       }
      }
     },
     "422": {
      "description": "Validation Error",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/HTTPValidationError"
        }
       }
      }
     }
    }
   }
  }
 },
 "components": {
  "schemas": {
   "AgentsIn": {
    "properties": {
     "user_agents": {
      "items": {
       "type": "string"
      },
      "type": "array",
      "title": "User Agents",
      "description": "Up to 200 User-Agent strings."
     }
    },
    "type": "object",
    "required": [
     "user_agents"
    ],
    "title": "AgentsIn"
   },
   "Ats": {
    "type": "string",
    "enum": [
     "greenhouse",
     "lever",
     "ashby",
     "workable",
     "smartrecruiters",
     "recruitee",
     "personio",
     "rippling",
     "workday"
    ],
    "title": "Ats"
   },
   "BoardRef": {
    "properties": {
     "ats": {
      "$ref": "#/components/schemas/Ats"
     },
     "board": {
      "type": "string",
      "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$",
      "title": "Board"
     }
    },
    "type": "object",
    "required": [
     "ats",
     "board"
    ],
    "title": "BoardRef"
   },
   "CardBody": {
    "properties": {
     "number": {
      "type": "string",
      "maxLength": 40,
      "minLength": 12,
      "title": "Number",
      "examples": [
       "4111 1111 1111 1111"
      ]
     }
    },
    "type": "object",
    "required": [
     "number"
    ],
    "title": "CardBody"
   },
   "Ecc": {
    "type": "string",
    "enum": [
     "L",
     "M",
     "Q",
     "H"
    ],
    "title": "Ecc"
   },
   "HTTPValidationError": {
    "properties": {
     "detail": {
      "items": {
       "$ref": "#/components/schemas/ValidationError"
      },
      "type": "array",
      "title": "Detail"
     }
    },
    "type": "object",
    "title": "HTTPValidationError"
   },
   "HashIn": {
    "properties": {
     "text": {
      "type": "string",
      "maxLength": 1000000,
      "title": "Text"
     },
     "algorithms": {
      "items": {
       "type": "string"
      },
      "type": "array",
      "title": "Algorithms",
      "default": [
       "md5",
       "sha1",
       "sha256",
       "sha512"
      ]
     }
    },
    "type": "object",
    "required": [
     "text"
    ],
    "title": "HashIn"
   },
   "PasswordIn": {
    "properties": {
     "password": {
      "type": "string",
      "maxLength": 128,
      "minLength": 1,
      "title": "Password"
     },
     "user_inputs": {
      "items": {
       "type": "string"
      },
      "type": "array",
      "maxItems": 10,
      "title": "User Inputs",
      "description": "Optional words tied to the user (name, email, site name) that should count as guessable."
     }
    },
    "type": "object",
    "required": [
     "password"
    ],
    "title": "PasswordIn"
   },
   "QrFormat": {
    "type": "string",
    "enum": [
     "png",
     "svg",
     "json"
    ],
    "title": "QrFormat"
   },
   "SearchBody": {
    "properties": {
     "boards": {
      "items": {
       "$ref": "#/components/schemas/BoardRef"
      },
      "type": "array",
      "maxItems": 20,
      "minItems": 1,
      "title": "Boards",
      "description": "The company boards to search."
     },
     "q": {
      "anyOf": [
       {
        "type": "string",
        "maxLength": 100
       },
       {
        "type": "null"
       }
      ],
      "title": "Q"
     },
     "location": {
      "anyOf": [
       {
        "type": "string",
        "maxLength": 100
       },
       {
        "type": "null"
       }
      ],
      "title": "Location"
     },
     "remote": {
      "anyOf": [
       {
        "type": "boolean"
       },
       {
        "type": "null"
       }
      ],
      "title": "Remote"
     },
     "posted_after": {
      "anyOf": [
       {
        "type": "string",
        "format": "date-time"
       },
       {
        "type": "null"
       }
      ],
      "title": "Posted After",
      "description": "Keep jobs posted at or after this time (ISO 8601)."
     },
     "limit": {
      "type": "integer",
      "maximum": 200,
      "minimum": 1,
      "title": "Limit",
      "default": 50
     }
    },
    "type": "object",
    "required": [
     "boards"
    ],
    "title": "SearchBody"
   },
   "Sort": {
    "type": "string",
    "enum": [
     "most_recent",
     "most_helpful"
    ],
    "title": "Sort"
   },
   "Symbology": {
    "type": "string",
    "enum": [
     "code128",
     "code39",
     "ean13",
     "ean8",
     "upca",
     "isbn13",
     "itf"
    ],
    "title": "Symbology"
   },
   "TextIn": {
    "properties": {
     "text": {
      "type": "string",
      "maxLength": 100000,
      "minLength": 1,
      "title": "Text",
      "description": "The text to analyse (up to 100,000 characters)."
     }
    },
    "type": "object",
    "required": [
     "text"
    ],
    "title": "TextIn"
   },
   "TextsIn": {
    "properties": {
     "texts": {
      "items": {
       "type": "string"
      },
      "type": "array",
      "title": "Texts",
      "description": "Up to 100 texts of at most 5,000 characters each."
     }
    },
    "type": "object",
    "required": [
     "texts"
    ],
    "title": "TextsIn"
   },
   "TokenIn": {
    "properties": {
     "token": {
      "type": "string",
      "maxLength": 8192,
      "minLength": 5,
      "title": "Token"
     }
    },
    "type": "object",
    "required": [
     "token"
    ],
    "title": "TokenIn"
   },
   "ValidationError": {
    "properties": {
     "loc": {
      "items": {
       "anyOf": [
        {
         "type": "string"
        },
        {
         "type": "integer"
        }
       ]
      },
      "type": "array",
      "title": "Location"
     },
     "msg": {
      "type": "string",
      "title": "Message"
     },
     "type": {
      "type": "string",
      "title": "Error Type"
     },
     "input": {
      "title": "Input"
     },
     "ctx": {
      "type": "object",
      "title": "Context"
     }
    },
    "type": "object",
    "required": [
     "loc",
     "msg",
     "type"
    ],
    "title": "ValidationError"
   },
   "app__routers__contacts__BatchBody": {
    "properties": {
     "urls": {
      "items": {
       "type": "string"
      },
      "type": "array",
      "maxItems": 10,
      "minItems": 1,
      "title": "Urls",
      "description": "Domains or URLs, one per site."
     },
     "max_pages": {
      "type": "integer",
      "maximum": 5,
      "minimum": 1,
      "title": "Max Pages",
      "description": "Pages to read per site.",
      "default": 3
     },
     "default_country": {
      "anyOf": [
       {
        "type": "string",
        "pattern": "^[A-Za-z]{2}$"
       },
       {
        "type": "null"
       }
      ],
      "title": "Default Country"
     },
     "validate_emails": {
      "type": "boolean",
      "title": "Validate Emails",
      "default": false
     }
    },
    "type": "object",
    "required": [
     "urls"
    ],
    "title": "BatchBody"
   },
   "app__routers__email__BatchBody": {
    "properties": {
     "emails": {
      "items": {
       "type": "string"
      },
      "type": "array",
      "maxItems": 50,
      "minItems": 1,
      "title": "Emails"
     },
     "check_mx": {
      "type": "boolean",
      "title": "Check Mx",
      "default": true
     }
    },
    "type": "object",
    "required": [
     "emails"
    ],
    "title": "BatchBody"
   },
   "app__routers__ip__BatchBody": {
    "properties": {
     "ips": {
      "items": {
       "type": "string"
      },
      "type": "array",
      "maxItems": 100,
      "minItems": 1,
      "title": "Ips"
     }
    },
    "type": "object",
    "required": [
     "ips"
    ],
    "title": "BatchBody"
   },
   "app__routers__phone__BatchBody": {
    "properties": {
     "numbers": {
      "items": {
       "type": "string"
      },
      "type": "array",
      "maxItems": 100,
      "minItems": 1,
      "title": "Numbers"
     },
     "default_country": {
      "anyOf": [
       {
        "type": "string",
        "pattern": "^[A-Za-z]{2}$"
       },
       {
        "type": "null"
       }
      ],
      "title": "Default Country"
     }
    },
    "type": "object",
    "required": [
     "numbers"
    ],
    "title": "BatchBody"
   },
   "app__routers__vin__BatchBody": {
    "properties": {
     "vins": {
      "items": {
       "type": "string"
      },
      "type": "array",
      "maxItems": 50,
      "minItems": 1,
      "title": "Vins"
     }
    },
    "type": "object",
    "required": [
     "vins"
    ],
    "title": "BatchBody"
   }
  }
 }
}
