Introduction
What are Web APIs?
A way to access your data in real time
A way to automatically Add, Update, and Retrieve data from your database
A way to do it intuitively, thoroughly, and securely
Web API
API Standards
We use industry standards for programming Web APIs
Modeled after leading API design
Apigee Web API
Microsoft ASP.NET Web API
Internet Information Server (IIS) and HTTP Methodology
Put, Post, Delete, and Get methods
Standard HTTP Response Message Codes
2XX = Success Message
4XX = Error Message
REST versus SOAP
SOAP – Simple Object Access Protocol
SOAP is a method of transferring messages,
or small amounts of information, over the Internet.
These are formatted in XML and typically sent using HTTP.
REST – Representational State Transfer
REST is a method of transferring messages over the Internet
and it doesn’t have obtrusive standards defined.
These are formatted in XML, JSON, or plain text and typically sent using HTTP.
Comparing SOAP and REST
| Number of Array Elements | SOAP Message Size(byte) String Concatenation | REST Message Size(byte) String Concatenation | SOAP Time (milliseconds) String Concatenation | REST Time (milliseconds) String Concatenation |
|---|---|---|---|---|
| 2 | 351 | 39 (11%) | 781 | 359 (2.1x) |
| 2 | 351 | 39 (11%) | 781 | 359 (2.1x) |
| 3 | 371 | 48 (13%) | 828 | 344 (2.4x) |
| 4 | 395 | 63 (16%) | 828 | 359 (2.3x) |
| 5 | 418 | 76 (18%) | 969 | 360 (2.7x) |
Markit Adaptation
Markit WSO APIs
Markit WSO APIs
Intuitive URL
Resources and Actions
Actions determined by the header of the message
GET, PUT, POST, and DELETE
Associations
http://wso.com/SampleAPI/[resource]/[association]
http://wso.com/SampleAPI/BankDeals/1234
Documentation is the User Interface in order to facilitate autonomy
Security Master Layer
Items Included in Security Master API
Licensing and Security
Licensing
Each layer will be licensed
Each request will validate current licenses
Security
Stateless Basic Authentication in Request Header
Authentication uses Base-64 hashed Username/Password
Currently there is no support for State-full Authentication
Use Cases
Examples
Retrieve Bank Deal by Asset
http://wso.com/sampleAPI/Facilities/6/BankDeal - Get
Retrieve Assets in an Issuer
http://wso.com/sampleAPI/Issuers/237/Assets - Get
Add Ratings for an Asset
http://wso.com/sampleAPI/Assets/1823/Ratings - Post
Update Issuer Industry Code for S&P SIC: Amusement Parks
http://wso.com/sampleAPI/Issuers/237/SICs - Put