Functions - unnotify message

From The Socknet

Jump to: navigation, search

unnotify_message is used to inform previous recipients of a notify_message call that the sender no longer endorses the message. This is sometimes necessary when a user has setup some automation that he later regrets. If the sender was the creator of the message and it is now deleted, a notify_message with a deleted field should be sent instead.

It is not required to support or react to this function. It is suggested, because this is commonly used when a user thinks a message is inaccurate or that his friends won't care about it. So it generally identifies messages that users wouldn't care to see anyway.

Specification

POST unnotify_message
{ 
  from: { openid: "http://openid.com/user1/" },
  guid: {
  	openid: "http://some-other-openid.com/",
  	id: "34"
  }
}

The unnotify_message function must be called via POST.

It requires a from field.

It requires a guid field.

No response is necessary.

Support

This function is in a proposal stage.

This function will be optional but suggested for Providers and Services.

Further Reading

Personal tools