XML-RPC API
Connecting
인증
오류
메소드
API 종료점: https://secure.gravatar.com/xmlrpc?user=[email_hash]
secure.gravatar.com에 연결하는 것과 HTTPS를 통해서 하는 것이 필수입니다. 이것은 여러 사용자의 안전을 위한 것입니다. email_hash GET 매개변수는 사용자 이메일이 소문자로 변경되고 공백을 제거한 후의 md5 hash입니다.
모든 매써드에 대한 모든 패러미터는 하나의 아이템으로 연상 배열 안에서 패스돼야 합니다.
secure.gravatar.com에 연결하는 것과 HTTPS를 통해서 하는 것이 필수입니다. 이것은 여러 사용자의 안전을 위한 것입니다. email_hash GET 매개변수는 사용자 이메일이 소문자로 변경되고 공백을 제거한 후의 md5 hash입니다.
모든 매써드에 대한 모든 패러미터는 하나의 아이템으로 연상 배열 안에서 패스돼야 합니다.
인증
사용자 인증은 api 메소드 레벨에서 발생합니다. 당신은 비밀번호 매개변수를 메소드 콜에 패스할 것입니다. 이들 매개변수에 대한 데이터는 일반 텍스트로 패스될 것입니다. 비밀번호 매개변수는 메소드가 프로세스를 시작하기 전에 인수로부터 나옵니다. 이런 이유로 grav.test 메소드로부터 복귀되는 것을 볼수 없다는 것을 예상해야합니다.
오류
에러는 보통 숫자와 사람이 읽을 수 있는 텍스트로 나타납니다. 일반적으로 가능한 경우 텍스트가 나타나지만 숫자 에러의 간단한 설명은 다음과 같습니다:
-7 secure.gravatar.com을 사용 -8 내부 오류 -9 인증 오류 -10 메소드 매게 변수가 누락되었습니다 -11 메소드 매개 변수가 정확하지 않습니다 -100 기타 오류 (텍스트 참조)
메소드
grav.exists - 해쉬가 gravatar를 가지고 있는지 확인합니다. @param (array)$args['hashes'] 확인할 해시들을 담아둔 배열(array) @param (string)$args['password'] 인증용 @return array ( hash => (bool)exists, ) grav.addresses - 이 계정의 주소 목록 얻기 @param (string)$args['password'] 인증용 @return array ( address => array ( rating => (int)rating, userimage => (int)userimage, userimage_url => (int)userimage_url ) ) grav.userimages - 이 계정을 위해 사용자이미지를 정렬합니다 @param (string)$args['password'] 인증용 @return array ( userimage => array( (int)rating, // 0:g, 1:pg, 2:r, 3:x (string)url, ) ) grav.saveData - 2진수 이미지 데이터를 이 계정의 사용자 이미지로 저장하기 @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'] 인증용 @return (bool)false 실패시, (string)userimage 성공시 grav.saveUrl - URL에 있는 그림을 읽어온 뒤에 이 계정에 사용할 사용자 이미지로 저장합니다. @param (string)$args['url'] 이미지 전체 URL @param (int)$args['rating'] 0:g, 1:pg, 2:r, 3:x @param (string)$args['password'] 인증용 @return (bool)false 실패시, (string)userimage 성공시 grav.useUserimage - 이 계정에 있는 하나 혹은 그 이상의 주소에 이 이미지를 사용합니다. @param (string)$args['userimage'] 사용하기를 원하는 사용자 이미지 @param (array)$args['addresses'] 이 사용자 이미지를 사용하고 싶은 이메일 주소 목록 @param (string)$args['password'] 인증용 @return array( address => (bool)status ) grav.removeImage - 1개 혹은 그 이상의 이메일 주소와 연결된 사용자 이미지 삭제 @param (array)$args['addresses'] 이 사용자 이미지를 사용하고 싶은 이메일 주소 목록 @param (string)$args['password'] 인증용 @return array( address => (bool)status ) grav.deleteUserimage - 계정에서 사용자 이미지와 그것과 연관된 모든 이메일 주소를 삭제합니다 @param (string)$args['userimage'] 이 계정에서 삭제하기를 원하는 사용자 이미지 @param (string)$args['password'] 인증용 @return (bool)status grav.test - a test function @param (string)$args['password'] 인증용 @return (mixed)$args