Functions - friend request
From The Socknet
friend_request is used to request a friendship connection from the recipient. It is also used to accept a friendship request.
Specification
POST friend_request
{ from: { openid: "http://requesting_user.com" },
message_guid: { openid: "http://requesting_user.com/",
id: "3523352"
},
vouchers: [ { openid: "http://a_friend_that_both_users_have_in_common.com/" } ]
}
->
{ accepted: boolean
}
friend_request must be called via POST.
The request must include a from field.
The request may include a message_guid field which contains a GUID object describing a message which the requester would like to be shown with the request.
The request may include a vouchers field which contains an array of objects describing mutual friends in common with the user.
The request may include a replace field which is used to indicate that the new friend is actually an old friend who lost his OpenID. This may also be a trick, so must be used cautiously.
The request may include a return field.
The response is either an accept, a pending, or a redirect.
Support
Providers must support this function.
Services have no use for this function.
