Continuing on the theory\ncovered in this course,\nthis part will talk about application programming interfaces\n(APIs) and web services.
\n\nAPIs define how programs can be used by other programs. An API defines how methods are called and what feedback\nyou can expect. It basically is the combination of documentation and the program itself. But, unlike any piece\nof software, an API is aimed at users, rather than use in the same program. The API is how you communicate\nbetween programs.
\n\nNow, in this course we will see two key types of APIs. The first are the APIs provided by the libraries that we\nuse. For example, we already indicated that we will be using at least the following two libraries,\nops.js and d3.js.\nThese libraries are a collection of functional bits (e.g. classes and methods). For example, ops.js\ndefines an API which wraps closely the Open PHACTS Linked Data API\n(LDA) itself. The API requires as to do a few things: 1. create a wrapper for the LDA; 2. define a\ncall back function; 3. invoke the actual
\n\ncall.var searcher = new Openphacts.ConceptWikiSearch(\n \"https://beta.openphacts.org\", appID, appKey\n); \nvar callback=function(success, status, response){ \n searcher.parseResponse(response);\n}; \nsearcher.findCompounds('Aspirin', '20', '4', callback);\nWeb services are a special kind of APIs: they expose an API over the web. That imposes some features of\nthese APIs: first, they are based on a web transport layer, commonly\nHTTP, but\nXMPP is possible too. HTTP is used by your web browser too. Secondly,\nthe web server needs a common communication language to serialize the method call. Here, two key standards\nare used, XML and JSON.\nWe will cover these in more detail later. For now, it suffices to think of these as\nenvelopes in which are message is sent. Now, another aspect standardized is how to call the web services.\nFor that, SOAP and REST are\nthe most important standards for the life sciences (though I still think\nWagener’s XMPP approach is still\nworthwhile checking out!). SOAP and REST use XML and JSON are underlying serialization format.
\n\nSo, web services are theoretically complex. For this course, most of it is hidden by the client library that will take care of the HTTP and SOAP/REST layers. The students who wish to use Java instead of JavaScript, will face the problem that you first need to find a Java client library for the LDA. There is this library, but that needs exploring for use with the latest Open PHACTS LDA. Higher stakes, higher rewards.
\n\nPractically, you do not need to know much of the technologies behind web services, just like you do not need to know machine instructions CPUs follow to run your program. But, it is important to have seen these terms. You will run into them, and need enough context to know where and how to find answers to the questions that you will have.
\n\nThere is one exception: JavaScript Object Notation, JSON. That is the format in which the data is returned by the service, and you will have to handle that. JSON will be the topic of the next post.
\n\n