Modeling RESTful Conversations with Extended BPMN Choreography Diagrams

  • Cesare Pautasso
  • Ana IvanchikjEmail author
  • Silvia Schreier
Conference paper
Part of the Lecture Notes in Computer Science book series (LNCS, volume 9278)


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.


RESTful web services Conversations BPMN choreography Modeling notation extension 


Unable to display preview. Download preview PDF.

Unable to display preview. Download preview PDF.


  1. 1.
    Hohpe, G.: Let’s have a conversation. IEEE Internet Computing 11(3), 78–81 (2007)CrossRefGoogle Scholar
  2. 2.
    Barros, A., Dumas, M., ter Hofstede, A.H.M.: Service interaction patterns. In: van der Aalst, W.M.P., Benatallah, B., Casati, F., Curbera, F. (eds.) BPM 2005. LNCS, vol. 3649, pp. 302–318. Springer, Heidelberg (2005) CrossRefGoogle Scholar
  3. 3.
    Benatallah, B., Casati, F., et al.: Web service conversation modeling: A cornerstone for e-business automation. IEEE Internet Computing 8(1), 46–54 (2004)CrossRefGoogle Scholar
  4. 4.
    Völter, M., Kircher, M., Zdun, U.: Remoting patterns: foundations of enterprise, internet and realtime distributed object middleware. Wiley, Chichester (2013) Google Scholar
  5. 5.
    Richardson, L., Amundsen, M., Ruby, S.: RESTful Web APIs. O’Reilly, Sebastopol (2013) Google Scholar
  6. 6.
    Fielding, R.T.: Architectural Styles and the Design of Network-based Software Architectures. PhD thesis, University of California, Irvine (2000)Google Scholar
  7. 7.
    Haupt, F., Leymann, F., Pautasso, C.: A conversation based approach for modeling REST APIs. In: 12th WICSA, Montreal, Canada, pp. 1–9. ACM, May 2015Google Scholar
  8. 8.
    Weske, M.: Business Process Management: Concepts, Languages, and Architectures, 2nd edn. Springer, Heidelberg (2012) CrossRefGoogle Scholar
  9. 9.
    Amundsen, M.: Building Hypermedia APIs with HTML5 and Node. O’Reilly, Sebastopol (2011) Google Scholar
  10. 10.
    Pautasso, C.: BPMN for REST. In: Dijkman, R., Hofstetter, J., Koehler, J. (eds.) BPMN 2011. LNBIP, vol. 95, pp. 74–87. Springer, Heidelberg (2011) CrossRefGoogle Scholar
  11. 11.
    Nottingham, M.: Web linking. Internet RFC 5988, October 2010Google Scholar
  12. 12.
    Zuzak, I., Budiselic, I., Delac, G.: A finite-state machine approach for modeling and analyzing RESTful systems. J. Web Eng. 10(4), 353–390 (2011)Google Scholar
  13. 13.
    Zaha, J.M., Barros, A., Dumas, M., ter Hofstede, A.: Let’s dance: a language for service behavior modeling. In: Meersman, R., Tari, Z. (eds.) OTM 2006. LNCS, vol. 4275, pp. 145–162. Springer, Heidelberg (2006) CrossRefGoogle Scholar
  14. 14.
    Decker, G., Barros, A.: Interaction modeling using BPMN. In: ter Hofstede, A.H.M., Benatallah, B., Paik, H.-Y. (eds.) BPM Workshops 2007. LNCS, vol. 4928, pp. 208–219. Springer, Heidelberg (2008) CrossRefGoogle Scholar
  15. 15.
    Jordan, D., Evdemon, J.: Business process model and notation (BPMN) version 2.0. OMG (2011).
  16. 16.
    Lindland, O., Sindre, G., Solvberg, A.: Understanding quality in conceptual modeling. IEEE Software 11(2), 42–49 (1994)CrossRefGoogle Scholar
  17. 17.
    Cortes-Cornax, M., Dupuy-Chessa, S., Rieu, D., Dumas, M.: Evaluating choreographies in BPMN 2.0 using an extended quality framework. In: Dijkman, R., Hofstetter, J., Koehler, J. (eds.) BPMN 2011. LNBIP, vol. 95, pp. 103–117. Springer, Heidelberg (2011) CrossRefGoogle Scholar
  18. 18.
    Robinson, S., Brooks, R., Kotiadis, K., Van Der Zee, D.J.: Conceptual modeling for discrete-event simulation. CRC Press Inc., Boca Raton (2010) CrossRefzbMATHGoogle Scholar

Copyright information

© Springer International Publishing Switzerland 2015

Authors and Affiliations

  • Cesare Pautasso
    • 1
  • Ana Ivanchikj
    • 1
    Email author
  • Silvia Schreier
    • 2
  1. 1.Faculty of InformaticsUniversity of Lugano (USI)LuganoSwitzerland
  2. 2.innoQ Deutschland GmbHMonheimGermany

Personalised recommendations