FPC API

La API (Application Program Interface) de FPC permite a cualquier persona interactuar programaticamente con FPC.

En uso de la API de FPC es gratuito, y devuelve datos generados por FPC en un formato que es facilmente integrado con una aplicación o página web.

Esta es la primera versión de la API de FPC. Actualmente ofrece un grupo de llamadas básicas, pero muy pronto iremos añadiendo mayores funcionalidades.

En este momento, la API de FPC acepta llamadas tipo "REST" y devuelve los resultados en formato XML. Más adelante es posible que ofrezcamos otras maneras de acceder a la API así como otros formatos a usar en los resultados.

Las llamadas actuales se pueden agrupar en tres clases: Sitio, Noticias y Usuarios

Llamadas relacionadas con el Sitio

coRank.Site.GetInfo
Devuelve información general sobre el sitio.
Parámetros:
Ninguno

Ejemplo de llamada:
http://fpc.corank.com/api/coRank.Site.GetInfo
Ejemplo de respuesta:
```
<corank siteid="437">
	<title>Título de este sitio</title>
	<descr>Descripción de este stio</descr>
	<locale>es</locale>
	<ownerid>2735</ownerid>
	<vup>Interestante</vup>
	<vdown>Aburrido</vdown>
	<sword>fuente</sword>
	<swords>fuentes</swords>
</corank>
```
Detalles de la respuesta::
- vup y vdown son las palabras definidas para las acciones de votar positiva y negativamente.
- sword es la palabra definida para referirse a "fuente" (fuente/amigo/contacto, etc).
- swords es la misma palabra pero en plural.
coRank.Site.GetCategories
Devuelve una lista de las categorías defindas en el sitio.
Parámetros:
Ninguno

Ejemplo de llamada:
http://fpc.corank.com/api/coRank.Site.GetCategories
Ejemplo de respuesta:
```
<corank siteid="437">
	<cat id="1" idname="arte">Arte y Diseño</cat>
	<cat id="2" idname="negocios">Negocios</cat>
	<cat id="4" idname="actualidad">Actualidad</cat>
	...
</corank>
```
Detalles de la respuesta::
- id es el ID numérico de esa categoría.
- idname es el nombre usado en las URLs para esa categoría, por ejemplo http://fpc.corank.com/tech/all/cat/arts
- El valor entre las etiquetas <cat>...</cat> es el nombre que describe la categoría.
La respuesta contiene todas las categorías definidas en el sitio.
coRank.Site.GetTotalStats
Devuelve:
- El número total de usuarios registrados en el sitio.
  Este número no es el total de personas que han visitado el sitio. Solo se cuentan usuarios registrados.
- El número total de noticias enviadas
- El número de votos efectuados en el sitio
Parámetros:
Ninguno

Ejemplo de llamada:
http://fpc.corank.com/api/coRank.Site.GetTotalStats
Ejemplo de respuesta:
```
<corank siteid="437">
	<users>2455</users>
	<votes>12447</votes>
	<stories>821</stories>
</corank>
```

Llamadas relacionadas con las Noticias

coRank.News.GetItem
Devuelve casi todo lo que puedas necesitar sobre una noticia. Posiblemente sea la función más usada de toda la API.
Parámetros:
Puede tomar bien 'id' o 'url' pero no ámbas.

id
El ID numérico de la noticia.

url
El path identificador de la noticia.

Ejemplo de llamada:
Con el ID numérico: http://fpc.corank.com/api/coRank.News.GetItem/id=771
Con el path: http://fpc.corank.com/api/coRank.News.GetItem/url=todo-pasa-y-todo-queda
En el segundo ejemplo estamos pidiendo información sobre la entrada que puede ser accedida directamente visitando http://fpc.corank.com/tech/story/todo-pasa-y-todo-queda
Ejemplo de respuesta:
```
<corank siteid="437">
	<items>
		<item id="4478" pvotes="221" nvotes="17" comments="12" catid="16"
			  senderid="2234" sendernick="pepeluis"
			  urlname="noticia-sobre-nada"
			  sdate="1170668942">
			<title>Noticia sobre nada de nada</title>
			<link>http://www.example.com/</link>
			<description>Esta noticia no trata nada interesante.</description>
			<tags>
				<tag>party</tag>
				<tag>love</tag>
			</tags>
		</item>
	</items>
</corank>
```
Detalles de la respuesta::
- La etiqueta item incluye siempre los valores siguientes:
  - id: El ID numérico de la noticia
  - pvotes: Número total de votos positivos en este momento
  - nvotes: Número total de votos negativos en este momento
  - comments: Número total de comentarios en este momento
  - catid: El ID numérico de la categoría de esta noticia
  - senderid: El ID numérico de la persona que envió la noticia. Si se permiten envíos anónimos, el valor será cero (0).
  - sendernick: El nombre del usuario (alias) que envió la noticia. Si se permiten envíos anónimos, el valor será "Desconocido" (sin las comillas).
  - urlname: El path para esta noticia. Por ejemplo, si la URL para aceder esta noticia es http://fpc.corank.com/tech/story/todo-pasa-y-todo-queda, el valor de "urlname" será "todo-pasa-y-todo-queda" (sin las comillas).
  - sdate: La fecha en la que se publicó la noticia (PST/PDT). El valor es el número de segundos desde las 00:00:00 del 1 de Enero de 1970 (Epoch).
