Osoigo API documentation version 0.3

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.
Acceder al listado de comunidades autónomas, provincias y pueblos

Rutas principilas de la API:

/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.
/communities: Acceder a la lista de comunidades autónomas
/provinces: Acceder a la lista de provincias
/towns: Acceder a la lista de provincias

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, 0.3...

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.3).

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.

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="firstname::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="firstname::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

/versions get

get

Devuelve una lista con todas las conbinaciones posibles entre versiones y formatos disponibles de la API.

Response

HTTP status code 200

Devuelve la lista completa de versiones y formatos

Body

Media type: application/json

Type: object

Example:

{
    "status": 200,
    "data": [
        "application\/json; version=0.1",
        "application\/xml; version=0.1",
        "application\/json; version=0.2",
        "application\/xml; version=0.2"
    ]
}

Media type: application/xml

Type: object

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

/politicians get

get

Devuelve el listado de los políticos

Request
Response

Query Parameters

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

Media type: application/json

Type: object

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"
                }
            ]
        }
    ]
}

/politicians/{politicianId} get

get

Devuelve la información del poítico especificado en {politicianId}

Request
Response

URI Parameters

politicianId: required (string)

HTTP status code 200

Representación del político

Body

Media type: application/json

Type: object

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

Media type: application/json

Type: object

Example:

{
    "status": 400,
    "error": "Exception",
    "message": "The ID [0] provided is incorrect."
}

HTTP status code 404

No se ha encontrado el político

Body

Media type: application/json

Type: object

Example:

{
    "status": 404,
    "error": "PoliticianNotFound",
    "message": "A user could not be found with ID [65]."
}

/politicians/{politicianId}/questions get post

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

Devuelve las preguntas referentes al político especificado en {politicianId}

Request
Response

URI Parameters

politicianId: required (string)

Query Parameters

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

Media type: application/json

Type: object

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"
          }
      }
  ]
}

Media type: application/xml

Type: object

Example:

<?xml version="1.0"?>
<response>
  <status>200</status>
  <data>
    <data-item>
      <id>29</id>
      <question>¿Es posible el cambio en navarra?</question>
      <explanation>&lt;p&gt; 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?&lt;/p&gt;</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>&lt;p&gt;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.&lt;/p&gt;&lt;p&gt;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.&lt;/p&gt;</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>&lt;p&gt;Hola Uxue,&lt;/p&gt;&lt;p&gt;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?&lt;/p&gt;&lt;p&gt;&lt;/p&gt;</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>&lt;p&gt;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.&lt;/p&gt;&lt;p&gt;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.&lt;/p&gt;</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>

Crea una nueva pregunta ligada al político {politicianId}

Request
Response

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

Media type: application/json

Type: object

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"
        }
    }
}

Media type: application/xml

Type: object

Example:

<?xml version="1.0"?>
<response>
  <status>200</status>
  <data>
    <id>29</id>
    <question>¿Es posible el cambio en navarra?</question>
    <explanation>&lt;p&gt; 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?&lt;/p&gt;</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>&lt;p&gt;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.&lt;/p&gt;&lt;p&gt;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.&lt;/p&gt;</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

Media type: application/json

Type: object

Example:

{
    "status": 400,
    "error": "<Tipo de error>",
    "message": "<El motivo del error>"
}

Media type: application/xml

Type: object

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

Media type: application/json

Type: object

Example:

{
    "status": 401,
    "error": "Exception",
    "message": "invalid_token: The access token provided is invalid"
}

Media type: application/xml

Type: object

Example:

<?xml version="1.0"?>
<response>
  <status>401</status>
  <error>Exception</error>
  <message>invalid_token: The access token provided is invalid</message>
</response>

/politicians/{politicianId}/questions/{questionId} get

get

Devuelve la información de la pregunta {questionId} relacionada con el político {politicianId}

Request
Response

URI Parameters

politicianId: required (string)
questionId: required (string)

HTTP status code 200

La información de la pregunta

Body

Media type: application/json

