Documentação do API do GoZub.
Abaixo são apresentadas as instruções de como usar a API do Gozub. Esperamos que com nossa API você possa criar várias aplicações baseadas no Gozub. Caso você desenvolva alguma aplicação, nos avise através do formulário CONTATE-NOS a fim de que possamos divulgá-lo em nossa comunidade de usuários.
É importante lembrar que você deve utilizar sua “API Key” (sua chave) com cada URL, como é mostrado abaixo. Todo usuário, ao se registrar, recebe sua “API Key” que pode ser encontrada em “Configurações”.
Métodos de Mensagem
Pública
Retorna as últimas 20 mensagens públicas no formato desejado
URL: http://www.gozub.com/api/messages/public.[format].[api_key]
Formatos: xml, json, rss
Seguidos
Retorna todas as mensagens públicas daquelas pessoas que você segue especificadas no
formato desejado.
URL: http://www.gozub.com/api/messages/friends/[user].[format].[api_key]
Formatos: xml, json, rss
Usuário
Retorna todas as mensagens públicas de um usuário em específico no formato desejado.
URL: http://www.gozub.com/api/messages/user/[user].[format].[api_key]
Formatos: xml, json, rss
Últimos
Retorna as últimas mensagens públicas de um usuário em específico no formato desejado.
URL: http://www.gozub.com/api/messages/latest/[user].[format].[api_key]
Formatos: xml, json, rss
Enviar
Publica uma mensagem pública. Retorna os detalhes da mensagem ou uma mensagem de erro no formato desejado.
URL: http://www.gozub.com/api/messages/send.[format].[api_key]
Método: POST
Parâmetros requeridos:
*
username
(autenticação do “username” ou de seu ID)
*
password
(autenticação da senha do usuário)
*
message
(o conteúdo da mensagem)
Formatos: xml, json
Apagar
Apaga a mensagem do usuário autenticado. Retorna os detalhes da mensagem ou uma mensagem de erro no formato desejado.
URL:http://www.gozub.com/api/messages/delete.[format].[api_key]
Método: POST
Parâmetros requeridos:
*
username
(autenticação do “username” ou de seu ID)
*
password
(autenticação da senha do usuário)
*
message_id
(ID da mensagem apagada)
Formatos: xml, json
Métodos de Mensagens Diretas
Mensagens
Retorna todas as Mensagens Diretas para o usuário autenticado no formato desejado.
URL: http://www.gozub.com/api/direct_messages/messages.[format].[api_key]
Método: POST
Parâmetros requeridos:
*
username
(“username”do usuário autenticado)
*
password
(senha do usuário autenticado)
Formatos: xml, json
Enviar
Envia uma Mensagem Direta do usuário autenticado para outro usuário especificado pelo seu ID ou “username”. Retorna a Mensagem Enviada no formato desejado ou uma mensagem de erro no caso de um erro.
URL: http://www.gozub.com/api/direct_messages/send.[format].[api_key]
Método: POST
Parâmetros requeridos:
*
username
(“username” do usuário autenticado)
*
password
(senha do usuário autenticado)
*
message
(“username” ou ID que quem receberá a mensagem)
Parâmetros Opcionais:
*
reply
(ID de uma mensagem que originou a mensagem enviada como resposta a ela)
*
direct
(recipient user name or id)
Formatos: xml, json
Apagar
Remove uma Mensagem Direta especificada pelo seu ID caso tenha sido enviada para o usuário autenticado. Retorna os dados da mensagem no formato desejado ou uma mensagem de erro no caso de um erro.
URL: http://www.gozub.com/api/direct_messages/delete.[format].[api_key]
Método: POST
Parâmetros requeridos:
*
username
(“username” do usuário autenticado)
*
password
(senha do usuário autenticado)
*
message_id
(ID da mensagem)
Formatos: xml, json
Métodos do Usuário
Seguidos
Retorna pessoas em específico que são seguidas pelo usuário no formato desejado.
* URL:http://www.gozub.com/api/users/friends/[user].[format].[api_key]
* Formatos: xml, json
* Exemplos de uso:
http://www.gozub.com/api/users/friends/johnny.xml
ou
http://www.gozub.com/api/users/friends/12345.json
Seguidores
Retorna Seguidores em específico do usuário no formato desejado.
URL: http://www.gozub.com/api/users/followers/[user].[format].[api_key]
Formatos: xml, json
Exemplos de uso:
http://www.gozub.com/api/users/followers/diana.json
ou
http://www.gozub.com/api/users/followers/584.xml
Detalhes
Retorna detalhes de um usuário em específico no formato desejado.
URL: http://www.gozub.com/api/users/details/[user].[format].[api_key]
Formatos: xml, json
Exemplos de uso:
http://www.gozub.com/api/users/details/diana.json.f9cv8d97c90d8c6f2cab37bb6d1f1335
ou
http://www.gozub.com/api/users/details/584.xml.f9f16d97c90d8c6f23sb37bb6d1f1992
Métodos de Amizade
Criar
Torna um usuário em específico seguido pelo usuário autenticado. Retorna os dados do usuário seguido no formato desejado ou uma mensagem de erro no caso de um erro.
Método: POST
Parâmetros requeridos:
*
username
(“username” ou ID do usuário autenticado),
*
password
(senha do usuário autenticado),
*
friend
(“username” ou ID do seguido)
URL: http://www.gozub.com/api/friendships/create.[format].[api_key]
Formatos: xml, json
Não seguir mais usuário
O usuário autenticado deixa de seguir um de seus amigos. Retorna os dados do antigo usuário seguido no formato desejado ou uma mensagem de erro no caso de um erro.
Método: POST
Parâmetros requeridos:
*
username
(“username” ou ID do usuário autenticado),
*
password
(senha do usuário autenticado),
*
friend
(“username” ou ID do seguido)
URL: http://www.gozub.com/api/friendships/destroy.[format].[api_key]
Formatos: xml, json
Sobre Nós | Contate-nos | API | Ajuda | Termos de Uso | Política de Privacidade
Copyright © 2008 - GoZub.com - A Ventura,Intelligence & BlogTV Inc.Company.
Copyright © 2008 - GoZub.com - A Ventura,Intelligence & BlogTV Inc.Company.
Buscar amigos
Login