Navegación

Inicio

Búsqueda en la Ayuda

Búsqueda avanzada »

Experto

A continuación describimos las llamadas a la API para obtener información referente a los expertos.

Os recordamos que SIEMPRE debéis incluir la ApiKey. (NOTA: En los ejemplos se da un ApiKey no válida)

Vamos a dividir la información de los expertos entre pública y privada. La pública hace referencia a toda esa información que puede accederse de forma pública en Todoexpertos.com (perfil de experto, respuestas del experto, etc.), mientras que la privada hace referencia a la información que encontraríamos en MiTodoexpertos. Tal y como se informará más adelante, la información privada requiere consentimiento por parte del experto.

Editar

Información pública

Editar

/username/expertprofile

Descripción: Perfil del experto.
Ejemplo de llamada: http://api.todoexpertos.com/v1/username/expertprofile?apikey=1234
- username: nombre del experto del que quiere obtenerse el profile.
Ejemplo de respuesta:

<?xml version="1.0" encoding="utf-8"?>
<rss version="2.0" xmlns:te="http://www.todoexpertos.com/api/te">
  <channel>
    <title>GetExpertProfile</title>
    <description>Recoge el perfil del experto</description>
    <link>http://api.todoexpertos.com/username/expertprofile</link>
    <item>
      <title>Nombre del experto</title>
      <te:points>Puntos actuales</te:points>
      <te:score>Valoración media</te:score>
      <te:finishedquestions>Cantidad de preguntas que le han finalizado</te:finishedquestions>
      <te:summary>Resumen del experto</te:summary>
    </item>
  </channel>
</rss>

Editar

/username/expertprofile/categorypath

Descripción: Perfil del experto en una categoría específica.
Ejemplo de llamada: http://api.todoexpertos.com/v1/username/expertprofile/categorypath?apikey=1234
- username: nombre del experto del que quiere obtenerse el profile.
- categorypath: path de la categoría.
Ejemplo de respuesta:

<?xml version="1.0" encoding="utf-8"?>
<rss version="2.0" xmlns:te="http://www.todoexpertos.com/api/te">
  <channel>
    <title>GetExpertProfile</title>
    <description>Recoge el perfil del experto</description>
    <link>http://api.todoexpertos.com/username/expertprofile</link>
    <item>
      <title>Nombre del experto y su categoría</title>
      <te:points>Puntos actuales en la categoría</te:points>
      <te:score>Valoración media en la categoría</te:score>
      <te:finishedquestions>Preguntas finalizadas en la categoría</te:finishedquestions>
      <te:summary>Resumen del experto en la categoría</te:summary>
    </item>
  </channel>
</rss>

Editar

/username/categories

Descripción: Categorías a las que pertenece el experto.
Ejemplo de llamada: http://api.todoexpertos.com/v1/username/categories?apikey=1234
- username: nombre del experto del que quiere obtenerse el profile.
Ejemplo de respuesta:

<?xml version="1.0" encoding="utf-8"?>
<rss version="2.0" xmlns:te="http://www.todoexpertos.com/api/te">
  <channel>
    <title>GetExpertCategories</title>
    <description>Devuelve las categorías del experto</description>
    <link>http://api.todoexpertos.com/username/categories/</link>
    <item>
      <title>Nombre de la categoría</title>
      <te:categorypath>Path de la categoría</te:categorypath>
      <te:categoryurl>Url de la categoría</te:categoryurl>
    </item>
    ...
  </channel>
</rss>

Editar

/username/answers

Descripción: Respuestas públicas generales de un experto.
Ejemplo de llamada: http://api.todoexpertos.com/v1/username/answers?apikey=1234
- username: nombre del experto del que se quiere obtener las respuestas.
Ejemplo de respuesta:

<?xml version="1.0" encoding="utf-8"?>
<rss version="2.0">
  <channel>
    <title>Experto que responde la pregunta</title>
    <description>Preguntas en TodoExpertos.com</description>
    <link>http://www.todoexpertos.com/</link>
    <item>
      <title>Título de la respuesta</title>
      <description>Ejemplo de texto de la respuesta</description>
      <link>Url de la respuesta</link>
    </item>
    ...
  </channel>