- El valor entre las etiquetas <link>...</link> es la URL completa de la noticia original.
- El valor de title y description son el título y la descripción de la noticia. Observa que el contenido de description podría usar varias líneas, como por ejemplo:
```
			<description>Esta noticia no trata nada 
interesante.</description>
```
- El contenido entre las etiquetas tag son las "tags" o etiquedas asignadas a la noticia. Si no se asignó ninguna "tag", el resultado no incluirá la sección <tags>...</tags>
coRank.News.GetItemFromUrl
Esta función es idéntica a la anterior, excepto que el único parámetro que toma, en lugar de ser el ID de la noticia o el "path" identificador, toma la URL de la página original.
Es por tanto la función ideal para saber si una página ha sido ya enviada o no.
Parámetros:

url
La URL de la noticia original

Ejemplo de llamada:
http://fpc.corank.com/api/coRank.News.GetItemFromUrl/url=http://www.example.com/art/757.html
IMPORTANTE: Si la URL contiene el símbolo de interrogación ? deberás URL-codificarlo primero, es decir utilizando %3F en lugar de ?
Aquí estamos pidiendo información sobre la entrada que apunte a la URL http://www.example.com/art/757.html
Ejemplo de respuesta:
```
<corank siteid="437">
	<items>
		<item id="4478" pvotes="221" nvotes="17" comments="12" catid="16"
			  senderid="2234" sendernick="pepeluis"
			  urlname="noticia-sobre-nada"
			  sdate="1170668942">
			<title>Noticia sobre nada de nada</title>
			<link>http://www.example.com/</link>
			<description>Esta noticia no trata nada interesante.</description>
			<tags>
				<tag>party</tag>
				<tag>love</tag>
			</tags>
		</item>
	</items>
</corank>
```
Detalles de la respuesta::
- La etiqueta item incluye siempre los valores siguientes:
  - id: El ID numérico de la noticia
  - pvotes: Número total de votos positivos en este momento
  - nvotes: Número total de votos negativos en este momento
  - comments: Número total de comentarios en este momento
  - catid: El ID numérico de la categoría de esta noticia
  - senderid: El ID numérico de la persona que envió la noticia. Si se permiten envíos anónimos, el valor será cero (0).
  - sendernick: El nombre del usuario (alias) que envió la noticia. Si se permiten envíos anónimos, el valor será "Desconocido" (sin las comillas).
  - urlname: El path para esta noticia. Por ejemplo, si la URL para aceder esta noticia es http://fpc.corank.com/tech/story/todo-pasa-y-todo-queda, el valor de "urlname" será "todo-pasa-y-todo-queda" (sin las comillas).
  - sdate: La fecha en la que se publicó la noticia (PST/PDT). El valor es el número de segundos desde las 00:00:00 del 1 de Enero de 1970 (Epoch).
- El valor entre las etiquetas <link>...</link> es la URL completa de la noticia original.
- El valor de title y description son el título y la descripción de la noticia. Observa que el contenido de description podría usar varias líneas, como por ejemplo:
```
			<description>Esta noticia no trata nada 
interesante.</description>
```
- El contenido entre las etiquetas tag son las "tags" o etiquedas asignadas a la noticia. Si no se asignó ninguna "tag", el resultado no incluirá la sección <tags>...</tags>
coRank.News.GetCatItems
Devuelve el listado de noticias bajo una categoría determinada. El número máximo de noticias que pueden aparecer en los resultados es 100. Para obtener noticias más allá de la posición 100, deberás utilizar los parámetros "start" y "end".
Si la diferencia "end" menos "start" es mayor de 100, el valor de "end" se ignorará, y solo se incluirá en los resultados las primeras 100 noticias, empezando por la que esté en la posición "start".
Parámetros:

