Las APIs (Interfaz de programación de aplicaciones) como estrategia de liberación de datos estadísticos. Descripción de las APIs del Instituto de Estadística de Cataluña.

1. contra el apartheid de los datos Anatomía de las APIs del Idescat Xavier Badosa (@badosa) Instituto de Estadística de Cataluña Canarias, mayo 2011

2. Interfaz de programación de aplicaciones

3. Interfaz de programación de aplicaciones

4. Interfaz de programación de aplicaciones Interacción Humano Humano —

5. Interfaz de programación de aplicaciones Interacción Software — Humano

6. Interfaz de programación de aplicaciones Interacción Software — Software

7. Interfaz de programación de aplicaciones Interacción Software — Software

8. Interfaz de programación de aplicaciones API Interacción Software — Software

9. Interfaz de programación de aplicaciones API Web http Interacción Software — Software en la nube

10. Interfaz de programación de aplicaciones API Web http Interacción Software — Software en la nube

11. Interfaz de programación de aplicaciones API Web http Interacción Software — Software en la nube

12. Interfaz de programación de aplicaciones API Web http Servicios basados en SOAP Simple Object Access Protocol Interacción Software — Software en la nube

13. Interfaz de programación de aplicaciones API Web http Servicios basados en SOAP Simple Object Access Protocol RESTful Web Services RepresentationalState Transfer Interacción Software — Software en la nube

14. Interfaz de programación de aplicaciones API Web http Servicios basados en SOAP Protocolo Simple Object Access Protocol RESTful Web Services Arquitectura RepresentationalState Transfer Interacción Software — Software en la nube

20. 85% 15%

21. 85% 15%

22. 85% 15%

23. “The only reason you’d have only a SOAP API is because you hate 80% of your addressable market.” Sam Ramji (Apigee) 85% 15%

26. Open APIs: State of the Market (John Musser, ProgrammableWeb) http://www.slideshare.net/jmusser/open-api-ecosystem-overview-december-2010

27. Open APIs: State of the Market (John Musser, ProgrammableWeb) http://www.slideshare.net/jmusser/open-api-ecosystem-overview-december-2010

32. API Web

33. API Web Peticiones Puntos de acceso

34. API Web Peticiones Puntos de acceso Métodos

35. API Web Peticiones Puntos de acceso Métodos Leer GET Crear POST Actualizar PUT Eliminar DELETE

36. API Web Peticiones Puntos de acceso Métodos Autenticación

37. API Web Peticiones Puntos de acceso Métodos Autenticación Identidad Autenticación Autorización

38. API Web Peticiones Puntos de acceso Métodos Autenticación Restriccionestécnicas

39. API Web Respuestas Puntos de acceso Formatos Métodos Autenticación Restriccionestécnicas

40. API Web Puntos de acceso Formatos Métodos Autenticación Restriccionestécnicas

41. API Web Características de las APIs del Idescat Puntos de acceso Formatos Métodos Autenticación Restriccionestécnicas

42. API Web Características de las APIs del Idescat Puntos de acceso Formatos definidas en 2008 Métodos Autenticación Restriccionestécnicas

43. Puntos de acceso

44. http://api.idescat.cat Puntos de acceso

45. http://api.idescat.cat /servicio

46. http://api.idescat.cat /servicio /versión

47. http://api.idescat.cat /servicio /versión /operación

48. http://api.idescat.cat /servicio /versión /operación .formato

49. http://api.idescat.cat /servicio /versión /operación .formato ?parámetros

50. http://api.idescat.cat /servicio /versión /operación .formato ?parámetros http://api.idescat.cat/pob/v1/cerca.xml?q=abrera

51. http://api.idescat.cat/pob/v1/cerca.xml?q=abrera

52. Independencia de interfaz http://api.idescat.cat/pob/v1/cerca.xml?q=abrera

53. Independencia de interfaz Independencia de recursos http://api.idescat.cat/pob/v1/cerca.xml?q=abrera

