Description
OpenAPI info.contact.url points to a page with contact information for the API. OpenAPI 3.0 permits relative URLs, so / is not inherently malformed; verify that its resolution against the server URL reaches the intended support page.
Potential impact
A wrong destination or broken link can prevent API consumers from finding the support channel.
Remediation
Check the spelling and actual link destination. For a relative address, verify the base URL and tool behavior; for an independent support site, specify a URL with its scheme and host.
Examples
These OpenAPI 3.0 examples compare the relative path / with an absolute URL. Permitted syntax alone does not establish that the target provides API support information.
Before
{
"openapi": "3.0.0",
"info": {
"title": "Simple API Overview",
"version": "1.0.0",
"contact": {
"name": "contact",
"url": "/",
"email": "user@gmail.com"
}
},
"paths": {
"/": {
"get": {
"operationId": "listVersionsv2",
"summary": "List API versions",
"responses": {
"200": {
"description": "200 response",
"content": {
"application/json": {
"examples": {
"foo": {
"value": {
"versions": [
{
"status": "CURRENT",
"updated": "2011-01-21T11:33:21Z",
"id": "v2.0",
"links": [
{
"href": "http://127.0.0.1:8774/v2/",
"rel": "self"
}
]
}
]
}
}
}
}
}
}
}
}
}
}
}
After
{
"openapi": "3.0.0",
"info": {
"title": "Simple API Overview",
"version": "1.0.0",
"contact": {
"name": "contact",
"url": "https://www.google.com/",
"email": "user@gmail.com"
}
},
"paths": {
"/": {
"get": {
"operationId": "listVersionsv2",
"summary": "List API versions",
"responses": {
"200": {
"description": "200 response",
"content": {
"application/json": {
"examples": {
"foo": {
"value": {
"versions": [
{
"status": "CURRENT",
"updated": "2011-01-21T11:33:21Z",
"id": "v2.0",
"links": [
{
"href": "http://127.0.0.1:8774/v2/",
"rel": "self"
}
]
}
]
}
}
}
}
}
}
}
}
}
}
}
The revised URL uses the Google homepage as an example. Replace it with the actual API support page and verify the link shown in the documentation.