id
ID de la cagegoría.

start
Indice inicial. Si no se incluye, se asume que es 1.

end
Indice final. Debe ser un número mayor de "start". Si no se incluye, se asume que será start+100

Ejemplo de llamada:
Para obtener los primeros 100 resultados: http://fpc.corank.com/api/coRank.News.GetCatItems/id=16&start=1&end=100

Para obtener los resultados desde el 100 al 150: http://fpc.corank.com/api/coRank.News.GetCatItems/id=16&start=100&end=150
Ejemplo de respuesta:
```
<corank siteid="437">
  <cat id="2" total="300">
    <item id="231" index="1" />
    <item id="237" index="2" />
    <item id="295" index="3" />
    ...
  </cat>
</corank>
```
Detalles de la respuesta::
- El valor de total dentro de la etiqueta cat indica el número total de noticias bajo la categoría indicada.
- Las etiquetas item (una por noticia) contienen los siguientes valores:
  - id: El ID numérico de la noticia.
  - index: La posición en los resultados.
coRank.News.GetComments
Devuelve todos los comentarios publicados sobre una noticia.
Parámetros:
Puede tomar bien 'id' o 'url' pero no ámbas.

id
El ID numérico de la noticia.

url
El path the la noticia.

Ejemplo de llamada:
Con el ID numérico: http://fpc.corank.com/api/coRank.News.GetComments/id=771
Con el path de la URL: http://fpc.corank.com/api/coRank.News.GetComments/url=todo-pasa-y-todo-queda
En el segundo ejemplo estamos pidiendo los comentarios enviados a la entrada que se peude leer directamente visitando http://fpc.corank.com/tech/story/todo-pasa-y-todo-queda
Ejemplo de respuesta:
```
<corank siteid="437">
  <item id="4478" comments="12">
    <comments>
      <comment id="1" nick="pepeluis"
        sdate="1170668942" rank="1,0,0,3,8"><![CDATA[Gran noticia]]></comment>
      <comment id="2" nick="pepeluis"
        sdate="1170698547" rank="5,1,0,2,0" replyto="1"><![CDATA[De grande nada]]></comment>
			...
    </comments>
  </item>
</corank>
```
Detalles de la respuesta::
- La etiqueta item siempre incluirá estos dos valores.
  - id: El ID numérico de la noticia.
  - comments: El número total de comentarios a esta noticia.
- La etiqueta comment incluye varios valores. Todos ellos aparecen siempre, excepto por el valor "replyto" que solo aparecerá si el comentario es una respuesta a otro comentario:
  - id: El ID numérico del comentario.
  - nick: El nombre de usuario o alias de la persona que envió el comentario.
  - sdate: Fecha en la que el comentario se publicó (PST/PDT). El valor es el número de segundos desde las 00:00:00 del 1 de Enero de 1970 (Epoch).
  - rank: Las cinco diferentes valoraciones que se le pueden dar a un comentario, en este órden: De acuerdo, discrepo, aburrido, irrelevante y troll.
  - replyto: Si el comentario es una respuesta a otro comentario, aquí se indica el ID numérico del comentario al que se respondió.
- Cada etiqueta comment también contiene, por supuesto, el comentario propiamente dicho, dentro de una sección CDATA (lo que va entre los códigos <![CDATA[ ... ]]>). El texto del comentario podría ocupar varias líneas:
```
...
	<comments>
			<comment ...><![CDATA[Esta noticia es
la mar de maja]]></comment>
	</comments>
...
```
coRank.News.GetFeatured, coRank.News.GetUpcoming, coRank.News.GetTop
Estas llamadas devuelven las últimas noticias destacadas (coRank.News.GetFeatured), enviadas (coRank.News.GetUpcoming), o más votadas (coRank.News.GetTop).
Los resultados se devuelven ordenados de la siguiente manera:
- coRank.News.GetFeatured: Por fecha, primero las últimas noticias destacadas.
- coRank.News.GetUpcoming: Por fecha, primero las últimas noticias enviadas.
- coRank.News.GetTop: Las noticias más votadas primero.
El número máximo de noticias que pueden aparecer en los resultados es 100. Para obtener noticias más allá de la posición 100, deberás utilizar los parámetros "start" y "end".
Si la diferencia "end" menos "start" es mayor de 100, el valor de "end" se ignorará, y solo se incluirá en los resultados las primeras 100 noticias, empezando por la que esté en la posición "start".
Observa que FPC solo mantiene un total de 300 noticias destacadas, por lo que intentar obtener noticias destacadas más allá de la posición 300 no devolverá ninguna noticias.
Parámetros:

