Estado de mensajes

Mensajes del sitio mexicodiario.com

Para conocer el estado de mensajes están disponibles dos métodos: XML y JSON. Cabe mencionar que se utilizan los mismos parámetros que de twitter, por lo que crear un cliente debería ser sencillo, solo configurar en el cliente las URI de donde toma o actualiza los datos.

         
XML
         Público (public_timeline): http://mexicodiario.com/touch.public.xml.php [XML]
         			   (no require autentificación)
         Amigos (friends_timeline): http://mexicodiario.com/touch.friends.xml.php [XML] 
         			   (require autentificación básica HTTP).         
         
JSON

         Público (public_timeline): http://mexicodiario.com/touch.public.json.php [JSON]
                     (no require autentificación)
         Amigos (friends_timeline): http://mexicodiario.com/touch.friends.json.php [JSON] 
                     (require autentificación básica HTTP).
         Archivo (user_timeline): http://mexicodiario.com/touch.archive.json.php [JSON] 
                     (require autentificación básica HTTP).
         Mensajes directos (direct_messages): http://mexicodiario.com/touch.direct.json.php [JSON] 
                     (require autentificación básica HTTP).

         Usuario (público) http://mexicodiario.com/touch.public.json.php?USUARIO

                     (no requiere autentificación pero si que se pase por GET el nombre de USUARIO)        

         

Respuesta a petición de XML (público y con amigos)

<?xml version="1.0" encoding="UTF-8"?>

<statuses>
 <status>
  <created_at>Wed Apr 25 08:48:08 +0500 2007</created_at>
  <id>8507</id>
  <text>buen dia a todos!, llegando al trabajo</text>

  <user>
    <id>67</id>
    <name>robman</name>
    <screen_name>robman</screen_name>

    <location>Aguascalientes, México.</location>
    <description>robman</description>
    <profile_image_url>http://mexicodiario.com/profile/2007/04/67_tiny.jpg</profile_image_url>
    <url></url>

    <protected>false</protected>
  </user>
 </status>
 <status>
    ...
 </status>

</statuses>

Respuesta a petición de JSON (público y con amigos)

  [created_at] => Sat Apr 24 16:58:04 +0500 2007
  [text] => test
  [id] => 8510
  [user] => stdClass Object
  (
     [name] => livin'
     [description] => livin' 
     [location] => Torreón, Coahuila, México
     [url] => http://www.ymipollo.com/~ToRo/
     [id] => 1
     [profile_image_url] => http://mexicodiario.com/profile/2007/02/1_tiny.jpg                    
     [screen_name] => ToRo
  )
         

Actualizar

Es muy sencillo, solo hay que apuntar al protocolo a utilizar: XML o JSON, las direcciones son:

         
XML
         http://mexicodiario.com/touch.xml.php [XML] 
         			   (require autentificación básica HTTP).         
         
JSON
         http://mexicodiario.com/touch.json.php [JSON] 
         			   (require autentificación básica HTTP).         

         

En los dos casos es necesario autentificarse con su NICK o CORREO registrado y el token generado. La variable a enviar es status por el método POST y regresa un resultado dependiendo de si se envía a XML o JSON.

Si enviamos con curl:

curl -u usuario:clave -d status="test desde API" http://mexicodiario.com/touch.xml.php

Nos responderá lo siguiente:

<?xml version="1.0" encoding="UTF-8"?>

<status>
  <created_at>Tue Apr 24 21:06:51 +0500 2007</created_at>
  <id>8357</id>
  <text>test desde API</text>

  <user>
    <id>1</id>
    <name>descripcion</name>
    <screen_name>USUARIO</screen_name>

    <location>LOCALIZACION.</location>
    <description>DESCRIPCION</description>
    <profile_image_url>IMAGEN</profile_image_url>
    <url>URL</url>

  </user>
</status>

En el caso de JSON es la estructura que se menciona arriba.

Última actualización: 2 de Mayo, 2007.