Change log:

1. Add trkd authentication notebook
2. Update README.md

Author: Wasin Waeosri

README.md

@@ -4,7 +4,12 @@ The [Thomson Reuters Knowledge Direct (TRKD) API](https://developers.thomsonreut
 
 TRKD offers a wide range of Refinitiv' information and services delivered in a request-response scenario via web services using today's industry standard protocols (SOAP/XML and REST/JSON). Connectivity can be via HTTP and HTTPS, over the Internet or Delivery Direct. All data are snapshot (non-streaming) data.
 
-This is an example project that shows how to implement TRKD HTTP JSON client and TRKD Streaming client with Python programming lanugage. This project contains the following example scripts for each TRKD services
+This is an example project that shows how to implement TRKD HTTP JSON client and TRKD Streaming client with Python programming lanugage. The project example are in both console and Jupyter Notebook applications.
+
+*Note:* The Jupyter Notebook example does not contain all the same TRKD services service as console example yet. [TBD]
+
+## Application Files
+This project contains the following example scripts for each TRKD services
 - trkd_authen.py: An example application that shows how to authenticate with TRKD service
 - trkd_quote.py: An example application that shows how to subscribe (all fields and specific fields) the Quote data from TRKD service
 - trkd_newsheadline.py: An example application that shows how to subscribe the News Headline data from TRKD service
@@ -14,20 +19,27 @@ This is an example project that shows how to implement TRKD HTTP JSON client and
 - trkd_onlinereport.py: An example application that shows how to subscribe the Online Report data from TRKD service
 - trkd_chart.py: An example application that shows how to subscribe and download the Chart image data from TRKD service
 - trkd_wsstreaming.py: An example application that show how to subscribe the Quote data from TRKD Streming service via a WebSocket connection
+- notebook folder:
+	- *notebook/trkd_authentication.ipynb*: A Jupyter Notebook TRKD Authentication service example
 - requestments.txt: A requirement file contains a list of required libraries for HTTP JSON and WebSocket connections. 
 - docs\TRKD_REST_with_Python.docx: A document that describes the trkd_authen.py and trkd_quote.py applications
 
 All source code and scripts are provided under the Apache 2.0 license. Thye are provided AS IS with no warranty or guarantee of fit for purpose. See the project's LICENSE.md for details. 
 
 ## Prerequisite
 The following softwares are required to use this script
+- TRKD API credentials. Please reach out to your Refinitiv sales associate to acquire TRKD access credentials.
 - Python 3 
 - The [requests](http://docs.python-requests.org/en/master/) library
 - The [websocket-client](https://pypi.org/project/websocket-client/) library (*version 0.49 or greater*, for trkd_wsstreaming.py application only)
 - The [python-dateutil](https://pypi.org/project/python-dateutil/) library (for trkd_wsstreaming.py application only)
+- [Jupyter Notebook](https://jupyter.org/) runtime (for the Notebook example application)
 
 All scripts support Python 3 and not compatible with Python 2.
 
+*Note:* 
+- You can install Jupyter Notebook on your local machine and then test the example on the machine. The alternate choice is a free Jupyter Notebook on cloud environment such as [Azure Notebook](https://notebooks.azure.com/) provided by Microsoft. You can find more details from [this tutorial](https://docs.microsoft.com/en-us/azure/notebooks/tutorial-create-run-jupyter-notebook). If you are not familiar with Jupyter Notebook, the following [tutorial](https://www.datacamp.com/community/tutorials/tutorial-jupyter-notebook) created by DataCamp may help.
+
 ## How to run the script
 Run the script via the command line (or shell)
 ```
@@ -95,3 +107,5 @@ For further details, please check out the following resources:
 	- Add License.md file
 - version 1.0.12: March 2019
 	- Change all scripts to print JSON message in beauty format.
+- version 1.5: July 2019
+	- Add TRKD Authentication Jupyter Notebook.

notebook/trkd_authentication.ipynb

@@ -1,14 +1,22 @@
 {
  "cells": [
   {
-   "cell_type": "code",
-   "execution_count": null,
+   "cell_type": "markdown",
    "metadata": {},
-   "outputs": [],
    "source": [
-    "# Install requests package in a current Jupyter kernal\n",
-    "import sys\n",
-    "!{sys.executable} -m pip install requests"
+    "# TRKD HTTP JSON with Python Example: Authentication\n",
+    "\n",
+    "## Overview\n",
+    "The [Thomson Reuters Knowledge Direct (TRKD) API](https://developers.thomsonreuters.com/thomson-reuters-knowledge-direct-trkd) integrates into your website, trading platform, company intranet/extranet, advisory portal and mobile applications to provide up-to-date financial market data, news and analytics and powerful investment tools.\n",
+    "\n",
+    "TRKD offers a wide range of Refinitiv' information and services delivered in a request-response scenario via web services using today's industry standard protocols (SOAP/XML and REST/JSON). Connectivity can be via HTTP and HTTPS, over the Internet or Delivery Direct. All data are snapshot (non-streaming) data.\n",
+    "\n",
+    "This is an example project that shows how to implement TRKD HTTP JSON client with Python programming lanugage in Jupyter Notebook.\n",
+    "\n",
+    "### TRKD JSON application implementation process\n",
+    "The JSON application requires the following steps to consume data from TRKD API services\n",
+    "1. Authentication with TRKD Authentication service to get an authen token\n",
+    "2. Send a request message with the required input information and authen token to the interested TRKD service"
    ]
   },
   {
@@ -17,10 +25,11 @@
    "metadata": {},
    "outputs": [],
    "source": [
-    "# import required libraries\n",
+    "# #uncomment if you do not have requests and websocket-client (version 0.49 and above) installed\n",
     "\n",
-    "import requests\n",
-    "import json"
+    "# # Install requests package in a current Jupyter kernal\n",
+    "# import sys\n",
+    "# !{sys.executable} -m pip install requests"
    ]
   },
   {
@@ -29,7 +38,10 @@
    "metadata": {},
    "outputs": [],
    "source": [
-    "# functions"
+    "# import required libraries\n",
+    "\n",
+    "import requests\n",
+    "import json"
    ]
   },
   {
@@ -83,6 +95,52 @@
     "expire = None"
    ]
   },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "#### TRKD Service Token Detail\n",
+    "##### TRKD Service Token URL and Header\n",
+    "\n",
+    "The URL enponint for the TRKD Service Token is following:\n",
+    "[https://api.trkd.thomsonreuters.com/api/TokenManagement/TokenManagement.svc/REST/Anonymous/TokenManagement_1/CreateServiceToken_1](https://api.trkd.thomsonreuters.com/api/TokenManagement/TokenManagement.svc/REST/Anonymous/TokenManagement_1/CreateServiceToken_1)\n",
+    "\n",
+    "Header: \n",
+    "- Content-type = application/json;charset=utf-8\n",
+    "Method:\n",
+    "- Post\n",
+    "\n",
+    "##### TRKD Service TOKEN Request Message\n",
+    "\n",
+    "The CreateServiceToken_1 operation requires the following information to perform authentication\n",
+    "- ApplicationID\n",
+    "- Username\n",
+    "- Password\n",
+    "\n",
+    "The request message structure is following\n",
+    "```\n",
+    "{\n",
+    "    “CreateServiceToken_Request_1”:{\n",
+    "      “ApplicationID”: <application id>,\n",
+    "      “Username”: <username>,\n",
+    "      “Password”: <password>\n",
+    "   }\n",
+    "}\n",
+    "\n",
+    "```\n",
+    "The example of the response message is shown below\n",
+    "```\n",
+    "{\n",
+    "  \"CreateServiceToken_Response_1\": {\n",
+    "    \"Expiration\": \"2016-09-26T09:42:54.4335265Z\",\n",
+    "    \"Token\": \"674E12E4EF35F181602672D5529D98379D4B42216057C7FF…\"\n",
+    "  }\n",
+    "}\n",
+    "```\n",
+    "- Token: an encrypted, expiring string that securely identifies the service user  (aka service Token)\n",
+    "- Expiration: Token expires after a configurable time period. The default expiration is 90 minutes."
+   ]
+  },
   {
    "cell_type": "code",
    "execution_count": null,
@@ -169,6 +227,27 @@
     "print('Expiration = %s' % expire)"
    ]
   },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Conclusion\n",
+    "All TRKD HTTP JSON applications require authenticaiton to access TRKD data. The application needs to request for Service Token from TRKD server, then keeps a response Service Token for later use in other request message header."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## <a href=\"references\"></a>References\n",
+    "For further details, please check out the following resources:\n",
+    "* [Thomson Reuters Knowledge Direct API page](https://developers.refinitiv.com/thomson-reuters-knowledge-direct-trkd) on the [Refinitiv Developer Community](https://developers.thomsonreuters.com/) web site.\n",
+    "* [Thomson Reuters Knowledge Direct API Catalog](https://www.trkd.thomsonreuters.com/SupportSite/RequestBuilder/requestbuilder.aspx) web site.\n",
+    "* TRKD Article: [How to implement TRKD JSON application with Python chapter 1: the basic](https://developers.refinitiv.com/article/how-implement-trkd-json-application-python-chapter-1-basic)\n",
+    "\n",
+    "For any question related to this tutorial or TRKD API, please use the Developer Community [Q&A Forum](https://community.developers.refinitiv.com/spaces/51/view.html)."
+   ]
+  },
   {
    "cell_type": "code",
    "execution_count": null,