start
Indice inicial. Si no se incluye, se asume que es 1.

end
Indice final. Debe ser un número mayor de "start". Si no se incluye, se asume que será start+100

Ejemplo de llamada:
Para obtener las últimas noticias destacadas (hasta un total de 100): http://fpc.corank.com/api/coRank.News.GetFeatured

Para obtener las últimas noticias enviadas, pero de la 20 a la 40 : http://fpc.corank.com/api/coRank.News.GetUpcoming/start=20&end=40

Para obtener las 30 noticias más votadas: http://fpc.corank.com/api/coRank.News.GetTop/end=30
Ejemplos de respuestas:
Para coRank.News.GetFeatured:
```
<corank siteid="437">
  <featured>
    <item id="231" index="1" />
    <item id="237" index="2" />
    <item id="295" index="3" />
    ...
  </featured>
</corank>
```
Para coRank.News.GetUpcoming:
```
<corank siteid="437">
  <upcoming>
    <item id="231" index="1" />
    <item id="237" index="2" />
    <item id="295" index="3" />
    ...
  </upcoming>
</corank>
```
Para coRank.News.GetTop:
```
<corank siteid="437">
  <top>
    <item id="231" index="1" />
    <item id="237" index="2" />
    <item id="295" index="3" />
    ...
  </top>
</corank>
```
Detalles de la respuesta::
Las respuestas a las tres llamadas son identicas, excepto por la etiqueta identificadora: featured (destacadas), upcoming (últimas enviadas) y top (más votadas).
- La etiqueta item (una por noticia) contiene siempre los valores siguientes:
  - id: El ID numérico de la noticia.
  - index: La posición en los resultados.

Llamadas relacionadas con los Usuarios

Todas las llamadas relacionadas con los usuarios ofrecen información de los usuarios, en relación con el sitio en concreto. Esto es importante porque un mismo usuario puede tener cuenta en más de un sitio en coRank, pero la mayoría de los datos en cada sitio son diferentes.

coRank.User.GetProfile
Devuelve información general sobre cualquier usuario.
Parámetros: Puede tomar bien 'id' o 'nick' pero no ámbos.

id
El ID numérico del usuario.

nick
El nombre de usuario (nick, alias).

Ejemplo de llamadas:
Con el ID numérico del usuario: http://fpc.corank.com/api/coRank.User.GetProfile/id=771
Con el nombre de usuario: http://fpc.corank.com/api/coRank.User.GetProfile/nick=pepeluis
Ejemplo de respuesta:
```
<corank siteid="437">
	<user id="3345" nick="pepeluis" sources="12" fans="34" pviews="67" grank="3" mrank="2">
		<name>Pepe Luis</name>
		<location>US</location>
		<blog>http://mibloguete.example.com/</blog>
		<about><![CDATA[Me gusta lo que me gusta]]></about>
		<stories submitted="22" vup="3344" vdown="11" fav="12" />
	</user>
</corank>
```
Detalles de la respuesta::
- La etiqueta user siempre incluye estos valores.
  - id: El ID numérico del usuario
  - nick: El nombre del usuario (nick o alias)
  - sources: Número defuentes que tiene este usuario
  - fans: Número de fans
  - pviews: Número de visitas realizadas al perfíl de este usuario
  - grank: Posición en el ranking global
  - mrank: Posición en el ranking mensual
- La etiqueta stories siempre se incluye en los resultados, incluso si su valor es cero. Incluirá
  - submitted: Número de noticias enviadas
  - vup: Número de votos positivos
  - vdown: Número de votos negativos
  - fav: Número de noticias que el usuario ha guardado en sus favoritos
Los valores siguientes aparecerán solo si el usuario los ha indicado:
- name: El nombre del usuario
- location: El código de país ISO 3161 de dos letras
- blog: La URL del blog del usuario
- about: El texto "Sobre mí". Va incluído en una sección CDATA y puede ocupar más de una línea:
```
...
	<about><![CDATA[Me gusta lo
que me gusta]]></about>
...
```
coRank.User.GetSubmitted, coRank.User.GetVoted
Estas llamadas devuelven el listado de noticias que un usuario ha enviado (coRank.User.GetSubmitted) o votado (coRank.User.GetVoted).
El número máximo de noticias que pueden aparecer en los resultados es 100. Para obtener noticias más allá de la posición 100, deberás utilizar los parámetros "start" y "end".
Si la diferencia "end" menos "start" es mayor de 100, el valor de "end" se ignorará, y solo se incluirá en los resultados las primeras 100 noticias, empezando por la que esté en la posición "start".
Los resultados aparecen ordenados por fecha, apareciendo en primera posición las últimas noticias enviadas o votadas. Más adelante posiblemente ofrezcamos la posibilidad de elegir diferentes criterios en cuanto al órden.
Parámetros:
Para identificar al usuarios, debes incluir bien el 'id' o 'nick' pero no ámbos.

