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.: 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.:
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'