54. Independencia de interfaz Independencia de recursos Limitación del uso interno en contextos sometidos a la política del mismo origen (p.e., Ajax) http://api.idescat.cat/pob/v1/cerca.xml?q=abrera

55. http://api.idescat.cat/pob/v1/cerca.xml?q=abrera

56. JSONP JSON withpadding http://api.idescat.cat/pob/v1/cerca.xml?q=abrera

57. http://api.idescat.cat/pob/v1/cerca.xml?q=abrera

58. Diversidad de soluciones (APIs) http://api.idescat.cat/pob/v1/cerca.xml?q=abrera

59. Diversidad de soluciones (APIs) Ausencia de una interfaz unificada http://api.idescat.cat/pob/v1/cerca.xml?q=abrera

60. Diversidad de soluciones (APIs) Ausencia de una interfaz unificada (Simplificar las operaciones) http://api.idescat.cat/pob/v1/cerca.xml?q=abrera

61. Diversidad de soluciones (APIs) (publicables gradualmente) Ausencia de una interfaz unificada (Simplificar las operaciones) http://api.idescat.cat/pob/v1/cerca.xml?q=abrera

62. Diversidad de soluciones (APIs) (publicables gradualmente) Ausencia de una interfaz unificada (Simplificar las operaciones) Una API mala es mejor que ninguna API http://api.idescat.cat/pob/v1/cerca.xml?q=abrera

63. Diversidad de soluciones (APIs) (publicables gradualmente) Ausencia de una interfaz unificada (Simplificar las operaciones) Una API mala es mejor que ninguna API Una buena API no harábueno un mal servicio http://api.idescat.cat/pob/v1/cerca.xml?q=abrera

64. Diversidad de soluciones (APIs) (publicables gradualmente) Ausencia de una interfaz unificada (Simplificar las operaciones) Una API mala es mejor que ninguna API Una buena API no harábueno un mal servicio http://api.idescat.cat/pob/v1/cerca.xml?q=abrera “Aunque la mona se vista de seda, mona se queda.”

65. http://api.idescat.cat/pob/v1/cerca.xml?q=abrera

66. Permanencia http://api.idescat.cat/pob/v1/cerca.xml?q=abrera

67. Permanencia Una API es un contrato http://api.idescat.cat/pob/v1/cerca.xml?q=abrera

68. Permanencia Una API es un contrato “PublicAPIsareforever” Joshua Bloch http://api.idescat.cat/pob/v1/cerca.xml?q=abrera

69. Permanencia Una API es un contrato indefinido “PublicAPIsareforever” Joshua Bloch http://api.idescat.cat/pob/v1/cerca.xml?q=abrera

70. Permanencia Una API es un contrato indefinido “PublicAPIsareforever” Joshua Bloch Versión 1.01: ampliación que no rompe la API http://api.idescat.cat/pob/v1/cerca.xml?q=abrera

71. http://api.idescat.cat/pob/v1/cerca.xml?q=abrera

72. Diversidad de operaciones http://api.idescat.cat/pob/v1/cerca.xml?q=abrera

73. Diversidad de operaciones Vocabulariorestringido http://api.idescat.cat/pob/v1/cerca.xml?q=abrera

74. Diversidad de operaciones Vocabulariorestringido (que en parte determina la estructura de la respuesta) http://api.idescat.cat/pob/v1/cerca.xml?q=abrera

75. Diversidad de operaciones Vocabulariorestringido (que en parte determina la estructura de la respuesta) “An API is a littlelanguage” Joshua Bloch http://api.idescat.cat/pob/v1/cerca.xml?q=abrera

76. Diversidad de operaciones Vocabulariorestringido (que en parte determina la estructura de la respuesta) “An API is a littlelanguage” Joshua Bloch ¿Vocabularioambiguo? http://api.idescat.cat/pob/v1/cerca.xml?q=abrera

