Osoigo API documentation version 0.2
https://www.osoigo.com/api
Introducción
Bienvenios a la API de osoigo.com
Esta API le permite acceder al contenido de la página web osoigo.com.
Las operaciones permitidas en esta versión del API:
- Se puede acceder a la información de políticos y preguntas (y sus correspondientes respuestas).
- Creación de usuarios y preguntas.
Todo el API está dividido en tres grandes rutas:
- /politicians: Acceder a la información de los políticos y creación de preguntas (relacionada a un político).
- /questions: Acceder a la información de las preguntas.
- /users: Creación y autentificación de usuarios.
Versionamiento de la API y formato de la respuesta (Cabecera HTTP Accept)
Utilizando la cabecera Accept en la petición HTTP se le puede indicar a la API que versión de la misma queremos utilizar y en que formato queremos que nos devuelva la información.
La sintaxis ha utilizar es "{formato}; version={version}" donde:
- {formato}: El formato en el que queremos recibir la respuesta. Aceptados: application/json o application/xml
- {version}: La versión de la API a utilizar: 0.1, 0.2...
Ejemplos:
- application/json; version=0.2 : Indicamos que utilizaremos la versión 0.2 de la API y que la respuesta lo queremos en formato JSON.
- application/xml; version=0.2 : Indicamos que utilizaremos la versión 0.2 de la API y que la respuesta lo queremos en formato XML.
- application/json; version=0.1 : Indicamos que utilizaremos la versión 0.1 de la API y que la respuesta lo queremos en formato JSON.
Todas las posibilidades soportadas por la API se pueden ver accediendo al recurso /versions.
Por defecto la API utiliza la última versión disponible (0.2).
Versiones anteriores:
Gestionando colecciones
Las colecciones se pueden filtrar, ordenar... Para lo cual tenemos los siguientes filtros genericos:
- offset La posición a partir de la cual se devolveran los resultados.
- limit Cuantos resultados queremos que nos sean devueltos.
- sort Criterios de ordenación. Ver el apartado Ordenación de resultados.
- filter Filtrado de resultados. Ver el apartado Filtrado de resultados.
Ordenación de resultados
Para ordenar los resultados existe el parámetro sort. En la cual debemos enviar los criterios de ordenación separados por el carácter barra verical (|). También se puede indicar que queremos ordenarlos en sentido inverso (descendente), precediendo el critorio con el signo negativo (-).
Por ejemplo si queremos ordenar por apellido ascendente y nombre descendente: sort=last_name|-first_name
Filtrado de resultados
Los parametros para filtrar los resultados no se pueden enviar directamente. Para ello hay que utilizar el parámetro filter, concatenando los diferentes filtros dentro de ella. Por ejemplo: filter="first_name::Pedro|party::PSOE"
Tenemos la posibilidad de hacer búsquedas de tipo cast utilizando el carácter asterisco (*). Por ejemplo si queremos buscar politicos que empiezen con el nombre 'car' tendríamos que pasar el siguiente filtro: filter="first_name::car*"
Cada búsqueda de colecciones soporta sus propios filtros. Los cuales se especifican detalladamente dentro de cada método.
Versiones de la API
Operaciones ligadas con las versiones de la API
get
Devuelve una lista con todas las conbinaciones posibles entre versiones y formatos disponibles de la API.
get /versions
Devuelve una lista con todas las conbinaciones posibles entre versiones y formatos disponibles de la API.
HTTP status code 200
Devuelve la lista completa de versiones y formatos
Body
Type: application/json
Example:
{
"status": 200,
"data": [
"application\/json; version=0.1",
"application\/xml; version=0.1",
"application\/json; version=0.2",
"application\/xml; version=0.2"
]
}Type: application/xml
Example:
<?xml version="1.0"?>
<response>
<status>200</status>
<data>
<data-item>application/json; version=0.1</data-item>
<data-item>application/xml; version=0.1</data-item>
<data-item>application/json; version=0.2</data-item>
<data-item>application/xml; version=0.2</data-item>
</data>
</response>Políticos
Operaciones ligadas a políticos
get
Devuelve el listado de los políticos
get /politicians
Devuelve el listado de los políticos
Query Parameters
- sort: (string )
Criterios de ordenación.
- offset: (integer )
La posición a partir de la cual se devolveran los resultados.
- limit: (integer )
Cuantos resultados queremos que nos sean devueltos.
- first_name: (string )
Filtrar por el nombre
- last_name: (string )
Filtrar por el apellido
- party: (string )
Filtrar por el nombre del partido
HTTP status code 200
Body
Type: application/json
Example:
{
"status": 200,
"data": [
{
"id": "833",
"created_at": {
"date": "2014-08-27 12:26:15",
"timezone_type": 3,
"timezone": "Europe\/Madrid"
},
"first_name": "Juanjo",
"last_name": "Agirrezabala",
"charge": "Vicepresidente de la Mesa del Parlamento Vasco (EH Bildu)",
"bio": "<p>Soy licenciado en Magisterio y Ciencias de la Educaci\u00f3n. En el \u00e1mbito de la educaci\u00f3n he ejercido varios cargos: soy funcionario, he sido Delegado Territorial en Gipuzkoa, director de Innovaci\u00f3n en la Educaci\u00f3n y director de los centros educativos. Soy militante de Eusko Alkartasuna y miembro de su ejecutiva nacional. En 2010 acced\u00ed al Parlamento Vasco como representante de EA en sustituci\u00f3n de Jes\u00fas Mari Larrazabal. En este momento soy vicepresidente de la mesa de la c\u00e1mara vasca.<\/p><p>**<\/p><p>Magisteritza eta Hezkuntza zientzietan lizentziatua naiz eta hezkuntza alorrean funtzionarioa. Esparru horretan ere hainbat kargu publiko ezberdin izan ditut: Gipuzkoako Lurralde Ordezkaria izan naiz, baita Hezkuntza Berriztatzeko zuzendari eta Hezkuntza ikastetxeen zuzendari ere. Eusko Alkartasunako militantea naiz eta EAko batzorde eragileko kide. 2010. urtean Eusko Legebiltzarrean legebiltzarkide sartu nintzen Jesus Mari Larrazabalen ordezkapena egiteko. Momentu honetan Eusko Legebiltzarreko mahaiko presidenteordea naiz.<\/p>",
"party": "EA",
"links": [
{
"rel": "self",
"href": "https:\/\/www.osoigo.com\/es\/p\/juanjo-agirrezabala.html"
}
]
},
{
"id": "440",
"created_at": {
"date": "2014-06-05 17:01:04",
"timezone_type": 3,
"timezone": "Europe\/Madrid"
},
"first_name": "Miguel",
"last_name": "Aguado",
"charge": "Parlamentario en la Asamblea Madrile\u00f1a (PSM PSOE)",
"bio": "<p>Estudi\u00e9 comunicaci\u00f3n y marketing en Espa\u00f1a, USA y Francia, me especialic\u00e9 y trabaj\u00e9 en comunicaci\u00f3n ambiental en distintas empresas y entidades. Actualmente soy Diputado Socialista en la Asamblea de Madrid, llevo principalmente los asuntos de medio ambiente y tambi\u00e9n el control de Telemadrid. Estoy en pol\u00edtica porque creo que debe ser la acci\u00f3n m\u00e1s noble del ser humano por los dem\u00e1s, algo complicado hoy en d\u00eda. Puedes conocer m\u00e1s mis temas de inter\u00e9s en mi blog: socialismozen.es<\/p>",
"party": "PSOE",
"links": [
{
"rel": "self",
"href": "https:\/\/www.osoigo.com\/es\/p\/miguel-aguado-1.html"
}
]
}
]
}
get
Devuelve la información del poítico especificado en {politicianId}
get /politicians/{politicianId}
Devuelve la información del poítico especificado en {politicianId}
URI Parameters
- politicianId: required (string )
HTTP status code 200
Representación del político
Body
Type: application/json
Example:
{
"id": "33",
"created_at": {
"date": "2014-04-29 09:00:00",
"timezone_type": 3,
"timezone": "Europe\/Madrid"
},
"first_name": "Uxue",
"last_name": "Barkos",
"charge": "Diputada por Navarra en el Congreso (Geroa Bai)",
"bio": "<p>Soy Uxue Barkos Berruezo (Iru\u00f1a, 5 de julio de 1964). Aunque periodista de oficio, en la actualidad soy diputada de Geroa Bai en el Congreso de los Diputados y portavoz del grupo municipal de Nafarroa Bai en el Ayuntamiento de Iru\u00f1a.<\/p><p>Creo en una pol\u00edtica redimensionada a las necesidades reales del individuo y la sociedad y no a los grandes planes \u201cestrat\u00e9gicos\u201d que terminan deglutiendo los intereses de la ciudadan\u00eda a la que debiera servir. En definitiva, creo en la pol\u00edtica como respuesta, como parte de la soluci\u00f3n, algo a lo que nunca debi\u00e9ramos renunciar.<\/p>",
"party": "Geroa Bai",
"links": [
{
"rel": "self",
"href": "https:\/\/www.osoigo.com\/es\/p\/uxue-barkos.html"
}
]
}
HTTP status code 400
La ID del político es incorrecta
Body
Type: application/json
Example:
{
"status": 400,
"error": "Exception",
"message": "The ID [0] provided is incorrect."
}
HTTP status code 404
No se ha encontrado el político
Body
Type: application/json
Example:
{
"status": 404,
"error": "PoliticianNotFound",
"message": "A user could not be found with ID [65]."
}
get
Devuelve las preguntas referentes al político especificado en {politicianId}
post
Crea una nueva pregunta ligada al político {politicianId}
Para crear la pregunta el usuario tiene que autentificarse mediante el 'access_token' correspondiente. La pregunta quedara ligada a dicho usuario. Para conseguir el 'access_token' hay que realizar la petición a la ruta /users/authenticate
get /politicians/{politicianId}/questions
Devuelve las preguntas referentes al político especificado en {politicianId}
URI Parameters
- politicianId: required (string )
Query Parameters
- sort: (string )
Criterios de ordenación.
- offset: (integer )
La posición a partir de la cual se devolveran los resultados.
- limit: (integer )
Cuantos resultados queremos que nos sean devueltos.
- question: (string )
Filtrar por la pregunta.
- status: (string )
Filtrar por el estado de la pregunta. Estados aceptados: proposal, question, answered, expired, rejected
HTTP status code 200
Las preguntas del politico identificado con politicianId
Body
Type: application/json
Example:
{
"status": 200,
"data": [
{
"id": "29",
"question": "\u00bfEs posible el cambio en navarra?",
"explanation": "<p> Las aguas corren revueltas en navarra. Ya no es noticia. Upn ha ganado casi siempre las elecciones, y aunque la oposici\u00f3n no para de repetir que el cambio llegar\u00e1, nunca llega. \u00bfves posible un presidente que no sea de upn? \u00bfqu\u00e9 factores son claves para que se d\u00e9 el cambio? \u00bfqu\u00e9 escenario vaticinas?<\/p>",
"creation_date": "2014-04-24 19:24:51",
"updated_date": "2014-04-24 19:32:51",
"minSupport": "1",
"pushes": "1",
"status": "deleted",
"expiration_date": "2014-04-29 19:51:24",
"links": [
{
"rel": "self",
"href": "https:\/\/www.osoigo.com\/es\/uxue-barkos-es-posible-el-cambio-en-navarra.html"
}
],
"politician": {
"id": "33",
"created_at": {
"date": "2014-04-29 09:00:00",
"timezone_type": 3,
"timezone": "Europe\/Madrid"
},
"first_name": "Uxue",
"last_name": "Barkos",
"charge": "Diputada por Navarra en el Congreso (Geroa Bai)",
"bio": "<p>Soy Uxue Barkos Berruezo (Iru\u00f1a, 5 de julio de 1964). Aunque periodista de oficio, en la actualidad soy diputada de Geroa Bai en el Congreso de los Diputados y portavoz del grupo municipal de Nafarroa Bai en el Ayuntamiento de Iru\u00f1a.<\/p><p>Creo en una pol\u00edtica redimensionada a las necesidades reales del individuo y la sociedad y no a los grandes planes \u201cestrat\u00e9gicos\u201d que terminan deglutiendo los intereses de la ciudadan\u00eda a la que debiera servir. En definitiva, creo en la pol\u00edtica como respuesta, como parte de la soluci\u00f3n, algo a lo que nunca debi\u00e9ramos renunciar.<\/p>",
"party": "Geroa Bai",
"links": [
{
"rel": "self",
"href": "https:\/\/www.osoigo.com\/es\/p\/uxue-barkos.html"
}
]
},
"user": {
"first_name": "Federico",
"last_name": "García"
}
},
{
"id": "115",
"question": "\u00bfCu\u00e1l es la posici\u00f3n de Geroa Bai en el caso de la ikurri\u00f1a de Sanfermines?",
"explanation": "<p>Hola Uxue,<\/p><p>El Ayuntamiento de Iru\u00f1a, en la que est\u00e1s presente, encabeza la acusaci\u00f3n particular en el caso de la Ikurri\u00f1a mostrada en el chupinazo de Sanfermines. S\u00e9 que se piden penas de 2 a\u00f1os de c\u00e1rcel para los 5 j\u00f3venes que supuestamente se encargaron de desplegar la ikurri\u00f1a, pero sin tener pruebas claras. \u00bfCu\u00e1l es la tu opini\u00f3n sobre estos hechos?<\/p><p><\/p>",
"creation_date": "2014-05-01 13:38:33",
"updated_date": "2014-05-08 14:00:03",
"minSupport": "50",
"pushes": "30",
"status": "expired",
"expiration_date": "2014-05-08 13:38:33",
"links": [
{
"rel": "self",
"href": "https:\/\/www.osoigo.com\/es\/uxue-barkos-cual-es-la-posicion-de-geroa-bai-en-el-caso-de-la-ikurrina-de-sanfermines.html"
}
],
"politician": {
"id": "33",
"created_at": {
"date": "2014-04-29 09:00:00",
"timezone_type": 3,
"timezone": "Europe\/Madrid"
},
"first_name": "Uxue",
"last_name": "Barkos",
"charge": "Diputada por Navarra en el Congreso (Geroa Bai)",
"bio": "<p>Soy Uxue Barkos Berruezo (Iru\u00f1a, 5 de julio de 1964). Aunque periodista de oficio, en la actualidad soy diputada de Geroa Bai en el Congreso de los Diputados y portavoz del grupo municipal de Nafarroa Bai en el Ayuntamiento de Iru\u00f1a.<\/p><p>Creo en una pol\u00edtica redimensionada a las necesidades reales del individuo y la sociedad y no a los grandes planes \u201cestrat\u00e9gicos\u201d que terminan deglutiendo los intereses de la ciudadan\u00eda a la que debiera servir. En definitiva, creo en la pol\u00edtica como respuesta, como parte de la soluci\u00f3n, algo a lo que nunca debi\u00e9ramos renunciar.<\/p>",
"party": "Geroa Bai",
"links": [
{
"rel": "self",
"href": "https:\/\/www.osoigo.com\/es\/p\/uxue-barkos.html"
}
]
},
"user": {
"first_name": "Federico",
"last_name": "García"
}
}
]
}Type: application/xml
Example:
<?xml version="1.0"?>
<response>
<status>200</status>
<data>
<data-item>
<id>29</id>
<question>¿Es posible el cambio en navarra?</question>
<explanation><p> Las aguas corren revueltas en navarra. Ya no es noticia. Upn ha ganado casi siempre las elecciones, y aunque la oposición no para de repetir que el cambio llegará, nunca llega. ¿ves posible un presidente que no sea de upn? ¿qué factores son claves para que se dé el cambio? ¿qué escenario vaticinas?</p></explanation>
<creation_date>2014-04-24 19:24:51</creation_date>
<updated_date>2014-04-24 19:32:51</updated_date>
<minSupport>1</minSupport>
<pushes>1</pushes>
<status>deleted</status>
<expiration_date>2014-04-29 19:51:24</expiration_date>
<links>
<links-item>
<rel>self</rel>
<href>http://192.168.5.2/wwwosoigo/web/manex/es/uxue-barkos-es-posible-el-cambio-en-navarra.html</href>
</links-item>
</links>
<politician>
<id>33</id>
<created_at>
<date>2014-04-29 09:00:00.000000</date>
<timezone_type>3</timezone_type>
<timezone>Europe/Madrid</timezone>
</created_at>
<first_name>Uxue</first_name>
<last_name>Barkos</last_name>
<charge>Diputada por Navarra en el Congreso (Geroa Bai)</charge>
<bio><p>Soy Uxue Barkos Berruezo (Iruña, 5 de julio de 1964). Aunque periodista de oficio, en la actualidad soy diputada de Geroa Bai en el Congreso de los Diputados y portavoz del grupo municipal de Nafarroa Bai en el Ayuntamiento de Iruña.</p><p>Creo en una política redimensionada a las necesidades reales del individuo y la sociedad y no a los grandes planes “estratégicos” que terminan deglutiendo los intereses de la ciudadanía a la que debiera servir. En definitiva, creo en la política como respuesta, como parte de la solución, algo a lo que nunca debiéramos renunciar.</p></bio>
<party>Geroa Bai</party>
<links>
<links-item>
<rel>self</rel>
<href>http://192.168.5.2/wwwosoigo/web/manex/es/p/uxue-barkos.html</href>
</links-item>
</links>
</politician>
</data-item>
<data-item>
<id>115</id>
<question>¿Cuál es la posición de Geroa Bai en el caso de la ikurriña de Sanfermines?</question>
<explanation><p>Hola Uxue,</p><p>El Ayuntamiento de Iruña, en la que estás presente, encabeza la acusación particular en el caso de la Ikurriña mostrada en el chupinazo de Sanfermines. Sé que se piden penas de 2 años de cárcel para los 5 jóvenes que supuestamente se encargaron de desplegar la ikurriña, pero sin tener pruebas claras. ¿Cuál es la tu opinión sobre estos hechos?</p><p></p></explanation>
<creation_date>2014-05-01 13:38:33</creation_date>
<updated_date>2014-05-08 14:00:03</updated_date>
<minSupport>50</minSupport>
<pushes>30</pushes>
<status>expired</status>
<expiration_date>2014-05-08 13:38:33</expiration_date>
<links>
<links-item>
<rel>self</rel>
<href>http://192.168.5.2/wwwosoigo/web/manex/es/uxue-barkos-cual-es-la-posicion-de-geroa-bai-en-el-caso-de-la-ikurrina-de-sanfermines.html</href>
</links-item>
</links>
<politician>
<id>33</id>
<created_at>
<date>2014-04-29 09:00:00.000000</date>
<timezone_type>3</timezone_type>
<timezone>Europe/Madrid</timezone>
</created_at>
<first_name>Uxue</first_name>
<last_name>Barkos</last_name>
<charge>Diputada por Navarra en el Congreso (Geroa Bai)</charge>
<bio><p>Soy Uxue Barkos Berruezo (Iruña, 5 de julio de 1964). Aunque periodista de oficio, en la actualidad soy diputada de Geroa Bai en el Congreso de los Diputados y portavoz del grupo municipal de Nafarroa Bai en el Ayuntamiento de Iruña.</p><p>Creo en una política redimensionada a las necesidades reales del individuo y la sociedad y no a los grandes planes “estratégicos” que terminan deglutiendo los intereses de la ciudadanía a la que debiera servir. En definitiva, creo en la política como respuesta, como parte de la solución, algo a lo que nunca debiéramos renunciar.</p></bio>
<party>Geroa Bai</party>
<links>
<links-item>
<rel>self</rel>
<href>http://192.168.5.2/wwwosoigo/web/manex/es/p/uxue-barkos.html</href>
</links-item>
</links>
</politician>
<user>
<first_name>Federico</first_name>
<last_name>García</last_name>
</user>
</data-item>
</data>
</response>post /politicians/{politicianId}/questions
Crea una nueva pregunta ligada al político {politicianId}
Para crear la pregunta el usuario tiene que autentificarse mediante el 'access_token' correspondiente. La pregunta quedara ligada a dicho usuario. Para conseguir el 'access_token' hay que realizar la petición a la ruta /users/authenticate
URI Parameters
- politicianId: required (string )
Query Parameters
- access_token: required (string )
El 'access_token' del usuario que realiza la pregunta.
- question: required (string - maxLength: 140)
La pregunta
- explanation: required (string )
La descripción de la pregunta
HTTP status code 200
La información de la nueva pregunta creada
Body
Type: application/json
Example:
{
"status": 200,
"data": {
"id": "29",
"question": "\u00bfEs posible el cambio en navarra?",
"explanation": "<p> Las aguas corren revueltas en navarra. Ya no es noticia. Upn ha ganado casi siempre las elecciones, y aunque la oposici\u00f3n no para de repetir que el cambio llegar\u00e1, nunca llega. \u00bfves posible un presidente que no sea de upn? \u00bfqu\u00e9 factores son claves para que se d\u00e9 el cambio? \u00bfqu\u00e9 escenario vaticinas?<\/p>",
"creation_date": "2014-04-24 19:24:51",
"updated_date": "2014-04-24 19:32:51",
"minSupport": "1",
"pushes": "1",
"status": "deleted",
"expiration_date": "2014-04-29 19:51:24",
"links": [
{
"rel": "self",
"href": "https:\/\/www.osoigo.com\/es\/uxue-barkos-es-posible-el-cambio-en-navarra.html"
}
],
"politician": {
"id": "33",
"created_at": {
"date": "2014-04-29 09:00:00",
"timezone_type": 3,
"timezone": "Europe\/Madrid"
},
"first_name": "Uxue",
"last_name": "Barkos",
"charge": "Diputada por Navarra en el Congreso (Geroa Bai)",
"bio": "<p>Soy Uxue Barkos Berruezo (Iru\u00f1a, 5 de julio de 1964). Aunque periodista de oficio, en la actualidad soy diputada de Geroa Bai en el Congreso de los Diputados y portavoz del grupo municipal de Nafarroa Bai en el Ayuntamiento de Iru\u00f1a.<\/p><p>Creo en una pol\u00edtica redimensionada a las necesidades reales del individuo y la sociedad y no a los grandes planes \u201cestrat\u00e9gicos\u201d que terminan deglutiendo los intereses de la ciudadan\u00eda a la que debiera servir. En definitiva, creo en la pol\u00edtica como respuesta, como parte de la soluci\u00f3n, algo a lo que nunca debi\u00e9ramos renunciar.<\/p>",
"party": "Geroa Bai",
"links": [
{
"rel": "self",
"href": "https:\/\/www.osoigo.com\/es\/p\/uxue-barkos.html"
}
]
},
"user": {
"first_name": "Federico",
"last_name": "García"
}
}
}Type: application/xml
Example:
<?xml version="1.0"?>
<response>
<status>200</status>
<data>
<id>29</id>
<question>¿Es posible el cambio en navarra?</question>
<explanation><p> Las aguas corren revueltas en navarra. Ya no es noticia. Upn ha ganado casi siempre las elecciones, y aunque la oposición no para de repetir que el cambio llegará, nunca llega. ¿ves posible un presidente que no sea de upn? ¿qué factores son claves para que se dé el cambio? ¿qué escenario vaticinas?</p></explanation>
<creation_date>2014-04-24 19:24:51</creation_date>
<updated_date>2014-04-24 19:32:51</updated_date>
<minSupport>1</minSupport>
<pushes>1</pushes>
<status>deleted</status>
<expiration_date>2014-04-29 19:51:24</expiration_date>
<links>
<links-item>
<rel>self</rel>
<href>http://192.168.5.2/wwwosoigo/web/manex/es/uxue-barkos-es-posible-el-cambio-en-navarra.html</href>
</links-item>
</links>
<politician>
<id>33</id>
<created_at>
<date>2014-04-29 09:00:00.000000</date>
<timezone_type>3</timezone_type>
<timezone>Europe/Madrid</timezone>
</created_at>
<first_name>Uxue</first_name>
<last_name>Barkos</last_name>
<charge>Diputada por Navarra en el Congreso (Geroa Bai)</charge>
<bio><p>Soy Uxue Barkos Berruezo (Iruña, 5 de julio de 1964). Aunque periodista de oficio, en la actualidad soy diputada de Geroa Bai en el Congreso de los Diputados y portavoz del grupo municipal de Nafarroa Bai en el Ayuntamiento de Iruña.</p><p>Creo en una política redimensionada a las necesidades reales del individuo y la sociedad y no a los grandes planes “estratégicos” que terminan deglutiendo los intereses de la ciudadanía a la que debiera servir. En definitiva, creo en la política como respuesta, como parte de la solución, algo a lo que nunca debiéramos renunciar.</p></bio>
<party>Geroa Bai</party>
<links>
<links-item>
<rel>self</rel>
<href>http://192.168.5.2/wwwosoigo/web/manex/es/p/uxue-barkos.html</href>
</links-item>
</links>
</politician>
<user>
<first_name>Federico</first_name>
<last_name>García</last_name>
</user>
</data>
</response>HTTP status code 400
Error al procesar la petición.
Hay tres tipos de error:
- NotHttpsRequest: La URL de la petición no es HTTPS.
- NoSufficientInfo: No se ha enviado toda la información requerida.
- Exception: Error al procesar la petición.
Body
Type: application/json
Example:
{
"status": 400,
"error": "<Tipo de error>",
"message": "<El motivo del error>"
}
Type: application/xml
Example:
<?xml version="1.0"?>
<response>
<status>400</status>
<error><Tipo de error></error>
<message><El motivo del error></message>
</response>
HTTP status code 401
El 'access_token' enviado no es correcto
Body
Type: application/json
Example:
{
"status": 401,
"error": "Exception",
"message": "invalid_token: The access token provided is invalid"
}Type: application/xml
Example:
<?xml version="1.0"?>
<response>
<status>401</status>
<error>Exception</error>
<message>invalid_token: The access token provided is invalid</message>
</response>get
Devuelve la información de la pregunta {questionId} relacionada con el político {politicianId}
get /politicians/{politicianId}/questions/{questionId}
Devuelve la información de la pregunta {questionId} relacionada con el político {politicianId}
URI Parameters
- politicianId: required (string )
- questionId: required (string )
HTTP status code 200
La información de la pregunta
Body
Type: application/json
Example:
{
"status": 200,
"data": {
"id": "29",
"question": "\u00bfEs posible el cambio en navarra?",
"explanation": "<p> Las aguas corren revueltas en navarra. Ya no es noticia. Upn ha ganado casi siempre las elecciones, y aunque la oposici\u00f3n no para de repetir que el cambio llegar\u00e1, nunca llega. \u00bfves posible un presidente que no sea de upn? \u00bfqu\u00e9 factores son claves para que se d\u00e9 el cambio? \u00bfqu\u00e9 escenario vaticinas?<\/p>",
"creation_date": "2014-04-24 19:24:51",
"updated_date": "2014-04-24 19:32:51",
"minSupport": "1",
"pushes": "1",
"status": "deleted",
"expiration_date": "2014-04-29 19:51:24",
"links": [
{
"rel": "self",
"href": "https:\/\/www.osoigo.com\/es\/uxue-barkos-es-posible-el-cambio-en-navarra.html"
}
],
"politician": {
"id": "33",
"created_at": {
"date": "2014-04-29 09:00:00",
"timezone_type": 3,
"timezone": "Europe\/Madrid"
},
"first_name": "Uxue",
"last_name": "Barkos",
"charge": "Diputada por Navarra en el Congreso (Geroa Bai)",
"bio": "<p>Soy Uxue Barkos Berruezo (Iru\u00f1a, 5 de julio de 1964). Aunque periodista de oficio, en la actualidad soy diputada de Geroa Bai en el Congreso de los Diputados y portavoz del grupo municipal de Nafarroa Bai en el Ayuntamiento de Iru\u00f1a.<\/p><p>Creo en una pol\u00edtica redimensionada a las necesidades reales del individuo y la sociedad y no a los grandes planes \u201cestrat\u00e9gicos\u201d que terminan deglutiendo los intereses de la ciudadan\u00eda a la que debiera servir. En definitiva, creo en la pol\u00edtica como respuesta, como parte de la soluci\u00f3n, algo a lo que nunca debi\u00e9ramos renunciar.<\/p>",
"party": "Geroa Bai",
"links": [
{
"rel": "self",
"href": "https:\/\/www.osoigo.com\/es\/p\/uxue-barkos.html"
}
]
},
"user": {
"first_name": "Federico",
"last_name": "García"
}
}
}Type: application/xml
Example:
<?xml version="1.0"?>
<response>
<status>200</status>
<data>
<id>29</id>
<question>¿Es posible el cambio en navarra?</question>
<explanation><p> Las aguas corren revueltas en navarra. Ya no es noticia. Upn ha ganado casi siempre las elecciones, y aunque la oposición no para de repetir que el cambio llegará, nunca llega. ¿ves posible un presidente que no sea de upn? ¿qué factores son claves para que se dé el cambio? ¿qué escenario vaticinas?</p></explanation>
<creation_date>2014-04-24 19:24:51</creation_date>
<updated_date>2014-04-24 19:32:51</updated_date>
<minSupport>1</minSupport>
<pushes>1</pushes>
<status>deleted</status>
<expiration_date>2014-04-29 19:51:24</expiration_date>
<links>
<links-item>
<rel>self</rel>
<href>http://192.168.5.2/wwwosoigo/web/manex/es/uxue-barkos-es-posible-el-cambio-en-navarra.html</href>
</links-item>
</links>
<politician>
<id>33</id>
<created_at>
<date>2014-04-29 09:00:00.000000</date>
<timezone_type>3</timezone_type>
<timezone>Europe/Madrid</timezone>
</created_at>
<first_name>Uxue</first_name>
<last_name>Barkos</last_name>
<charge>Diputada por Navarra en el Congreso (Geroa Bai)</charge>
<bio><p>Soy Uxue Barkos Berruezo (Iruña, 5 de julio de 1964). Aunque periodista de oficio, en la actualidad soy diputada de Geroa Bai en el Congreso de los Diputados y portavoz del grupo municipal de Nafarroa Bai en el Ayuntamiento de Iruña.</p><p>Creo en una política redimensionada a las necesidades reales del individuo y la sociedad y no a los grandes planes “estratégicos” que terminan deglutiendo los intereses de la ciudadanía a la que debiera servir. En definitiva, creo en la política como respuesta, como parte de la solución, algo a lo que nunca debiéramos renunciar.</p></bio>
<party>Geroa Bai</party>
<links>
<links-item>
<rel>self</rel>
<href>http://192.168.5.2/wwwosoigo/web/manex/es/p/uxue-barkos.html</href>
</links-item>
</links>
</politician>
<user>
<first_name>Federico</first_name>
<last_name>García</last_name>
</user>
</data>
</response>HTTP status code 400
La ID del político o dela pregunta es incorrecta
Body
Type: application/json
Example:
{
"status": 400,
"error": "Exception",
"message": "The ID [0] provided is incorrect."
}
HTTP status code 404
No se ha encontrado la pregunta o la pregunta no pertenece al político {politicianId}
Body
Type: application/json
Example:
{
"status": 404,
"error": "QuestionNotFound",
"message": "A question could not be found with ID [65]."
}
get
Devuelva la respuesta de la pregunta {questionId} relacionada con el político {politicianId}
get /politicians/{politicianId}/questions/{questionId}/answers
Devuelva la respuesta de la pregunta {questionId} relacionada con el político {politicianId}
URI Parameters
- politicianId: required (string )
- questionId: required (string )
HTTP status code 200
La información de la respuesta
Body
Type: application/json
Example:
{
"status": 200,
"data": {
"id": "40",
"answer": "<p>No tiene por que haberlo. Lo importante son los puntos de encuentro que puedan haber entre los dos grandes partidos. En estos momentos son pocos y sobre temas muy concretos, por lo que creo muy dif\u00edcil e improbable un gobierno de coalici\u00f3n. El PP tiene una mayor\u00eda absoluta parlamentaria que apoya a un gobierno que no tiene inter\u00e9s en ceder en nada para llegar a alg\u00fan tipo de acuerdo con el PSOE.<\/p><p>\u00a0<\/p>",
"creation_date": "2014-05-09 06:58:18",
"updated_date": "2014-05-09 09:18:23",
"links": [
{
"rel": "self",
"href": "http:\/\/192.168.5.2\/wwwosoigo\/web\/manex\/es\/habra-un-gobierno-de-coalicion-psoe-pp-en-2015.html"
}
]
}
}Type: application/xml
Example:
<?xml version="1.0"?>
<response>
<status>200</status>
<data>
<id>40</id>
<answer><p>No tiene por que haberlo. Lo importante son los puntos de encuentro que puedan haber entre los dos grandes partidos. En estos momentos son pocos y sobre temas muy concretos, por lo que creo muy difícil e improbable un gobierno de coalición. El PP tiene una mayoría absoluta parlamentaria que apoya a un gobierno que no tiene interés en ceder en nada para llegar a algún tipo de acuerdo con el PSOE.</p><p> </p></answer>
<creation_date>2014-05-09 06:58:18</creation_date>
<updated_date>2014-05-09 09:18:23</updated_date>
<links>
<links-item>
<rel>self</rel>
<href>http://192.168.5.2/wwwosoigo/web/manex/es/habra-un-gobierno-de-coalicion-psoe-pp-en-2015.html</href>
</links-item>
</links>
</data>
</response>HTTP status code 400
La pregunta no esta respondida.
Body
Type: application/json
Example:
{
"status": 400,
"error": "QuestionNotAnswered",
"message": "Question with ID [29] is not answered"
}
HTTP status code 404
No se ha encontrado la pregunta {questionId} o no pertence al politico {politicianId}
Body
Type: application/json
Example:
{
"status": 404,
"error": "Exception",
"message": "A question could not be found with ID [140]"
}
Preguntas
Operaciones ligadas a las preguntas
get
Devuelve información de las preguntas
get /questions
Devuelve información de las preguntas
Query Parameters
- sort: (string )
Criterios de ordenación.
- offset: (integer )
La posición a partir de la cual se devolveran los resultados.
- limit: (integer )
Cuantos resultados queremos que nos sean devueltos.
- question: (string )
Filtrar por la pregunta.
- status: (string )
Filtrar por el estado de la pregunta. Estados aceptados: proposal, question, answered, expired, rejected
HTTP status code 200
La información de las preguntas encontradas
Body
Type: application/json
Example:
{
"status": 200,
"data": [
{
"id": "29",
"question": "\u00bfEs posible el cambio en navarra?",
"explanation": "<p> Las aguas corren revueltas en navarra. Ya no es noticia. Upn ha ganado casi siempre las elecciones, y aunque la oposici\u00f3n no para de repetir que el cambio llegar\u00e1, nunca llega. \u00bfves posible un presidente que no sea de upn? \u00bfqu\u00e9 factores son claves para que se d\u00e9 el cambio? \u00bfqu\u00e9 escenario vaticinas?<\/p>",
"creation_date": "2014-04-24 19:24:51",
"updated_date": "2014-04-24 19:32:51",
"minSupport": "1",
"pushes": "1",
"status": "deleted",
"expiration_date": "2014-04-29 19:51:24",
"links": [
{
"rel": "self",
"href": "https:\/\/www.osoigo.com\/es\/uxue-barkos-es-posible-el-cambio-en-navarra.html"
}
],
"politician": {
"id": "33",
"created_at": {
"date": "2014-04-29 09:00:00",
"timezone_type": 3,
"timezone": "Europe\/Madrid"
},
"first_name": "Uxue",
"last_name": "Barkos",
"charge": "Diputada por Navarra en el Congreso (Geroa Bai)",
"bio": "<p>Soy Uxue Barkos Berruezo (Iru\u00f1a, 5 de julio de 1964). Aunque periodista de oficio, en la actualidad soy diputada de Geroa Bai en el Congreso de los Diputados y portavoz del grupo municipal de Nafarroa Bai en el Ayuntamiento de Iru\u00f1a.<\/p><p>Creo en una pol\u00edtica redimensionada a las necesidades reales del individuo y la sociedad y no a los grandes planes \u201cestrat\u00e9gicos\u201d que terminan deglutiendo los intereses de la ciudadan\u00eda a la que debiera servir. En definitiva, creo en la pol\u00edtica como respuesta, como parte de la soluci\u00f3n, algo a lo que nunca debi\u00e9ramos renunciar.<\/p>",
"party": "Geroa Bai",
"links": [
{
"rel": "self",
"href": "https:\/\/www.osoigo.com\/es\/p\/uxue-barkos.html"
}
]
},
"user": {
"first_name": "Federico",
"last_name": "García"
}
},
{
"id": "115",
"question": "\u00bfCu\u00e1l es la posici\u00f3n de Geroa Bai en el caso de la ikurri\u00f1a de Sanfermines?",
"explanation": "<p>Hola Uxue,<\/p><p>El Ayuntamiento de Iru\u00f1a, en la que est\u00e1s presente, encabeza la acusaci\u00f3n particular en el caso de la Ikurri\u00f1a mostrada en el chupinazo de Sanfermines. S\u00e9 que se piden penas de 2 a\u00f1os de c\u00e1rcel para los 5 j\u00f3venes que supuestamente se encargaron de desplegar la ikurri\u00f1a, pero sin tener pruebas claras. \u00bfCu\u00e1l es la tu opini\u00f3n sobre estos hechos?<\/p><p><\/p>",
"creation_date": "2014-05-01 13:38:33",
"updated_date": "2014-05-08 14:00:03",
"minSupport": "50",
"pushes": "30",
"status": "expired",
"expiration_date": "2014-05-08 13:38:33",
"links": [
{
"rel": "self",
"href": "https:\/\/www.osoigo.com\/es\/uxue-barkos-cual-es-la-posicion-de-geroa-bai-en-el-caso-de-la-ikurrina-de-sanfermines.html"
}
],
"politician": {
"id": "33",
"created_at": {
"date": "2014-04-29 09:00:00",
"timezone_type": 3,
"timezone": "Europe\/Madrid"
},
"first_name": "Uxue",
"last_name": "Barkos",
"charge": "Diputada por Navarra en el Congreso (Geroa Bai)",
"bio": "<p>Soy Uxue Barkos Berruezo (Iru\u00f1a, 5 de julio de 1964). Aunque periodista de oficio, en la actualidad soy diputada de Geroa Bai en el Congreso de los Diputados y portavoz del grupo municipal de Nafarroa Bai en el Ayuntamiento de Iru\u00f1a.<\/p><p>Creo en una pol\u00edtica redimensionada a las necesidades reales del individuo y la sociedad y no a los grandes planes \u201cestrat\u00e9gicos\u201d que terminan deglutiendo los intereses de la ciudadan\u00eda a la que debiera servir. En definitiva, creo en la pol\u00edtica como respuesta, como parte de la soluci\u00f3n, algo a lo que nunca debi\u00e9ramos renunciar.<\/p>",
"party": "Geroa Bai",
"links": [
{
"rel": "self",
"href": "https:\/\/www.osoigo.com\/es\/p\/uxue-barkos.html"
}
]
},
"user": {
"first_name": "Federico",
"last_name": "García"
}
}
]
}Type: application/xml
Example:
<?xml version="1.0"?>
<response>
<status>200</status>
<data>
<data-item>
<id>29</id>
<question>¿Es posible el cambio en navarra?</question>
<explanation><p> Las aguas corren revueltas en navarra. Ya no es noticia. Upn ha ganado casi siempre las elecciones, y aunque la oposición no para de repetir que el cambio llegará, nunca llega. ¿ves posible un presidente que no sea de upn? ¿qué factores son claves para que se dé el cambio? ¿qué escenario vaticinas?</p></explanation>
<creation_date>2014-04-24 19:24:51</creation_date>
<updated_date>2014-04-24 19:32:51</updated_date>
<minSupport>1</minSupport>
<pushes>1</pushes>
<status>deleted</status>
<expiration_date>2014-04-29 19:51:24</expiration_date>
<links>
<links-item>
<rel>self</rel>
<href>http://192.168.5.2/wwwosoigo/web/manex/es/uxue-barkos-es-posible-el-cambio-en-navarra.html</href>
</links-item>
</links>
<politician>
<id>33</id>
<created_at>
<date>2014-04-29 09:00:00.000000</date>
<timezone_type>3</timezone_type>
<timezone>Europe/Madrid</timezone>
</created_at>
<first_name>Uxue</first_name>
<last_name>Barkos</last_name>
<charge>Diputada por Navarra en el Congreso (Geroa Bai)</charge>
<bio><p>Soy Uxue Barkos Berruezo (Iruña, 5 de julio de 1964). Aunque periodista de oficio, en la actualidad soy diputada de Geroa Bai en el Congreso de los Diputados y portavoz del grupo municipal de Nafarroa Bai en el Ayuntamiento de Iruña.</p><p>Creo en una política redimensionada a las necesidades reales del individuo y la sociedad y no a los grandes planes “estratégicos” que terminan deglutiendo los intereses de la ciudadanía a la que debiera servir. En definitiva, creo en la política como respuesta, como parte de la solución, algo a lo que nunca debiéramos renunciar.</p></bio>
<party>Geroa Bai</party>
<links>
<links-item>
<rel>self</rel>
<href>http://192.168.5.2/wwwosoigo/web/manex/es/p/uxue-barkos.html</href>
</links-item>
</links>
</politician>
</data-item>
<data-item>
<id>115</id>
<question>¿Cuál es la posición de Geroa Bai en el caso de la ikurriña de Sanfermines?</question>
<explanation><p>Hola Uxue,</p><p>El Ayuntamiento de Iruña, en la que estás presente, encabeza la acusación particular en el caso de la Ikurriña mostrada en el chupinazo de Sanfermines. Sé que se piden penas de 2 años de cárcel para los 5 jóvenes que supuestamente se encargaron de desplegar la ikurriña, pero sin tener pruebas claras. ¿Cuál es la tu opinión sobre estos hechos?</p><p></p></explanation>
<creation_date>2014-05-01 13:38:33</creation_date>
<updated_date>2014-05-08 14:00:03</updated_date>
<minSupport>50</minSupport>
<pushes>30</pushes>
<status>expired</status>
<expiration_date>2014-05-08 13:38:33</expiration_date>
<links>
<links-item>
<rel>self</rel>
<href>http://192.168.5.2/wwwosoigo/web/manex/es/uxue-barkos-cual-es-la-posicion-de-geroa-bai-en-el-caso-de-la-ikurrina-de-sanfermines.html</href>
</links-item>
</links>
<politician>
<id>33</id>
<created_at>
<date>2014-04-29 09:00:00.000000</date>
<timezone_type>3</timezone_type>
<timezone>Europe/Madrid</timezone>
</created_at>
<first_name>Uxue</first_name>
<last_name>Barkos</last_name>
<charge>Diputada por Navarra en el Congreso (Geroa Bai)</charge>
<bio><p>Soy Uxue Barkos Berruezo (Iruña, 5 de julio de 1964). Aunque periodista de oficio, en la actualidad soy diputada de Geroa Bai en el Congreso de los Diputados y portavoz del grupo municipal de Nafarroa Bai en el Ayuntamiento de Iruña.</p><p>Creo en una política redimensionada a las necesidades reales del individuo y la sociedad y no a los grandes planes “estratégicos” que terminan deglutiendo los intereses de la ciudadanía a la que debiera servir. En definitiva, creo en la política como respuesta, como parte de la solución, algo a lo que nunca debiéramos renunciar.</p></bio>
<party>Geroa Bai</party>
<links>
<links-item>
<rel>self</rel>
<href>http://192.168.5.2/wwwosoigo/web/manex/es/p/uxue-barkos.html</href>
</links-item>
</links>
</politician>
<user>
<first_name>Federico</first_name>
<last_name>García</last_name>
</user>
</data-item>
</data>
</response>get
Devuelve la información de la pregunta {questionId}
get /questions/{questionId}
Devuelve la información de la pregunta {questionId}
URI Parameters
- questionId: required (string )
HTTP status code 200
La información de la pregunta
Body
Type: application/json
Example:
{
"status": 200,
"data": {
"id": "29",
"question": "\u00bfEs posible el cambio en navarra?",
"explanation": "<p> Las aguas corren revueltas en navarra. Ya no es noticia. Upn ha ganado casi siempre las elecciones, y aunque la oposici\u00f3n no para de repetir que el cambio llegar\u00e1, nunca llega. \u00bfves posible un presidente que no sea de upn? \u00bfqu\u00e9 factores son claves para que se d\u00e9 el cambio? \u00bfqu\u00e9 escenario vaticinas?<\/p>",
"creation_date": "2014-04-24 19:24:51",
"updated_date": "2014-04-24 19:32:51",
"minSupport": "1",
"pushes": "1",
"status": "deleted",
"expiration_date": "2014-04-29 19:51:24",
"links": [
{
"rel": "self",
"href": "https:\/\/www.osoigo.com\/es\/uxue-barkos-es-posible-el-cambio-en-navarra.html"
}
],
"politician": {
"id": "33",
"created_at": {
"date": "2014-04-29 09:00:00",
"timezone_type": 3,
"timezone": "Europe\/Madrid"
},
"first_name": "Uxue",
"last_name": "Barkos",
"charge": "Diputada por Navarra en el Congreso (Geroa Bai)",
"bio": "<p>Soy Uxue Barkos Berruezo (Iru\u00f1a, 5 de julio de 1964). Aunque periodista de oficio, en la actualidad soy diputada de Geroa Bai en el Congreso de los Diputados y portavoz del grupo municipal de Nafarroa Bai en el Ayuntamiento de Iru\u00f1a.<\/p><p>Creo en una pol\u00edtica redimensionada a las necesidades reales del individuo y la sociedad y no a los grandes planes \u201cestrat\u00e9gicos\u201d que terminan deglutiendo los intereses de la ciudadan\u00eda a la que debiera servir. En definitiva, creo en la pol\u00edtica como respuesta, como parte de la soluci\u00f3n, algo a lo que nunca debi\u00e9ramos renunciar.<\/p>",
"party": "Geroa Bai",
"links": [
{
"rel": "self",
"href": "https:\/\/www.osoigo.com\/es\/p\/uxue-barkos.html"
}
]
},
"user": {
"first_name": "Federico",
"last_name": "García"
}
}
}Type: application/xml
Example:
<?xml version="1.0"?>
<response>
<status>200</status>
<data>
<id>29</id>
<question>¿Es posible el cambio en navarra?</question>
<explanation><p> Las aguas corren revueltas en navarra. Ya no es noticia. Upn ha ganado casi siempre las elecciones, y aunque la oposición no para de repetir que el cambio llegará, nunca llega. ¿ves posible un presidente que no sea de upn? ¿qué factores son claves para que se dé el cambio? ¿qué escenario vaticinas?</p></explanation>
<creation_date>2014-04-24 19:24:51</creation_date>
<updated_date>2014-04-24 19:32:51</updated_date>
<minSupport>1</minSupport>
<pushes>1</pushes>
<status>deleted</status>
<expiration_date>2014-04-29 19:51:24</expiration_date>
<links>
<links-item>
<rel>self</rel>
<href>http://192.168.5.2/wwwosoigo/web/manex/es/uxue-barkos-es-posible-el-cambio-en-navarra.html</href>
</links-item>
</links>
<politician>
<id>33</id>
<created_at>
<date>2014-04-29 09:00:00.000000</date>
<timezone_type>3</timezone_type>
<timezone>Europe/Madrid</timezone>
</created_at>
<first_name>Uxue</first_name>
<last_name>Barkos</last_name>
<charge>Diputada por Navarra en el Congreso (Geroa Bai)</charge>
<bio><p>Soy Uxue Barkos Berruezo (Iruña, 5 de julio de 1964). Aunque periodista de oficio, en la actualidad soy diputada de Geroa Bai en el Congreso de los Diputados y portavoz del grupo municipal de Nafarroa Bai en el Ayuntamiento de Iruña.</p><p>Creo en una política redimensionada a las necesidades reales del individuo y la sociedad y no a los grandes planes “estratégicos” que terminan deglutiendo los intereses de la ciudadanía a la que debiera servir. En definitiva, creo en la política como respuesta, como parte de la solución, algo a lo que nunca debiéramos renunciar.</p></bio>
<party>Geroa Bai</party>
<links>
<links-item>
<rel>self</rel>
<href>http://192.168.5.2/wwwosoigo/web/manex/es/p/uxue-barkos.html</href>
</links-item>
</links>
</politician>
<user>
<first_name>Federico</first_name>
<last_name>García</last_name>
</user>
</data>
</response>HTTP status code 400
La ID de la pregunta es incorrecta
Body
Type: application/json
Example:
{
"status": 400,
"error": "Exception",
"message": "The ID [0] provided is incorrect."
}
HTTP status code 404
No se ha encontrado la pregunta con el identificadof {questionId}
Body
Type: application/json
Example:
{
"status": 404,
"error": "QuestionNotFound",
"message": "A question could not be found with ID [65]."
}
get
Devuelva la respuesta de la pregunta {questionId}
get /questions/{questionId}/answers
Devuelva la respuesta de la pregunta {questionId}
URI Parameters
- questionId: required (string )
HTTP status code 200
La información de la respuesta
Body
Type: application/json
Example:
{
"status": 200,
"data": {
"id": "40",
"answer": "<p>No tiene por que haberlo. Lo importante son los puntos de encuentro que puedan haber entre los dos grandes partidos. En estos momentos son pocos y sobre temas muy concretos, por lo que creo muy dif\u00edcil e improbable un gobierno de coalici\u00f3n. El PP tiene una mayor\u00eda absoluta parlamentaria que apoya a un gobierno que no tiene inter\u00e9s en ceder en nada para llegar a alg\u00fan tipo de acuerdo con el PSOE.<\/p><p>\u00a0<\/p>",
"creation_date": "2014-05-09 06:58:18",
"updated_date": "2014-05-09 09:18:23",
"links": [
{
"rel": "self",
"href": "http:\/\/192.168.5.2\/wwwosoigo\/web\/manex\/es\/habra-un-gobierno-de-coalicion-psoe-pp-en-2015.html"
}
]
}
}Type: application/xml
Example:
<?xml version="1.0"?>
<response>
<status>200</status>
<data>
<id>40</id>
<answer><p>No tiene por que haberlo. Lo importante son los puntos de encuentro que puedan haber entre los dos grandes partidos. En estos momentos son pocos y sobre temas muy concretos, por lo que creo muy difícil e improbable un gobierno de coalición. El PP tiene una mayoría absoluta parlamentaria que apoya a un gobierno que no tiene interés en ceder en nada para llegar a algún tipo de acuerdo con el PSOE.</p><p> </p></answer>
<creation_date>2014-05-09 06:58:18</creation_date>
<updated_date>2014-05-09 09:18:23</updated_date>
<links>
<links-item>
<rel>self</rel>
<href>http://192.168.5.2/wwwosoigo/web/manex/es/habra-un-gobierno-de-coalicion-psoe-pp-en-2015.html</href>
</links-item>
</links>
</data>
</response>HTTP status code 400
La pregunta no esta respondida.
Body
Type: application/json
Example:
{
"status": 400,
"error": "QuestionNotAnswered",
"message": "Question with ID [29] is not answered"
}
HTTP status code 404
No se ha encontrado la pregunta {questionId}
Body
Type: application/json
Example:
{
"status": 404,
"error": "Exception",
"message": "A question could not be found with ID [140]"
}
Usuarios
Operaciones ligadas a usuarios
post
Crea un nuevo usuario y devuelve el 'access_token' del nuevo usuario creado.
post /users
Crea un nuevo usuario y devuelve el 'access_token' del nuevo usuario creado.
Query Parameters
- email: required (string )
El email del nuevo usuario
- password: required (string )
La contraseña para acceder a su cuenta
- first_name: required (string )
Nombre del nuevo usuario
- last_name: required (string )
Apellido del nuevo usuario
HTTP status code 200
El 'access_token' del nuevo usuario creado.
Body
Type: application/json
Example:
{
"status": 200,
"data": {
"access_token": "35a9490afedce2b06bb1ffe245c0d6697b645e5b",
"expires_in": 3600,
"token_type": "Bearer",
"scope": null,
"refresh_token": "bfc0cdde2d61e7fff89bf1374ea3c3c5a35c3bcd"
}
}Type: application/xml
Example:
<?xml version="1.0"?>
<response>
<status>200</status>
<data>
<access_token>d31a03234fc545cb9d95bc722f34ee0f45693cdb</access_token>
<expires_in>3600</expires_in>
<token_type>Bearer</token_type>
<scope></scope>
<refresh_token>ec84d904fb2f8489bff00c117de611c70277912e</refresh_token>
</data>
</response>HTTP status code 400
Error al procesar la petición.
Hay tres tipos de error:
- NotHttpsRequest: La URL de la petición no es HTTPS.
- NoSufficientInfo: No se ha enviado toda la información requerida.
- UserAlreadyExists: Ya existe una cuenta con ese email.
- Exception: Error al procesar la petición.
Body
Type: application/json
Example:
{
"status": 400,
"error": "<Tipo de error>",
"message": "<El motivo del error>"
}
Type: application/xml
Example:
<?xml version="1.0"?>
<response>
<status>400</status>
<error><Tipo de error></error>
<message><El motivo del error></message>
</response>
post
Autentificar un usuario para poder realizar acciones restringidas. Devuelve el 'access_token' necesario.
También devuelve el 'refresh_token' para mantener la sesión una vez haya expirado.
post /users/authenticate
Autentificar un usuario para poder realizar acciones restringidas. Devuelve el 'access_token' necesario.
También devuelve el 'refresh_token' para mantener la sesión una vez haya expirado.
Query Parameters
- username: required (string )
El login, el email del usuario.
- password: required (string )
La contraseña
HTTP status code 200
El 'access_token' del usuario.
Body
Type: application/json
Example:
{
"status": 200,
"data": {
"access_token": "35a9490afedce2b06bb1ffe245c0d6697b645e5b",
"expires_in": 3600,
"token_type": "Bearer",
"scope": null,
"refresh_token": "bfc0cdde2d61e7fff89bf1374ea3c3c5a35c3bcd"
}
}Type: application/xml
Example:
<?xml version="1.0"?>
<response>
<status>200</status>
<data>
<access_token>d31a03234fc545cb9d95bc722f34ee0f45693cdb</access_token>
<expires_in>3600</expires_in>
<token_type>Bearer</token_type>
<scope></scope>
<refresh_token>ec84d904fb2f8489bff00c117de611c70277912e</refresh_token>
</data>
</response>HTTP status code 400
Falta información
Body
Type: application/json
Example:
{
"status": 400,
"error": "Exception",
"message": "invalid_request: Missing parameters: \"username\" and \"password\" required"
}Type: application/xml
Example:
<?xml version="1.0"?>
<response>
<status>400</status>
<error>Exception</error>
<message>invalid_request: Missing parameters: "username" and "password" required</message>
</response>HTTP status code 401
Login incorrecto
Body
Type: application/json
Example:
{
"status": 401,
"error": "Exception",
"message": "invalid_grant: Invalid username and password combination"
}Type: application/xml
Example:
<?xml version="1.0"?>
<response>
<status>401</status>
<error>Exception</error>
<message>invalid_grant: Invalid username and password combination</message>
</response>
post
Actualiza la sesión devolviendo un nuevo 'access_token'. No reemplaza al antiguo.
post /users/refresh
Actualiza la sesión devolviendo un nuevo 'access_token'. No reemplaza al antiguo.
Query Parameters
- refresh_token: required (string )
La clave 'refresh_token' proporcionada al crear o autentificar un usuario.
HTTP status code 200
El nuevo 'access_token' de la sesión.
Body
Type: application/json
Example:
{
"status": 200,
"data": {
"access_token": "367ab2d1014349c7275b652016e167f056519860",
"expires_in": 3600,
"token_type": "Bearer",
"scope": null
}
}Type: application/xml
Example:
<?xml version="1.0"?>
<response>
<status>200</status>
<data>
<access_token>35a36d56f08354fe885b588e9937e1431802726a</access_token>
<expires_in>3600</expires_in>
<token_type>Bearer</token_type>
<scope></scope>
</data>
</response>HTTP status code 400
Falta el parámetro "refresh_token"
Body
Type: application/json
Example:
{
"status": 400,
"error": "Exception",
"message": "invalid_request: Missing parameter: \"refresh_token\" is required"
}Type: application/xml
Example:
<?xml version="1.0"?>
<response>
<status>400</status>
<error>Exception</error>
<message>invalid_request: Missing parameter: "refresh_token" is required</message>
</response>