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
Opciones métodos de llamada:
* Llamadas relacionadas con los usuarios
* Llamadas relacionadas con el sitio
* Llamadas relacionadas con los TOP
* Llamadas relacionadas con los posts
* Llamadas relacionadas con el buscador
* Llamadas relacionadas con la API
Í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.
Comments (5)
Leandro said
at 2:04 pm on Nov 1, 2009
Hola me parece o ninguna api esta funcionando?
Luciano Longo said
at 1:32 am on Dec 8, 2009
Los errores deberían devolver los codigos HTTP correspondientes! Por ejemplo, si yo pongo un API key cualquiera me devuelve un error, pero con 200 OK........ Cuando debería responder con 401 Unauthorized / 403 Forbidden. Esto ahorra recursos a la hora de chequear por un error, en especial con los de logueo, ya que en general, si me tira 401 o 403 se que es porque no esta bien mi autentificacion y no necesito parsear la respuesta a menos que realmente quiera el mensaje.
Fragger said
at 6:01 pm on Jan 19, 2010
Perdon, pero no puedo encontrar por ningun lado la key que se me asigno para poder desarrollar con su API ...
disculpas ...
Fragger said
at 7:57 pm on Jan 19, 2010
Solucionado ... !
Josh Alles said
at 10:09 am on Jan 21, 2010
http://www.hossohbet.net/forum
You don't have permission to comment on this page.