서비스의 API는 서비스와 Client 사이의 계약이다. 여러분이 어떤 IPC 메커니즘을 선택했느냐에 상관없이 서비스의 API가 어떤 종류의 IDL(Interface Definition Language)을 사용하도록 정확하게 정의되었느냐가 중요하다. 서비스를 정의하기 위해 API-first Approach를 사용하는데 대한 좋은 논쟁들이 있다.(https://www.programmableweb.com/news/how-to-design-great-apis-api-first-design-and-raml/how-to/2015/07/10)

여러분은 서비스의 인터페이스를 정의하고, Client 개발자들과 함께 그것을 리뷰하면서 서비스 개발을 시작한다. 그것은 여러분이 구현한 서비스의 API 정의를 반복하는 것이다. 먼저 이렇게 디자인함으로써, Client의 요구사항을 더 많이 만족시킬 수 있는 여러분의 서비스를 구현할 수 있다.

이번 article의 후반부에서 볼 수 있겠지만, API 정의의 본질적인 부분은 여러분이 사용한 IPC 메커니즘에 달려 있다. 여러분이 messaging을 사용했다면, API는 message channel과 message type으로 구성되어 있다. 만약 HTTP를 사용했다면, API는 URL과 request, response format으로 구성되어 있다. 나중에 IDL에 대해 더 자세히 정리할 것이다.