Add more details in the "Contact" Object

For most people, email and url may be enough, but others - me, in today’s case - need more info like jobTitle/position, phone, companyName, and companyUrl. This may be important if we write API Specification for another company.

[MikeRalphson]

As you say, for most people (based also on issues here) the existing fields in the contact object are probably sufficient. As per the specification:

This object MAY be extended with Specification Extensions

so you can define and use such fields as x-job-title, x-phone within this object.

[darrelmiller]

@elharony Also, take a look at http://apisjson.org/ as it provides the ability to add a lot more information to an API. The apisjson spec can be used in combination with OpenAPI descriptions.