</rss>

Editar

/username/answers/categorypath

Descripción: Respuestas públicas generales de un experto de una categoría.
Ejemplo de llamada: http://api.todoexpertos.com/v1/username/answers/categorypath?apikey=1234
- username: nombre del experto del que se quiere obtener las respuestas.
- categorypath: path de la categoría.
Ejemplo de respuesta: el RSS devuelto es el mismo que para el caso anterior.

Editar

/experts

Descripción: Listado de expertos (ordenados por ranking).
Ejemplo de llamada: http://api.todoexpertos.com/v1/experts?apikey=1234
Ejemplo de respuesta:

<?xml version="1.0" encoding="utf-8"?>
<rss version="2.0">
  <channel>
    <title>Expertos</title>
    <description>Expertos en TodoExpertos.com</description>
    <link>http://www.todoexpertos.com/categorias/</link>
    <item>
      <title>Nombre del experto</title>
      <description>Resumen del experto</description>
      <link>Url del currículum general del experto</link>
    </item>
    ...
  </channel>
</rss>

Editar

/experts/categorypath

Descripción: Listado de expertos (ordenados por ranking) de una categoría.
Ejemplo de llamada: http://api.todoexpertos.com/v1/experts/categorypath?apikey=1234
- categorypath: path de la categoría.
Ejemplo de respuesta:

<?xml version="1.0" encoding="utf-8"?>
<rss version="2.0">
  <channel>
    <title>Expertos de la categoría</title>
    <description>Descripción de la categoría</description>
    <link>http://www.todoexpertos.com/categorias/categorypath</link>
    <item>
      <title>Nombre del experto</title>
      <description>Resumen del experto</description>
      <link>Url de la ficha del experto en la categoría</link>
    </item>
    ...
  </channel>
</rss>

Editar

Información privada

Podemos acceder a la información privada del experto. Para ello debemos disponer de su nombre y contraseña. El caso más típico del uso de la información privada del experto es la que hará el propio desarrollador. Por ejemplo, para listar las respuestas que ha dado y le han finalizado, o las que aún siguen activas.

Para acceder a la información privada, además de la ApiKey hay que añadir un nuevo parámetro al QueryString: el AuthCode. Para saber cómo se obtiene el AuthCode deberás ver el método explicado en la información privada de la API del usuario.

A continuación listamos y describimos las llamadas REST para acceder a la información privada del usuario. (NOTA: En los ejemplos se da un ApiKey y un AuthCode no válidos).

Editar

/username/answers/method

Descripción: Devuelve un listado de las respuestas hechas según el método que se le pase. Por ejemplo si quisiéramos ver las respuestas finalizadas pondríamos "finished", si quisiéramos las respuestas nuevas pondríamos "active", etc.
Ejemplo de llamada: http://api.todoexpertos.com/v1/username/answers/method?apikey=1234&AuthCode=abcd
- username: nombre del experto del que quiere obtenerse su listado de respuestas.
- method: método que queremos obtener. A continuación un listado descriptivo de todos los métodos:
  - new: respuestas con nuevas peticiones de aclaración que aún no has respondido/finalizado, o preguntas hechas directamente al experto.
  - activas: respuestas activas.
  - finished: respuestas finalizadas.
  - discarted: respuestas descartadas.
Ejemplo de respuesta:

<?xml version="1.0" encoding="utf-8"?>
<rss version="2.0">
  <channel>
    <title>Respuestas finalizadas de experto</title>
    <description>Respuestas finalizadas de experto</description>
    <link>http://www.todoexpertos.com/mitodoexpertos/expert/answers/finished</link>
    <item>
      <title>Título de la respuesta</title>
      <description>Texto de la respuesta</description>
      <link>Enlace de la respuesta</link>
    </item>
    ...
  </channel>
</rss>