APIs should be shared with developers and partners so that they can be consumed for composite application development. Traditionally, the service information is documented in Wiki pages or internal company portals.
The downside of this approach is extra effort to document and manage the service specification and inability to share with partners outside the firewall.