Functions - services
From The Socknet
services provides a list of services that the user has registered so that they can be contacted directly by related services.
Specification
POST services
{ from: { serviceid: "http://photoprint.com/agents" },
protocol: "http://photostandards.com/photoxchange",
return: "http://photoprint.com/thing-i-am-doing"
}
->
{ services: [ { serviceid: "http://big-photos.com/agents",
protocols: { "http://photostandards.com/photoxchange":
{ public_data: ... anything at all ...
}
}
}
]
}
services may be called via GET or POST.
The request should include a protocol field holding a string.
The request may include a return field if the user is available to redirect.
The response includes a services field holding an array of service objects. Each service object has a serviceid field and a protocols field, which holds an object which has keys equal to protocol names holding objects having public_data fields.
public_data may be any data. It is set during register_service.
Support
Providers must support this function.
Services have no use for this function.
