API de XML-RPC
Connecting
Autenticação
Erros
Métodos
Ponto Final API: https://secure.gravatar.com/xmlrpc?user=[email_hash]
É obrigatório que você se conecte a secure.gravatar.com através de HTTPS para a segurança dos nossos usuários. O parâmetro GET email_hash é o hash md5 do endereço de email dos usuários depois de transformados em minúsculas e reduzidos.
Todos os parâmetros de todos os métodos devem ser passado como um único item, dentro de uma matriz associativa.
É obrigatório que você se conecte a secure.gravatar.com através de HTTPS para a segurança dos nossos usuários. O parâmetro GET email_hash é o hash md5 do endereço de email dos usuários depois de transformados em minúsculas e reduzidos.
Todos os parâmetros de todos os métodos devem ser passado como um único item, dentro de uma matriz associativa.
Autenticação
A autenticação do usuário acontece no nível de método da API. Você vai passar para a chamada de método um parâmetro de senha. Os dados para esses parâmetros serão passados em texto simples. O parâmetro de senha é sempre retirado dos argumentos antes dos métodos começarem seu processamento. Por esta razão, você deve esperar para não vê-lo retornado de grav.test method.
Erros
Erros geralmente vêm com um número e texto legível. Geralmente, o texto deve ser seguido sempre que possível, mas uma breve descrição dos códigos de erro numéricos são as seguintes:
-7 Use secure.gravatar.com -8 Erro interno -9 Erro de autenticação -10 Método de parâmetro em falta -11 Método de parâmetro incorreto -100 Misc erro (ver texto)
Métodos
grav.exists - checar se há um erro com um gravatar @param (array)$args['hashes'] um vetor de hashes para verificar @param (string)$args['password'] para autenticação @return array ( hash => (bool)exists, ) grav.addresses - obtenha uma lista de endereços para esta conta @param (string)$args['password'] para autenticação @return array ( address => array ( rating => (int)rating, userimage => (int)userimage, userimage_url => (int)userimage_url ) ) grav.userimages - retorna um vetor de imagens de usuário para esta conta @param (string)$args['password'] para autenticação @return array ( userimage => array( (int)rating, // 0:g, 1:pg, 2:r, 3:x (string)url, ) ) grav.saveData - Salvar dados binários da imagem como uma userimage para esta conta @param (string)$args['data'] a base64_encode()d image @param (int)$args['rating'] 0:g, 1:pg, 2:r, 3:x @param (string)$args['password'] para autenticação @return (bool)false em caso de falha, (string)userimage em caso de sucesso grav.saveUrl - Ler uma imagem através da sua URL e salvar como userimage para esta conta @param (string)$args['url'] uma url completa para uma imagem @param (int)$args['rating'] 0:g, 1:pg, 2:r, 3:x @param (string)$args['password'] para autenticação @return (bool)false em caso de falha, (string)userimage em caso de sucesso grav.useUserimage - usar uma imagem como um gravatar para mais um dos endereços nesta conta @param (string)$args['userimage'] A imagem que você deseja usar @param (array)$args['addresses'] A lista de endereços de email que você deseja usar para esta imagem @param (string)$args['password'] para autenticação @return array( address => (bool)status ) grav.removeImage - remover a imagem associada à um ou mais endereços de e-mail @param (array)$args['addresses'] A lista de endereços de email que você deseja usar para esta imagem @param (string)$args['password'] para autenticação @return array( address => (bool)status ) grav.deleteUserimage - remover uma imagem da conta e de todos os endereços de email com o qual está associado @param (string)$args['userimage'] A imagem que você deseja remover da conta @param (string)$args['password'] para autenticação @return (bool)status grav.test - a test function @param (string)$args['password'] para autenticação @return (mixed)$args