Type: object

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"
        }
    }
}

Media type: application/xml

Type: object

Example:

<?xml version="1.0"?>
<response>
  <status>200</status>
  <data>
    <id>29</id>
    <question>¿Es posible el cambio en navarra?</question>
    <explanation>&lt;p&gt; 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?&lt;/p&gt;</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>&lt;p&gt;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.&lt;/p&gt;&lt;p&gt;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.&lt;/p&gt;</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

Media type: application/json

Type: object

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

Media type: application/json

Type: object

Example:

{
    "status": 404,
    "error": "QuestionNotFound",
    "message": "A question could not be found with ID [65]."
}

/politicians/{politicianId}/questions/{questionId}/answers get

get

Devuelva la respuesta de la pregunta {questionId} relacionada con el político {politicianId}

Request
Response

URI Parameters

politicianId: required (string)
questionId: required (string)

HTTP status code 200

La información de la respuesta

Body

Media type: application/json

Type: object

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"
            }
        ]
    }
}

Media type: application/xml

Type: object

Example:

<?xml version="1.0"?>
<response>
  <status>200</status>
  <data>
    <id>40</id>
    <answer>&lt;p&gt;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.&lt;/p&gt;&lt;p&gt; &lt;/p&gt;</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

Media type: application/json

Type: object

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

Media type: application/json

Type: object

Example:

{
    "status": 404,
    "error": "Exception",
    "message": "A question could not be found with ID [140]"
}

Preguntas

Operaciones ligadas a las preguntas

/questions get

get

Devuelve información de las preguntas

Request
Response

Query Parameters

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

Media type: application/json

Type: object

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"
          }
      }
  ]
}

Media type: application/xml

Type: object

Example:

<?xml version="1.0"?>
<response>
  <status>200</status>
  <data>
    <data-item>
      <id>29</id>
      <question>¿Es posible el cambio en navarra?</question>
      <explanation>&lt;p&gt; 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?&lt;/p&gt;</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>&lt;p&gt;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.&lt;/p&gt;&lt;p&gt;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.&lt;/p&gt;</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>&lt;p&gt;Hola Uxue,&lt;/p&gt;&lt;p&gt;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?&lt;/p&gt;&lt;p&gt;&lt;/p&gt;</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>&lt;p&gt;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.&lt;/p&gt;&lt;p&gt;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.&lt;/p&gt;</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>

/questions/{questionId} get

get

Devuelve la información de la pregunta {questionId}

Request
Response

URI Parameters

questionId: required (string)

HTTP status code 200

La información de la pregunta

Body

Media type: application/json

Type: object

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"
        }
    }
}

Media type: application/xml

Type: object

Example:

<?xml version="1.0"?>
<response>
  <status>200</status>
  <data>
    <id>29</id>
    <question>¿Es posible el cambio en navarra?</question>
    <explanation>&lt;p&gt; 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?&lt;/p&gt;</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>&lt;p&gt;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.&lt;/p&gt;&lt;p&gt;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.&lt;/p&gt;</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

Media type: application/json

Type: object

Example:

{
    "status": 400,
    "error": "Exception",
    "message": "The ID [0] provided is incorrect."
}

HTTP status code 404

No se ha encontrado la pregunta con el identificador {questionId}

Body

Media type: application/json

Type: object

Example:

{
    "status": 404,
    "error": "QuestionNotFound",
    "message": "A question could not be found with ID [65]."
}

/questions/{questionId}/answers get

get

Devuelva la respuesta de la pregunta {questionId}

Request
Response

URI Parameters

questionId: required (string)

HTTP status code 200

La información de la respuesta

Body

Media type: application/json

Type: object

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"
            }
        ]
    }
}

Media type: application/xml

Type: object

Example:

<?xml version="1.0"?>
<response>
  <status>200</status>
  <data>
    <id>40</id>
    <answer>&lt;p&gt;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.&lt;/p&gt;&lt;p&gt; &lt;/p&gt;</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

Media type: application/json

Type: object

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

