# contact-defined

Source: https://apigenie.pl/docs/linter/swagger/rules/contact-defined

A rule of the Swagger 2.0 linter, which reads Swagger 2.0 documents; OpenAPI 3 documents go to the OpenAPI linter. Since 0.9.0. In the rulesets: Strict at error, All at error.

This rule checks whether complete contact information is present in a
Swagger 2.0 document.

## Rule details

The `contact-defined` rule ensures that the `info.contact` object is defined
and that its `name`, `email` and `url` properties are all present and not
empty. Contact information tells consumers of the API whom to ask for help,
report problems to, or notify about their use of the API.

The rule reports:

- `Contact object is missing` when there is no `info.contact` object,
- `Contact name is missing or empty` when `name` is missing or empty,
- `Contact email is missing` when `email` is missing or empty,
- `Contact URL is missing` when `url` is missing or empty.

The OpenAPI and AsyncAPI linters have rules of the same name,
[contact-defined](/docs/linter/openapi/rules/contact-defined) and
[contact-defined](/docs/linter/asyncapi/rules/contact-defined).

Turn the rule off for APIs used only by the team that owns them.

## Examples

**Good**.

```yaml
swagger: '2.0'
info:
  title: Pet Store
  version: 1.0.0
  contact:
    name: Pet Platform Team
    email: pets@your-company.com
    url: https://your-company.com/teams/pets
paths: {}
```

**Bad**. The contact object is present, but it is not possible to reach the
team by email.

```yaml
swagger: '2.0'
info:
  title: Pet Store
  version: 1.0.0
  contact:
    name: Pet Platform Team
    url: https://your-company.com/teams/pets
paths: {}
```
