Bienvenido a la wiki de API Taringa! (BETA)

---

Introducción:

 

La API (Application Program Interface) de Taringa! permite a cualquier persona interactuar con el contenido y/o información de Taringa! y Poringa!

 

El uso de la API es gratuito. Es obligatorio para cada desarrollador registrarse como tal para obtener una clave única de identificación para poder realizar las consultas a la API.

 

Cada método de llamada tiene un limite de consultas por minuto el cual se detalla en la información ampliada de cada caso. Este limite no es por aplicación, es para las IP que hace la consulta (clientes).

 

En esta wiki se presenta la documentación de la primera versión de la API.

Los métodos de llamada actuales permiten la posibilidad de interactuar con toda la información abierta a cualquier visitante del sitio (usuarios no registrados). En próximas etapas de desarrollo se presentarán opciones para la interacción con la información de usuarios registrados ampliando la posibilidad de generar mejores herramientas.

 

---

 

Formato URL de llamada (Request)

La API de Taringa! esta construida en base a peticiones REST (Representational State Transfer). Las respuestas a las consultas pueden ser en formato XML o JSON.

 

http://{DOMINIO}/api/{KEY}/{FORMATO}/{METODO DE LLAMADA}/{VARIABLE}/{VARIABLE}/{VARIABLE}

 

DOMINIO: dominio correspondiente al sitio del cual se desea realizar la consulta (ej.: http://www.taringa.net o http://www.poringa.net)

KEY: clave asignada al desarrollador de la aplicación.

FORMATO: tipo de formato del que se desea recibir la respuesta (XML o JSON).

MÉTODO DE LLAMADA: definicion del tipo de información que se desea consultar. 

VARIABLES: variables para la definicion del método de llamada (opcionales u obligatorias según cada caso).

 

Ej.: http://www.taringa.net/api/67354ffe2245aadt56/json/Posts-GetTopPosts/1/4/4

 

---

 

Fomatos de respuesta

• XML
• JSON

---

 

Opciones métodos de llamada:

 

* Llamadas relacionadas con los usuarios

• Users-GetUserData
• Users-GetLevels
• Users-GetPostsComments
• Users-GetPostsList

 

* Llamadas relacionadas con el sitio

• Posts-GetCategories
• Posts-GetCloudTags
• Site-GetSiteStats

 

* Llamadas relacionadas con los TOP

• Posts-GetTopPosts
• Posts-GetTopUsers

 

* Llamadas relacionadas con los posts 

• Posts-GetPostList
• Posts-GetPostData
• Posts-GetPostComments

 

 * Llamadas relacionadas con el buscador

• Posts-GetSearch
• Posts-GetPostsTag

 

* Llamadas relacionadas con la API

• GetRate

  

Índice de errores:

 

• error '1': 'Method missing'
• error '2': 'Invalid API key'
• error '3': 'Invalid format'
• error '4': 'Invalid method'
• error '5': 'Missing parameters'
• error '6': 'Bad User nickname'
• error '7': 'Invalid parameter'
• error '8': 'No data'
• error '9': 'Post deleted'
• error '10' :'Private post'
• error '11': 'Rate Limiting Exceeded'
• error '1000': 'unknown error'

 

 

---

 

Contacto o sugerencias:

Ante cualquier duda o sugerencia nos puede escribir por medio del siguiente formulario.

 

Formulario de registro como desarrollador:

Para poder utilizar esta API es necesario que se registre en el siguiente formulario.