Media type: application/json

Type: object

Example:

{
    "status": 404,
    "error": "Exception",
    "message": "A question could not be found with ID [140]"
}

Usuarios

Operaciones ligadas a usuarios

/users post

post

Crea un nuevo usuario y devuelve el 'access_token' del nuevo usuario creado.

Request
Response

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

Media type: application/json

Type: object

Example:

{
    "status": 200,
    "data": {
        "access_token": "35a9490afedce2b06bb1ffe245c0d6697b645e5b",
        "expires_in": 3600,
        "token_type": "Bearer",
        "scope": null,
        "refresh_token": "bfc0cdde2d61e7fff89bf1374ea3c3c5a35c3bcd"
    }
}

Media type: application/xml

Type: object

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

Media type: application/json

Type: object

Example:

{
    "status": 400,
    "error": "<Tipo de error>",
    "message": "<El motivo del error>"
}

Media type: application/xml

Type: object

Example:

<?xml version="1.0"?>
<response>
  <status>400</status>
  <error><Tipo de error></error>
  <message><El motivo del error></message>
</response>

/users/authenticate post

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.

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.

Request
Response

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

Media type: application/json

Type: object

Example:

{
    "status": 200,
    "data": {
        "access_token": "35a9490afedce2b06bb1ffe245c0d6697b645e5b",
        "expires_in": 3600,
        "token_type": "Bearer",
        "scope": null,
        "refresh_token": "bfc0cdde2d61e7fff89bf1374ea3c3c5a35c3bcd"
    }
}

Media type: application/xml

Type: object

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

Media type: application/json

Type: object

Example:

{
    "status": 400,
    "error": "Exception",
    "message": "invalid_request: Missing parameters: \"username\" and \"password\" required"
}

Media type: application/xml

Type: object

Example:

ponse>
  <status>400</status>
  <error>Exception</error>
  <message>invalid_request: Missing parameters: &quot;username&quot; and &quot;password&quot; required</message>
</response>

HTTP status code 401

Body

Media type: application/json

Type: object

Example:

{
    "status": 401,
    "error": "Exception",
    "message": "invalid_grant: Invalid username and password combination"
}

Media type: application/xml

Type: object

Example:

<?xml version="1.0"?>
<response>
  <status>401</status>
  <error>Exception</error>
  <message>invalid_grant: Invalid username and password combination</message>
</response>

/users/refresh post

post

Actualiza la sesión devolviendo un nuevo 'access_token'. No reemplaza al antiguo.

Request
Response

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

Media type: application/json

Type: object

Example:

{
    "status": 200,
    "data": {
        "access_token": "367ab2d1014349c7275b652016e167f056519860",
        "expires_in": 3600,
        "token_type": "Bearer",
        "scope": null
    }
}

Media type: application/xml

Type: object

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

Media type: application/json

Type: object

Example:

{
    "status": 400,
    "error": "Exception",
    "message": "invalid_request: Missing parameter: \"refresh_token\" is required"
}

Media type: application/xml

Type: object

Example:

<?xml version="1.0"?>
<response>
  <status>400</status>
  <error>Exception</error>
  <message>invalid_request: Missing parameter: &quot;refresh_token&quot; is required</message>
</response>

Comunidades Autónomas

Operaciones ligadas a las comunidades autónomas

/communities get

get

Devuelve el listado de las comunidades autónomas

Request
Response

Query Parameters

name: (string)
Filtrar por el nombre de la comunidad autónoma

HTTP status code 200

La lista de las comunidades autónomas

Body

Media type: application/json

Type: object

Example:

{
  "status": 200,
  "data": [
      {
          "id": "1",
          "name": "Andaluc\u00eda"
      },
      {
          "id": "2",
          "name": "Arag\u00f3n"
      },
      {
          "id": "3",
          "name": "Asturias"
      }
  ]
}

/communities/{communityId} get

get

Devuelve la información de la comunidad autónoma {communityId}

Request
Response

URI Parameters

communityId: required (string)

HTTP status code 200

