Hapi · Schema
hapi Server Configuration
JSON Schema for hapi server configuration options passed to Hapi.server().
AuthenticationFrameworksJavaScriptNode.jsValidationWeb Framework
Properties
| Name | Type | Description |
|---|---|---|
| host | string | Public hostname or IP address. |
| port | integer | TCP port to listen on. |
| address | string | Hostname or IP address to bind to (defaults to host). |
| autoListen | boolean | Whether to automatically start listening. |
| tls | object | TLS configuration. |
| routes | object | Default route configuration. |
| cache | object | Server-side cache provider configuration. |
| compression | object | Compression settings. |
| debug | object | Debug logging configuration. |
| load | object | Server load monitoring configuration. |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://github.com/api-evangelist/hapi/json-schema/hapi-server-configuration.json",
"title": "hapi Server Configuration",
"description": "JSON Schema for hapi server configuration options passed to Hapi.server().",
"type": "object",
"properties": {
"host": {
"type": "string",
"default": "localhost",
"description": "Public hostname or IP address."
},
"port": {
"type": "integer",
"default": 3000,
"description": "TCP port to listen on."
},
"address": {
"type": "string",
"description": "Hostname or IP address to bind to (defaults to host)."
},
"autoListen": {
"type": "boolean",
"default": true,
"description": "Whether to automatically start listening."
},
"tls": {
"oneOf": [
{ "type": "boolean" },
{
"type": "object",
"properties": {
"key": { "type": "string" },
"cert": { "type": "string" },
"ca": {
"type": "array",
"items": { "type": "string" }
}
}
}
],
"description": "TLS configuration."
},
"routes": {
"type": "object",
"properties": {
"cors": {
"oneOf": [
{ "type": "boolean" },
{
"type": "object",
"properties": {
"origin": {
"type": "array",
"items": { "type": "string" },
"default": ["*"]
},
"maxAge": {
"type": "integer",
"default": 86400
},
"headers": {
"type": "array",
"items": { "type": "string" }
},
"additionalHeaders": {
"type": "array",
"items": { "type": "string" }
},
"credentials": {
"type": "boolean",
"default": false
}
}
}
],
"description": "CORS configuration."
},
"files": {
"type": "object",
"properties": {
"relativeTo": {
"type": "string",
"description": "Base path for relative file paths."
}
}
},
"validate": {
"type": "object",
"properties": {
"failAction": {
"type": "string",
"enum": ["error", "log", "ignore"],
"default": "error"
}
}
},
"security": {
"oneOf": [
{ "type": "boolean" },
{
"type": "object",
"properties": {
"hsts": {
"oneOf": [
{ "type": "boolean" },
{
"type": "object",
"properties": {
"maxAge": { "type": "integer" },
"includeSubDomains": { "type": "boolean" },
"preload": { "type": "boolean" }
}
}
]
},
"xframe": {
"oneOf": [
{ "type": "boolean" },
{ "type": "string", "enum": ["deny", "sameorigin"] }
]
},
"xss": { "type": "boolean" },
"noOpen": { "type": "boolean" },
"noSniff": { "type": "boolean" },
"referrer": { "type": "boolean" }
}
}
],
"description": "Security header configuration."
}
},
"description": "Default route configuration."
},
"cache": {
"oneOf": [
{ "type": "string" },
{
"type": "object",
"properties": {
"name": { "type": "string" },
"provider": {
"type": "object",
"properties": {
"constructor": { "type": "string" },
"options": { "type": "object" }
}
}
}
},
{
"type": "array",
"items": { "type": "object" }
}
],
"description": "Server-side cache provider configuration."
},
"compression": {
"oneOf": [
{ "type": "boolean" },
{
"type": "object",
"properties": {
"minBytes": {
"type": "integer",
"default": 1024,
"description": "Minimum response size in bytes to compress."
}
}
}
],
"description": "Compression settings."
},
"debug": {
"type": "object",
"properties": {
"request": {
"type": "array",
"items": { "type": "string" },
"description": "Request event tags to log."
},
"log": {
"type": "array",
"items": { "type": "string" },
"description": "Server log event tags to log."
}
},
"description": "Debug logging configuration."
},
"load": {
"type": "object",
"properties": {
"sampleInterval": {
"type": "integer",
"default": 0,
"description": "Sampling interval for load monitoring in milliseconds."
},
"maxHeapUsedBytes": {
"type": "integer",
"default": 0,
"description": "Maximum V8 heap used in bytes (0 = no limit)."
},
"maxRssBytes": {
"type": "integer",
"default": 0,
"description": "Maximum process RSS in bytes (0 = no limit)."
},
"maxEventLoopDelay": {
"type": "integer",
"default": 0,
"description": "Maximum event loop delay in milliseconds (0 = no limit)."
}
},
"description": "Server load monitoring configuration."
}
}
}
Work with this as data
Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for schemas
4 MCP tools reach this
find_json_schemasBrowse and filter every JSON Schema in the catalog.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/hapi-server-configuration"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.