Unete
Business Catalogs te ayuda a Conectar y Compartir con Personas en tu Vida

Desarrolladores

Como Desarrollador tu puedes crear Aplicaciones y agregarlas a Business Catalogs, 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 Business Catalogs 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:
https://catalogs.business/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:
https://catalogs.business/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 encontraras una lista de los Modulos que implementan metodos API. Presiona en el Modulo y tu veras una lista de metodos que tu Aplicacion puede utilizar. Por propositos de brevedad no incluimos la Solicitud completa solo las partes mas relevantes

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}
Obten el numero total de Notificaciones. Si no pasas el #{USER_ID} devolveremos informacion 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}
Obten todas las Notificaciones de Usuario. 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] => Array
        (
            [0] => Object
                (
                    [notification_id] => 3
                    [link] => http://catalogs.business/john-doe/comment-id_1/
                    [message] => Jane Doe commented on your wall
                    [icon] => http://catalogs.business/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://catalogs.business/file/pic/photo/2011/08/39740c5e356fdd6f66cfc973d4aebf6d.jpg
            [75px] => http://catalogs.business/file/pic/photo/2011/08/39740c5e356fdd6f66cfc973d4aebf6d_75.jpg
            [100px] => http://catalogs.business/file/pic/photo/2011/08/39740c5e356fdd6f66cfc973d4aebf6d_100.jpg
            [150px] => http://catalogs.business/file/pic/photo/2011/08/39740c5e356fdd6f66cfc973d4aebf6d_150.jpg
            [240px] => http://catalogs.business/file/pic/photo/2011/08/39740c5e356fdd6f66cfc973d4aebf6d_240.jpg
            [500px] => http://catalogs.business/file/pic/photo/2011/08/39740c5e356fdd6f66cfc973d4aebf6d_500.jpg
            [1024px] => http://catalogs.business/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://catalogs.business/file/pic/photo/c81e728d9d4c2f636f067f89cc14862c_100.jpg
                    [photo_240px] => http://catalogs.business/file/pic/photo/c81e728d9d4c2f636f067f89cc14862c_240.jpg
                    [photo_original] => http://catalogs.business/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://catalogs.business/file/pic/user/2011/08/9d673759d1cf55c9cd0b0805dc32e68e_50.jpg
            [photo_50px_square] => http://catalogs.business/file/pic/user/2011/08/9d673759d1cf55c9cd0b0805dc32e68e_50_square.jpg
            [photo_120px] => http://catalogs.business/file/pic/user/2011/08/9d673759d1cf55c9cd0b0805dc32e68e_120.jpg
            [photo_original] => http://catalogs.business/file/pic/user/2011/08/9d673759d1cf55c9cd0b0805dc32e68e.jpg
            [profile_url] => http://catalogs.business/index.php?do=/john-doe/
        )

)