¡Únete!
Blasfemar, la primera red social para ateos, agnósticos y libre pensadores en español. Conéctate y comparte con tus amigos.

Desarrolladores

Como Desarrollador tu puedes crear Aplicaciones y agregarlas a Blasfemar, tomando ventaja de nuestra Base de Usuarios. Tu alojas la Aplicacion, lo cual significa que tienes control total de las especificaciones de tu Servidor

Configurando una Aplicacion

Para interactuar con Blasfemar tu Aplicacion puede realizar llamadas a nuestra API y solicitar o publicar informacion

Cuando tu agregues una Aplicacion a nuestro Sitio te daremos una APP ID

Solicitar un Token

Cuando planees usar nuestra API primero debers solicitar un Token. Para solicitar un Token necesitas una Clave unica que te enviamos cuando los Usuarios visiten tu Aplicacion desde un iframe es nuestro Sitio. Enviamos esto junto como $_GET['key']
Este es un ejemplo de como puede solicitar un Token:
http://blasfemar.com/token.php?key=$_GET['key']
Si es correcto, obtendras una respuesta tipo JSON:
Object
(
    [token] => LS0tLS1CRUdJTiBQVUJMSUMgS0VZLS0tLS0KTUc4d0RRWUpLb1pJaHZjTkFRRUJCUUFEWGdBd1d3SlVBdHFZdmVWOXFEdDd6NFhXTXYzS3VZM2JyWXpUKzR0VgpBbERrN1dQWjhqRVpoVzBNWjE1Z3lHdGNlNm5ueFRNenp4SXpHM29BRVIzc0JVRCtYdStHb21JeVV4UE1RN1NtCkVPdFg0ZTNwekp6R081cUxBZ01CQUFFPQotLS0tLUVORCBQVUJMSUMgS0VZLS0tLS0K
)

Enviando Solicitud

Ahora que ya tienes un Token valido puedes hacer solicitudes a nuestro Servidor. Con cada solicitud debes usar el Token que creamos para ti
Un ejemplo de como una peticion a nuestra Servidor API debe lucir:
http://blasfemar.com/api.php?token=#{TOKEN}&method=#{METHOD_NAME}

Comprendiendo una Respuesta del API

Para metodos que pueden retornar mas de una respuesta, la respuesta contendra un indicador del total de Articulos disponibles asi como cuantas Paginas son. Retornamos por default 10 Articulos a lo maximo y para conseguir los proximos 10 Articulos tienes que usar el parametro "page=2"

A la izquierda encontrarás una lista de los módulos que implementan metodos API. Presiona en el módulo y verás una lista de métodos que tu aplicación puede utilizar. Por propósitos de brevedad no incluimos la solicitud completa solo las partes más relevantes.