id
El ID numérico del usuario.

nick
El nombre de usuario (nick, alias).

start
Indice inicial. Si no se incluye, se asume que es 1.

end
Indice final. Debe ser un número mayor de "start". Si no se incluye, se asume que será start+100

Ejemplo de llamada:
Para obtener las últimas 100 noticias enviadas por el usuario con ID 16: http://fpc.corank.com/api/coRank.User.GetSubmitted/id=16&start=1&end=100

Para obtener, de las últimas noticias votadas por pepeluis, las que caen en los puestos 100 al 150 : http://fpc.corank.com/api/coRank.User.GetVoted/nick=pepeluis&start=100&end=150
Ejemplos de respuestas:
Para coRank.User.GetSubmitted:
```
<corank siteid="437">
	<user id="16" nick="joe" total="300">
		<item id="231" index="1" />
		<item id="237" index="2" />
		<item id="295" index="3" />
		...
	</user>
</corank>
```
Para coRank.User.GetVoted:
```
<corank siteid="437">
	<user id="16" nick="joe" total="300">
		<item id="231" vote="+" index="1" />
		<item id="237" vote="+" index="2" />
		<item id="295" vote="-" index="3" />
		...
	</user>
</corank>
```
Detalles de la respuesta::
- La etiqueta user (solo una en cada resultado) contiene siempre los valores siguientes:
  - total: El número total de noticias enviadas/votadas por este usuario.
  - id: El ID numérico del usuario.
  - nick: El nombre de usuario (nick/alias).
- La etiqueta item (una por noticia) contiene los valores siguientes:
  - id: El ID numérico de la noticia.
  - index: La posición en los resultados.
  - vote: (Solo en coRank.User.GetVoted) El voto. + si fué un voto positivo, o - si fué negativo
coRank.User.GetSources
Esta llamada devuelve el listado de fuentes de un usuario.
El número máximo de usuarios (fuentes) que pueden aparecer en los resultados es 100. Para obtener fuentes más allá de la posición 100, deberás utilizar los parámetros "start" y "end".
Si la diferencia "end" menos "start" es mayor de 100, el valor de "end" se ignorará, y solo se incluirá en los resultados los primeros 100 usuarios, empezando por el que esté en la posición "start".
Los resultados aparecen por el órden en que los usuarios fueron añadidos como fuentes.
Parámetros:
Puede tomar bien 'id' o 'nick' pero no ámbos.

id
El ID numérico del usuario.

nick
El nombre de usuario (nick, alias).

start
Indice inicial. Si no se incluye, se asume que es 1.

end
Indice final. Debe ser un número mayor de "start". Si no se incluye, se asume que será start+100

Ejemplo de llamada:
Para obtener los primeros 100 usuarios añadidos como fuente por el usuario con ID 16: http://fpc.corank.com/api/coRank.User.GetSources/id=16&start=1&end=100

Para obtener los usuarios 100 a 105 añadidos como fuente por el usuario Pepeluis: http://fpc.corank.com/api/coRank.User.GetSources/nick=pepeluis&start=100&end=150
Ejemplo de respuesta:
```
<corank siteid="437">
	<user id="16" nick="joe" total="98">
		<source id="231" weight="100" index="1" />
		<source id="237" weight="100" index="2" />
		<source id="295" weight="50" index="3" />
		...
	</user>
</corank>
```
Detalles de la respuesta::
- La etiqueta user (una por resultados) siempre contiene los valores siguientes:
  - total: El número total de fuentes que tiene este usuario.
  - id: El ID numérico del usuario.
  - nick: El nombre del usuario (nick/alias).
- La etiqueta source (una por fuente) contiene los valores siguientes:
  - id: El ID numérico de la persona que es fuente del usuario.
  - weight: El peso o influencia como fuente dada por el usuario.
  - index: La posición en los resultados.
