Modeling RESTful Conversations with extended BPMN Choreography diagrams

TitleModeling RESTful Conversations with extended BPMN Choreography diagrams
Publication TypeConference Paper
Year of Publication2015
AuthorsPautasso, C., A. Ivanchikj, and S. Schreier
Conference Name9th European Conference on Software Architecture (ECSA 2015)
Conference LocationDubrovnik, Croatia
KeywordsBPMN Choreography, REST, RESTful conversation

RESTful Web APIs often make use of multiple basic HTTP interactions to guide clients towards their goal. For example, clients may get redirected towards related resources by means of hypermedia controls such as links. Existing modeling approaches for describing RESTful APIs expose low-level HTTP details that help developers construct individual requests and parse the corresponding responses. However, very little attention has been given to high-level modeling of RESTful conversations, which abstracts the structure of multiple HTTP interactions. To address such issue in this paper we introduce an extension of the notation used in BPMN choreography diagrams. Its purpose is to represent concisely all possible interaction sequences in a given RESTful conversation.

Citation Keyecsa2015:restcon
Full Text

RESTful Conversation Survey

Help us evaluate a new visual notation for representing RESTful conversations, all possible correct sequences of interactions with a RESTful API, by answering this survey.

Your feedback to our research is greatly appreciated.