77. Vocabulariorestringido nodes Dame los nodos ¿Qué recursos (objetos, elementos, átomos) hay? ¿Cómo se clasifican? ¿Quétiposhay? ¿Cómo se identifican? Dame la lista de recursos http://api.idescat.cat/pob/v1/cerca.xml?q=abrera

78. Vocabulariorestringido nodes http://api.idescat.cat/pob/v1/cerca.json?q=abrera

79. Vocabulariorestringido dades Dame los datos asociados a un nodo(s) ¿Cuáles son los datos y metadatosasociados a un recurso? Dame (la información de) un recurso Suele requerir conocersu identificador http://api.idescat.cat/pob/v1/cerca.xml?q=abrera nodes

80. Vocabulariorestringido dades http://api.idescat.cat/pob/v1/cerca.xml?q=abrera nodes

81. Vocabulariorestringido cerca Dame los resultados de una búsqueda ¿Cuáles son los recursos que cumplen una búsquedaabierta? Suele requerir especificar una cadena o algúntipo de filtro. Puede ser sustitutivo de nodes si hay un número grande de ellos. http://api.idescat.cat/pob/v1/cerca.xml?q=abrera nodes dades

82. Vocabulariorestringido cerca http://api.idescat.cat/pob/v1/cerca.xml?q=abrera nodes dades

83. Vocabulariorestringido cerca Atom http://api.idescat.cat/pob/v1/cerca.xml?q=abrera nodes dades

84. Vocabulariorestringido cerca Atom OpenSearchResponse http://api.idescat.cat/pob/v1/cerca.xml?q=abrera nodes dades

85. Vocabulariorestringido cerca Atom OpenSearchResponse SDMX http://api.idescat.cat/pob/v1/cerca.xml?q=abrera nodes dades

86. Vocabulariorestringido sug Sugiéremeliterales de elementos Suele requerir especificar una cadena o algúntipo de filtro. Devuelveliteralescompletos, no datos o metadatos. http://api.idescat.cat/pob/v1/cerca.xml?q=abrera nodes dades cerca

87. Vocabulariorestringido sug http://api.idescat.cat/pob/v1/cerca.xml?q=abrera nodes dades cerca

88. Vocabulariorestringido sug OpenSearch Suggestions http://api.idescat.cat/pob/v1/cerca.xml?q=abrera nodes dades cerca

89. http://api.idescat.cat/pob/v1/cerca.xml?q=abrera sug nodes dades cerca

90. http://api.idescat.cat/pob/v1/cerca.xml?q=abrera sug nodes dades cerca

91. http://api.idescat.cat/pob/v1/cerca.xml?q=abrera sug nodes dades cerca

92. http://api.idescat.cat/pob/v1/cerca.xml?q=abrera sug nodes dades cerca

93. Ajax Política del mismo origen http://api.idescat.cat/pob/v1/cerca.xml?q=abrera sug nodes dades cerca

94. Ajax Política del mismo origen Puentear http://www.idescat.cat/api/... http://api.idescat.cat/pob/v1/cerca.xml?q=abrera sug nodes dades cerca

95. Vocabulariorestringido Dame las categorías ¿Cómo se etiquetan los recursos? ¿Quécategorizacionesexisten y cuáles son suscaracterísticas? Dame la lista de categorizaciones o categorías http://api.idescat.cat/pob/v1/cerca.xml?q=abrera sug nodes dades cerca categories

96. http://api.idescat.cat/pob/v1/cerca.xml?q=abrera

97. API Web Puntos de acceso Formatos Métodos Autenticación Restriccionestécnicas http://api.idescat.cat/pob/v1/cerca.xml?q=abrera

98. API Web Puntos de acceso Formatos (Una API es un contrato: el resultado de su uso es una coproducción) Métodos Autenticación Restriccionestécnicas http://api.idescat.cat/pob/v1/cerca.xml?q=abrera

99. API Web XML

100. API Web XML ecosistema

101. API Web XML ecosistema XSLT

102. API Web XML PHP

103. API Web XML OpenSocial (JS)