coRank.User.GetFans
Devuelve la lista de fans de un usuario en particular.
El número máximo de fans que pueden aparecer en los resultados es 100. Para obtener fans más allá de la posición 100, deberás utilizar los parámetros "start" y "end".
Si la diferencia "end" menos "start" es mayor de 100, el valor de "end" se ignorará, y solo se incluirá en los resultados los primeros 100 usuarios, empezando por el que esté en la posición "start".
Los resultados aparecen por el órden en que los fansf añadieron a este usuario como su fuentes.
Parámetros:
Puede tomar bien 'id' o 'nick' pero no ámbos.

id
El ID numérico del usuario.

nick
El nombre de usuario (nick, alias).

start
Indice inicial. Si no se incluye, se asume que es 1.

end
Indice final. Debe ser un número mayor de "start". Si no se incluye, se asume que será start+100

Ejemplo de llamada:
Para obtener los primeros 100 fans del usuario con ID 16: http://fpc.corank.com/api/coRank.User.GetFans/id=16&start=1&end=100

Para obtener los primeros 100 a 150 fans de Pepeluis: http://fpc.corank.com/api/coRank.User.GetFans/nick=joe&start=100&end=150
Ejemplo de respuesta:
```
<corank siteid="437">
	<user id="16" nick="joe" total="98">
		<fan id="231" index="1" />
		<fan id="237" index="2" />
		<fan id="295" index="3" />
		...
	</user>
</corank>
```
Detalles de la respuesta::
- La etiqueta user (aparece solo una vez en los resultado) contiene siempre los valores siguientes:
  - total: El número total de fans que tiene este usuario.
  - id: El ID numérico del usuario.
  - nick: El nombre (nick/alias) del usuario.
- La etiqueta fan (una por fan) contendrá los valores siguientes:
  - id: El ID numérico del fan.
  - index: La posición en los resultados.
coRank.User.GetLikeMinded
Esta llamada devuelve el listado de los usuarios afines de un usuario en particular.
Los resultados aparecen ordenados por afinidad. Es decir, los usuarios más afines aparecerán al principio. El número máximo de usuarios afines es 50. No puedes obtener usuarios afines más allá del puesto 50.
Parámetros:
Puede tomar bien 'id' o 'nick' pero no ámbos.

id
El ID numérico del usuario.

nick
El nombre de usuario (nick, alias).

Ejemplo de llamada:
http://fpc.corank.com/api/coRank.User.GetLikeMinded/id=16

http://fpc.corank.com/api/coRank.User.GetLikeMinded/nick=joe
Ejemplo de respuesta:
```
<corank siteid="437">
	<user id="16" nick="joe" total="23">
		<match id="231" index="1" />
		<match id="237" index="2" />
		<match id="295" index="3" />
		...
	</user>
</corank>
```
NOTA: El listado de usuarios afines suele incluir otros datos (número de noticias votadas de la misma manera que el usuario, etc). Dicha información todavía no es devuelta en esta llamada, pero lo será en una futura versión de la API.
Detalles de la respuesta::
- La etiqueta user (una sola en cada resultado) contiene siempre los valores siguientes:
  - total: El número total de usuarios afines.
  - id: El ID numérico del usuario.
  - nick: El nombre (nick/alias) del usuario.
- Las etiquetas match (una por cada usuario afín) contendrán los valores siguientes:
  - id: El ID numérico del usuario afín.
  - index: La posición en los resultados.

Códigos de error

Cuando una llamada a la API no puede completarse o es incapaz de devolver los resultados esperados, genera en su lugar un error.

Ejemplo de respuesta:

<rsp stat="fail">
	<err code="1" msg="Method missing" />
</rsp>

Detalles de la respuesta::

La etiqueta err contiene siempre estos dos valores:
- code: Un código numérico.
- msg: Un breve mensaje describiendo el error.

Los códigos numéricos de error actuales, sus mensajes, y su significado en español son:

1 - Method missing (Falta el método, la función a llamar)
2 - Invalid API key (Clave de API inválida - no se utiliza por el momento)
3 - Missing parameters (Faltan parámetros)
4 - The end parameter is smaller than the start parameter (El parámetro "end" es más pequeño que el parámetro "start")
5 - No story found (No se encontró la noticia)
6 - No stories found (No se encontraron noticias)
7 - No user found (No se encontró este usuario)
8 - No users found (No se encontraron usuarios)
8 - Daily API calls limit reached (Se ha alcanzado el límite diario de llamadas a la API - no se utiliza)
9 - User exists but has never used this site (Este usuario existe pero nunca ha utilizado ese sitio)
<< Volver