La información de la comunidad autónoma

Body

Media type: application/json

Type: object

Example:

{
  "status": 200,
  "data": [
      {
          "id": "3",
          "name": "Asturias"
      }
  ]
}

HTTP status code 400

La ID de la comunidad autónoma es incorrecta

Body

Media type: application/json

Type: object

Example:

{
    "status": 400,
    "error": "Exception",
    "message": "The ID [0] provided is incorrect."
}

HTTP status code 404

No se ha encontrado la comunidad autónoma con el identificador {communityId}

Body

Media type: application/json

Type: object

Example:

{
    "status": 404,
    "error": "Exception",
    "message": "A community could not be found with ID [240]"
}

/communities/{communityId}/provinces get

get

Devuelva las provincias de la comunidad autónoma especificado en {communityId}

Request
Response

URI Parameters

communityId: required (string)

HTTP status code 200

Las provincias de la comunidad autónoma especificado en {communityId}

Body

Media type: application/json

Type: object

Example:

{
    "status": 200,
    "data": [
        {
            "id": "1",
            "name": "Alicante\/Alacant"
        },
        {
            "id": "2",
            "name": "Almer\u00eda"
        },
        {
            "id": "3",
            "name": "\u00c1lava\/Araba"
        },
        {
            "id": "4",
            "name": "Asturias"
        },
        {
            "id": "5",
            "name": "\u00c1vila"
        },
        {
            "id": "6",
            "name": "Badajoz"
        },
        {
            "id": "7",
            "name": "Illes Balears"
        },
        {
            "id": "8",
            "name": "Barcelona"
        },
        {
            "id": "9",
            "name": "Bizkaia"
        },
        {
            "id": "10",
            "name": "Burgos"
        },
        {
            "id": "11",
            "name": "C\u00e1ceres"
        },
        {
            "id": "12",
            "name": "C\u00e1diz"
        },
        {
            "id": "13",
            "name": "Cantabria"
        },
        {
            "id": "14",
            "name": "Castell\u00f3n\/Castell\u00f3"
        },
        {
            "id": "15",
            "name": "Ciudad Real"
        },
        {
            "id": "16",
            "name": "C\u00f3rdoba"
        }
}

Provincias

Operaciones ligadas a las provincias

/provinces get

get

Devuelve el listado de las provincias

Request
Response

Query Parameters

name: (string)
Filtrar por el nombre de la provincia

HTTP status code 200

La lista de las comunidades autónomas

Body

Media type: application/json

Type: object

Example:

{
    "status": 200,
    "data": [
        {
            "id": "1",
            "name": "Alicante\/Alacant"
        },
        {
            "id": "2",
            "name": "Almer\u00eda"
        },
        {
            "id": "3",
            "name": "\u00c1lava\/Araba"
        },
        {
            "id": "4",
            "name": "Asturias"
        },
        {
            "id": "5",
            "name": "\u00c1vila"
        },
        {
            "id": "6",
            "name": "Badajoz"
        },
        {
            "id": "7",
            "name": "Illes Balears"
        },
        {
            "id": "8",
            "name": "Barcelona"
        },
        {
            "id": "9",
            "name": "Bizkaia"
        },
        {
            "id": "10",
            "name": "Burgos"
        },
        {
            "id": "11",
            "name": "C\u00e1ceres"
        },
        {
            "id": "12",
            "name": "C\u00e1diz"
        },
        {
            "id": "13",
            "name": "Cantabria"
        },
        {
            "id": "14",
            "name": "Castell\u00f3n\/Castell\u00f3"
        },
        {
            "id": "15",
            "name": "Ciudad Real"
        },
        {
            "id": "16",
            "name": "C\u00f3rdoba"
        }
}

/provinces/{provinceId} get

get

Devuelve la información de la provincia

Request
Response

URI Parameters

provinceId: required (string)

HTTP status code 200

La información de la provincia

Body

Media type: application/json

Type: object

Example:

{
    "status": 200,
    "data": [
        {
            "id": "1",
            "name": "Alicante\/Alacant"
        }
}

HTTP status code 400

La ID de la provincia es incorrecta

Body

Media type: application/json

Type: object

Example:

{
    "status": 400,
    "error": "Exception",
    "message": "The ID [0] provided is incorrect."
}

HTTP status code 404

No se ha encontrado la provincia con el identificador {provinceId}

Body

Media type: application/json

Type: object

Example:

{
    "status": 404,
    "error": "Exception",
    "message": "A province could not be found with ID [36]"

/provinces/{provinceId}/towns get

get

Devuelva los pueblos de la provincia especificado en {provinceId}

Request
Response

URI Parameters

provinceId: required (string)

HTTP status code 200

Los pueblos de la provincia especificado en {provinceId}

Body

Media type: application/json

Type: object

Example:

{
    "status": 200,
    "data": [
        {
            "id": "1",
            "name": "Azpeitia"
        },
        {
            "id": "2",
            "name": "Azkoitia"
        },
        {
            "id": "3",
            "name": "Zestoa"
        },
        {
            "id": "4",
            "name": "Zarautz"
        }
    ]
}

Pueblos

Operaciones ligadas a los pueblos

/towns get

get

Devuelve el listado de los pueblos

Request
Response

Query Parameters

name: (string)
Filtrar por el nombre del pueblo

HTTP status code 200

La lista de los pueblos

Body

Media type: application/json

Type: object

Example:

{
    "status": 200,
    "data": [
        {
            "id": "1",
            "name": "Azpeitia"
        },
        {
            "id": "2",
            "name": "Azkoitia"
        },
        {
            "id": "3",
            "name": "Zestoa"
        },
        {
            "id": "4",
            "name": "Zarautz"
        }
    ]
}

/towns/{townId} get

get

Devuelve la información del pueblo

Request
Response

URI Parameters

townId: required (string)

HTTP status code 200

La información de la provincia

Body

Media type: application/json

Type: object

Example:

{
    "status": 200,
    "data": [
        {
            "id": "1",
            "name": "Azpeitia"
        }
    ]
}

HTTP status code 400

La ID del pueblo es incorrecta

Body

Media type: application/json

Type: object

Example:

{
    "status": 400,
    "error": "Exception",
    "message": "The ID [0] provided is incorrect."
}

HTTP status code 404

No se ha encontrado el pueblo con el identificador {townId}

Body

Media type: application/json

Type: object

Example:

{
    "status": 404,
    "error": "Exception",
    "message": "A town could not be found with ID [36]"

Osoigo API documentation version 0.3

Versiones de la API

get /versions

HTTP status code 200

Body

Políticos

get /politicians

Query Parameters

HTTP status code 200

Body

get /politicians/{politicianId}

URI Parameters

HTTP status code 200

Body

HTTP status code 400

Body

HTTP status code 404

Body

get /politicians/{politicianId}/questions

URI Parameters

Query Parameters

HTTP status code 200

Body

post /politicians/{politicianId}/questions

URI Parameters

Query Parameters

HTTP status code 200

Body

HTTP status code 400

Body

HTTP status code 401

Body

get /politicians/{politicianId}/questions/{questionId}

URI Parameters

HTTP status code 200

Body

HTTP status code 400

Body

HTTP status code 404

Body

get /politicians/{politicianId}/questions/{questionId}/answers

URI Parameters

HTTP status code 200

Body

HTTP status code 400

Body

HTTP status code 404

Body

Preguntas

get /questions

Query Parameters

HTTP status code 200

Body

get /questions/{questionId}

URI Parameters

HTTP status code 200

Body

HTTP status code 400

Body

HTTP status code 404

Body

get /questions/{questionId}/answers

URI Parameters

HTTP status code 200

Body

HTTP status code 400

Body

HTTP status code 404

Body

Usuarios

post /users

Query Parameters

HTTP status code 200

Body

HTTP status code 400

Body

post /users/authenticate

Query Parameters

HTTP status code 200

Body