friend
getFriends
GET /api.php?method=friend.getFriends&user_id=#{USER_ID}
Obten una Lista completa de Amigos de un Usuario especifico. Si no pasas el #{USER_ID} devolveremos informacion acerca del Usuario que este actualmente conectado
Respuesta
Object
(
    [api] => Object
        (
            [total] => 1
            [pages] => 0
            [current_page] => 0
        )

    [output] => Array
        (
            [0] => Object
                (
                    [user_id] => 7
                    [user_name] => jane-doe
                    [full_name] => Jane Doe
                    [joined] => 1314110027
                    [country_iso] => US
                    [gender] => Female
                    [photo_50px] => http://blasfemar.com/file/pic/user/7_50.jpg
                    [photo_50px_square] => http://blasfemar.com/file/pic/user/7_50_square.jpg
                    [photo_120px] => http://blasfemar.com/file/pic/user/7_120.jpg
                    [photo_original] => http://blasfemar.com/file/pic/user/7.jpg
                    [profile_url] => http://blasfemar.com/index.php?do=/jane-doe/
                )

        )

)
isFriend
GET /api.php?method=friend.isFriend&user_id=#{USER_ID}&friend_user_id=#{FRIEND_USER_ID}
Verificar si 2 usuarios son amigos. Si no pasas el #{USER_ID} devolveremos información acerca del usuario que este actualmente conectado.
Respuesta
Object
(
    [api] => Object
        (
            [total] => 0
            [pages] => 0
            [current_page] => 0
        )

    [output] => Object
        (
            [is_friend] => 1
        )

)
mail
getNewCount
GET /api.php?method=mail.getNewCount&user_id=#{USER_ID}
Obten el numero total de Mensajes no vistos. Si no pasas el #{USER_ID} devolveremos informacion acerca del Usuario que este actualmente conectado
Respuesta
Object
(
    [api] => Object
        (
            [total] => 0
            [pages] => 0
            [current_page] => 0
        )

    [output] => 1
)
notification
getNewCount
GET /api.php?method=notification.getNewCount&user_id=#{USER_ID}
Obtén el número total de notificaciones. Si no pasas el #{USER_ID} devolveremos información acerca del Usuario que este actualmente conectado
Respuesta
Object
(
    [api] => Object
        (
            [total] => 5
            [pages] => 0
            [current_page] => 0
        )

    [output] => 5
)
get
GET /api.php?method=notification.get&user_id=#{USER_ID}
Obtén todas las notificaciones de usuario. Si no pasas el #{USER_ID} devolveremos información acerca del usuario que esté actualmente conectado
Respuesta
Object
(
    [api] => Object
        (
            [total] => 0
            [pages] => 0
            [current_page] => 0
        )

    [output] => Array
        (
            [0] => Object
                (
                    [notification_id] => 3
                    [link] => http://blasfemar.com/john-doe/comment-id_1/
                    [message] => Jane Doe commented on your wall
                    [icon] => http://blasfemar.com/module/blog/static/image/default/default/activity.png
                )

        )

)
photo
addPhoto
POST /api.php?method=photo.addPhoto&photo=#{@FILE_PATH;TYPE=MIME_TYPE}&photo_name=#{BASE_FILE_NAME}
Uploads a photo on behalf of the user.
Respuesta
Object
(
    [api] => Object
        (
            [total] => 0
            [pages] => 0
            [current_page] => 0
        )

    [output] => Object
        (
            [original] => http://blasfemar.com/file/pic/photo/2011/08/39740c5e356fdd6f66cfc973d4aebf6d.jpg
            [75px] => http://blasfemar.com/file/pic/photo/2011/08/39740c5e356fdd6f66cfc973d4aebf6d_75.jpg
            [100px] => http://blasfemar.com/file/pic/photo/2011/08/39740c5e356fdd6f66cfc973d4aebf6d_100.jpg
            [150px] => http://blasfemar.com/file/pic/photo/2011/08/39740c5e356fdd6f66cfc973d4aebf6d_150.jpg
            [240px] => http://blasfemar.com/file/pic/photo/2011/08/39740c5e356fdd6f66cfc973d4aebf6d_240.jpg
            [500px] => http://blasfemar.com/file/pic/photo/2011/08/39740c5e356fdd6f66cfc973d4aebf6d_500.jpg
            [1024px] => http://blasfemar.com/file/pic/photo/2011/08/39740c5e356fdd6f66cfc973d4aebf6d_1024.jpg
        )

)
getPhotos
GET /api.php?method=photo.getPhotos&user_id=#{USER_ID}
Obten todas las Fotos del Usuario. Si no pasas el #{USER_ID} devolveremos informacion acerca del Usuario que este actualmente conectado
Respuesta
Object
(
    [api] => Object
        (
            [total] => 1
            [pages] => 0
            [current_page] => 0
        )

    [output] => Array
        (
            [0] => Object
                (
                    [photo_100px] => http://blasfemar.com/file/pic/photo/c81e728d9d4c2f636f067f89cc14862c_100.jpg
                    [photo_240px] => http://blasfemar.com/file/pic/photo/c81e728d9d4c2f636f067f89cc14862c_240.jpg
                    [photo_original] => http://blasfemar.com/file/pic/photo/c81e728d9d4c2f636f067f89cc14862c.jpg
                )

        )

)
user
getUser
GET /api.php?method=user.getUser&user_id=#{USER_ID}
Obten informacion del Usuario basado en su ID#. Si no pasas el #{USER_ID} devolveremos informacion acerca del Usuario que este actualmente conectado
Respuesta
Object
(
    [api] => Object
        (
            [total] => 0
            [pages] => 0
            [current_page] => 0
        )

    [output] => Object
        (
            [user_id] => 1
            [user_name] => john-doe
            [joined] => 1314109907
            [gender] => Male
            [country_iso] => US
            [full_name] => John Doe
            [email] => john.doe@site.com
            [photo_50px] => http://blasfemar.com/file/pic/user/2011/08/9d673759d1cf55c9cd0b0805dc32e68e_50.jpg
            [photo_50px_square] => http://blasfemar.com/file/pic/user/2011/08/9d673759d1cf55c9cd0b0805dc32e68e_50_square.jpg
            [photo_120px] => http://blasfemar.com/file/pic/user/2011/08/9d673759d1cf55c9cd0b0805dc32e68e_120.jpg
            [photo_original] => http://blasfemar.com/file/pic/user/2011/08/9d673759d1cf55c9cd0b0805dc32e68e.jpg
            [profile_url] => http://blasfemar.com/index.php?do=/john-doe/
        )

)