104. API Web XML OpenSocial (JS)

105. http://google-styleguide.googlecode.com/svn/trunk/xmlstyle.html

106. http://google-styleguide.googlecode.com/svn/trunk/xmlstyle.html

107. http://www.dataspora.com/2009/08/xml-and-big-data/

108. http://www.dataspora.com/2009/08/xml-and-big-data/

109. http://www.dataspora.com/2009/08/xml-and-big-data/

110. http://blog.jclark.com/2010/11/xml-vs-web_24.html

111. http://blog.jclark.com/2010/11/xml-vs-web_24.html

113. https://graph.facebook.com/badosa

114. Open APIs: State of the Market (John Musser, ProgrammableWeb) http://www.slideshare.net/jmusser/open-api-ecosystem-overview-december-2010

121. Elementos = atributos

122. API Web JSON

123. API Web JSON JS

124. API Web XMLHttpRequest() JSON Política del mismo origen JS

125. API Web P JSON

126. API Web P JSON

127. callback API Web P JSON

128. callback API Web P JSON mifuncion({"indicadors":{"p":"tt=0;max=1;min=1;","n":"1","o":"dades" ... })

129. is_array($o->indicadors->i) API Web PHPserializado

130. is_array($o->indicadors->i) API Web PHPserializado

131. is_array($o->indicadors->i) API Web PHPserializado

132. is_array($o->indicadors->i) Si no existe un estándar que especifique una respuesta para cada formato API Web

133. is_array($o->indicadors->i) Si no existe un estándar que especifique una respuesta para cada formato API Web XML

134. is_array($o->indicadors->i) Si no existe un estándar que especifique una respuesta para cada formato API Web XML JSON

135. is_array($o->indicadors->i) Si no existe un estándar que especifique una respuesta para cada formato API Web XML JSON PHP ...

136. is_array($o->indicadors->i) Si no existe un estándar que especifique una respuesta para cada formato API Web XML + fácilgeneración + fácildocumentación JSON PHP ...

137. is_array($o->indicadors->i) Si no existe un estándar que especifique una respuesta para cada formato API Web XML + fácilgeneración + fácildocumentación JSON XML JSONificado (o JSON con sabor a XML) PHP ...

138. is_array($o->indicadors->i) Si no existe un estándar que especifique una respuesta para cada formato API Web XML + fácilgeneración + fácildocumentación JSON XML JSONificado (o JSON con sabor a XML) PHP ... ... XML JSONificadoPHPizado

139. is_array($o->indicadors->i) Si no existe un estándar que especifique una respuesta para cada formato API Web XML JSON Modelo general de representación interna PHP ...

140. is_array($o->indicadors->i) Si no existe un estándar que especifique una respuesta para cada formato API Web XML Plantillas JSON Modelo general de representación interna PHP ... Plantillas

141. is_array($o->indicadors->i) Un caso en el que existe un estándar que especifica una respuesta para cada formato API Web

142. is_array($o->indicadors->i) Un caso en el que existe un estándar que especifica una respuesta para cada formato API Web OpenSearch Suggestions

143. FF:JSON IE8:XML

144. FF:JSON IE8:XML

145. FF:JSON IE8:XML jquery / Autocomplete: TXT

146. http://api.idescat.cat/pob/v1/sug.txt?q=ab jquery / Autocomplete: TXT

147. http://api.idescat.cat/pob/v1/sug.txt?q=ab jquery / Autocomplete: TXT

148. http://api.idescat.cat /servicio /versión /operación .formato ?parámetros http://api.idescat.cat/pob/v1/cerca.xml?q=abrera

149. Parámetros generales callback (si json) ca, es, en lang enc utf-8, iso-8859-1 http://api.idescat.cat/pob/v1/cerca.xml?q=abrera

150. Parámetros generales callback (si json) ca, es, en lang enc utf-8, iso-8859-1 incluso si json…

151. enc utf-8, iso-8859-1 incluso si json… (pero no php)

152. Una API es un proyecto en colaboración enc utf-8, iso-8859-1 incluso si json… (pero no php)

153. Algunos parámetros comunes id, i identificador

154. Algunos parámetros comunes id, i identificador http://api.idescat.cat/emex/v1/dades.xml?id=250019 Dame (la información de) el recurso 250019

155. Algunos parámetros comunes id, i identificador http://api.idescat.cat/emex/v1/dades.xml?id=250019 Dame (la información de) el recurso 250019 ? http://api.idescat.cat/emex/v2/municipios/250019.xml

156. Algunos parámetros comunes id, i identificador http://api.idescat.cat/emex/v1/dades.xml?id=250019 Dame (la información de) el recurso 250019 ? http://api.idescat.cat/emex/v2/municipios/250019.xml http://api.idescat.cat/emex/v2/comarcas/01.xml

157. Algunos parámetros comunes id, i identificador http://api.idescat.cat/emex/v1/dades.xml?id=250019 Dame (la información de) el recurso 250019 ? http://api.idescat.cat/emex/v2/municipios/250019.xml http://api.idescat.cat/emex/v2/comarcas/01.xml http://api.idescat.cat/emex/v2/geo/01.xml

158. Algunos parámetros comunes id, i identificador http://api.idescat.cat/emex/v1/dades.xml?id=250019 Dame (la información de) el recurso 250019 ? http://api.idescat.cat/emex/v2/municipios/250019.xml http://api.idescat.cat/emex/v2/comarcas/01.xml http://api.idescat.cat/emex/v2/geo/comarcas/01.xml

159. Algunos parámetros comunes id, i identificador http://api.idescat.cat/emex/v1/dades.xml?id=250019 Dame (la información de) el recurso 250019 ? http://api.idescat.cat/emex/v2/municipios/250019.xml http://api.idescat.cat/emex/v2/comarcas/01.xml http://api.idescat.cat/emex/v2/geo/comarcas/01.xml + amigable + fácil analítica + vocabulario

160. Algunos parámetros comunes http://api.idescat.cat/onomastica-nombres/v1/dades...

161. Algunos parámetros comunes http://api.idescat.cat/onomastica-nombres/v1/dades... http://api.idescat.cat/onomastica/nombres/v1/dades...

162. Algunos parámetros comunes http://api.idescat.cat/onomastica-nombres/v1/dades... http://api.idescat.cat/onomastica/nombres/v1/dades... http://api.idescat.cat/onomastica/v1/nombres/dades...

163. Algunos parámetros comunes http://api.idescat.cat/onomastica-nombres/v1/dades... http://api.idescat.cat/onomastica/nombres/v1/dades... http://api.idescat.cat/onomastica/v1/nombres/dades... ? http://api.idescat.cat/ono.../v1/nombres/xavier.xml

164. Algunos parámetros comunes http://api.idescat.cat/onomastica-nombres/v1/dades... http://api.idescat.cat/onomastica/nombres/v1/dades... http://api.idescat.cat/onomastica/v1/nombres/dades... ? http://api.idescat.cat/ono.../v1/nombres/xavier.xml http://api.idescat.cat/ono.../v1/apellidos/badosa.xml

165. Algunos parámetros comunes http://api.idescat.cat/emex/v1/nodes.xml Dame la lista de recursos

166. Algunos parámetros comunes http://api.idescat.cat/emex/v1/nodes.xml Dame la lista de recursos ? http://api.idescat.cat/emex/v2/geo.xml http://api.idescat.cat/emex/v2/geo/comarcas.xml

167. Algunos parámetros comunes http://api.idescat.cat/pob/v1/cerca.xml?q=abrera

168. Algunos parámetros comunes http://api.idescat.cat/pob/v1/cerca.xml?q=abrera ? http://api.idescat.cat/pob/v2/geo.xml?q=abrera

169. Algunos parámetros comunes v2, v1? http://api.idescat.cat/pob/v1/cerca.xml?q=abrera ? http://api.idescat.cat/pob/v2/geo.xml?q=abrera

170. Algunos parámetros comunes http://api.idescat.cat/rect.../v1/categories.xml http://api.idescat.cat/rect.../v1/categories.xml?id=tema

171. Algunos parámetros comunes http://api.idescat.cat/rect.../v1/categories.xml http://api.idescat.cat/rect.../v1/categories.xml?id=tema ? http://api.idescat.cat/rect.../v1/categories.xml http://api.idescat.cat/rect.../v1/categories/temes.xml

172. Algunos parámetros comunes cadena abierta q http://api.idescat.cat/pob/v1/cerca.xml?q=abrera

173. Algunos parámetros comunes posicio paginación http://api.idescat.cat/pob/v1/cerca.xml?q=a &posicio=0

174. Algunos parámetros comunes limit posicio paginación (offset) http://api.idescat.cat/pob/v1/cerca.xml?q=a &posicio=0

175. API Web Puntos de acceso Formatos Métodos Autenticación Restriccionestécnicas

176. API Web Puntos de acceso Formatos Métodos Autenticación Restriccionestécnicas Dame los nodos Dame los datos Dame los resultados de la búsqueda Damesugerencias Damecategorías

177. API Web Puntos de acceso Formatos GET Métodos Autenticación Restriccionestécnicas Dame los nodos Dame los datos Dame los resultados de la búsqueda Damesugerencias Damecategorías

178. API Web Puntos de acceso Formatos Métodos Autenticación Restriccionestécnicas

179. API Web Puntos de acceso Formatos Tan abierto como el sitio web Métodos Autenticación Restriccionestécnicas

180. API Web Puntos de acceso Formatos Tan abierto como el sitio web Métodos Autenticación Restriccionestécnicas ↓ analítica

181. API Web Puntos de acceso Formatos Métodos Autenticación Restriccionestécnicas

182. API Web Puntos de acceso El Idescat se reserva el derecho de limitar las peticiones repetidas desde un mismo origen para garantizar el acceso al servicio para todo el mundo. Es responsabilidad del cliente emplear los mecanismos nece-sarios para evitar peticiones de la misma información en espacios de tiempo breve. El uso excesivo puede ocasionar la finaliza-ción del servicio. Si piensa hacer un uso intensivo de las APIs del Idescat póngase en contacto con el Idescat a fin de poder garantizar que este uso no perjudicará la disponibilidad general del servicio. Formatos Métodos Autenticación Restriccionestécnicas

183. API Web Puntos de acceso El Idescat se reserva el derecho de limitar las peticiones repetidas desde un mismo origen para garantizar el acceso al servicio para todo el mundo. Es responsabilidad del cliente emplear los mecanismos nece-sarios para evitar peticiones de la misma información en espacios de tiempo breve. El uso excesivo puede ocasionar la finaliza-ción del servicio. Si piensa hacer un uso intensivo de las APIs del Idescat póngase en contacto con el Idescat a fin de poder garantizar que este uso no perjudicará la disponibilidad general del servicio. Formatos Métodos Autenticación Restriccionestécnicas inespecíficas

184. 1,2,3,4… Infraestructura cache proxy Interfaz Homogeneización, simplificación, gestión de errores… Caché Eficiencia Estadísticas

185. Infraestructura cache proxy

186. Infraestructura http://www.idescat.cat/api/ Documentación cache proxy

187. Infraestructura http://www.idescat.cat/api/ Documentación cache proxy

188. Infraestructura http://www.idescat.cat/api/ Documentación Galerías Herramientas cache proxy

193. http://bitworking.org/news/193/Do-we-need-WADL

194. Infraestructura http://www.idescat.cat/api/ Documentación Galería Herramientas cache proxy Participación

195. Infraestructura http://www.idescat.cat/api/ Documentación Galería Herramientas cache proxy Participación Condiciones de uso

201. G R A C I A S

202. International Solidarity Movement North Carolina Olancho Aid