Technical workshop, presented by Gerald Martinez, Product Development Manager at Apex Tech, that aim and dive through interactive demonstrations of the building blocks of a Web 2.0 application. Explaining the use of the APEX RESTful API using C# and JQuery.

1. RETO 2.0Workshop#2: How to create a Web 2.0 Mash-up using the ENDIAPI and Open API’s. APEX Team:Gerald Martinez

2. ENDIAPI

3. Mashups Is a web page or application that uses or combines data or functionality from two or many more external sources to create a new service. Examples: http://twittervision.com/ http://bcdef.org/flappr/ http://www.tsmaps.com

4. Purpose of the ENDIAPI Maximize the potential of El Nuevo Día primary asset: Content Creation Expand the boundaries of Content Syndication Reach New Content Delivery Platforms.

5. Architectural Design ENDIAPI WWW Print Mobile Mashups Widgets ENDI DB

6. RESTful API REST - Representational State Transfer is a style of software architecture for distributed hypermedia systems such as the World Wide Web. REST-style architectures consist of clients and servers. Clients initiate requests to servers; servers process requests and return appropriate responses. REST was initially described in the context of HTTP, but is not limited to that protocol REST over HTTP works with and enhances the native HTTP verbs, URI’s, request and response headers, request and response codes, etc.

7. RESTful API A RESTful web service (also called a RESTful web API) is a simple web service implemented using HTTP and the principles of REST. It is a collection of resources, with three defined aspects: the base URI for the web service, such as http://api.elnuevodia.com/resources/. the MIME type of the data supported by the web service. This is often JSON, XML or YAML but can be any other valid MIME type. the set of operations supported by the web service using HTTP methods (e.g., POST, GET, PUT or DELETE).

8. JSON JavaScript Object Notation, is a lightweight computer data interchange format. It is a text-based, human-readable format for representing simple data structures and associative arrays (called objects). The JSON format is often used for serialization and transmitting structured data over a network connection. Its main application is in Ajax web application programming, where it serves as an alternative to the XML format. Resource: http://www.json.org

9. JSON vs. XML http://api.elnuevodia.com/sections/ { "id" : 3445, "name" : "Noticias", "url" : "/noticias", "subsections" : [ { "id" : 3453, "name" : "CienciayTecnología", "url" : "/subseccion--ciencia" }, { "id" : 3465, "name" : "Mundiales", "url" : "/subseccion--mundiales" }, { "id" : 3455, "name" : "Política", "url" : "/subseccion--politica" } ] } <sections> <id>3445</id> <name>Noticias</name> <url>/noticias</url> <subsections> <id>3453</id> <name>CienciayTecnología</name> <url>/subseccion—ciencia</url> <id>3465</id> <name>Mundiales</name> <url>/subseccion—mundiales</url> <id>3455</id> <name>Política</name> <url>/subseccion—politica</url> </subsections> </sections>

10. ENDIAPI Documentation Uses HTTP Basic Authentication Rate Limiting: Clients are allowed 100 requests per 60 sixty minute time period, starting from their first request. Pagination Limiting: Clients may request up to the last 31 days of news articles via the page and count parameters. Resources Available: Sections, News, Comments, UltimaHora, Horoscope, Movies, Climate and others. Debug curl -u <username>:<password> –H “api_key: <APIKey>” http://api.elnuevodia.com/sections/ Reference http://www.apex.pr/reto/documents.htm

11. ENDIAPI – C# Sample Code using System; usingSystem.Web; usingSystem.IO; usingSystem.Net; usingSystem.Text; // Create the web request HttpWebRequest request = WebRequest.Create("http://api.elnuevodia.com/news/") asHttpWebRequest; // Add pre authentication to request request.PreAuthenticate = true; // Add Authorization header request.Headers.Add(HttpRequestHeader.Authorization, "Basic " + Convert.ToBase64String( new UTF8Encoding().GetBytes(String.Format("{0}:{1}", "<Username>", "Password")))); // Add API Key to header request.Headers.Add(String.Format("api_key:{0}", "<API Key>")); // Get response using (HttpWebResponse response = request.GetResponse() asHttpWebResponse) { // Get the response stream StreamReader reader = newStreamReader(response.GetResponseStream()); // Console application output Console.WriteLine(reader.ReadToEnd());

13. References:http://reto.apex.pr/apex-api/ http://www.zemanta.com http://www.jquery.com

14. Questions

15. Contacts http://reto.apex.pr/contact-us/ Apex Team gmartinez gerald.martinez@apex.pr carlosgmercado carlos.mercado@apex.pr