There's a new kind of "ping" implemented in this version of Radio3.
Instead of sending the address of the user's RSS feed to the receiver, we send the full contents of the post, encoded in JSON.
This makes a richer kind of connection possible, we expect.
Consider this an experimental feature. It's not frozen, it can change. Breakage could very easily happen. And it's conceivable the feature could be withdrawn.
Right now this is just for developers who can operate server applications.
When the user saves a new post, or edits an existing post, we send the update message.
Choose Settings in the system menu (at the right edge of the menu bar).
Go to the Advanced panel.
Enter the URL of your receiver app in the second spot.
Here's a screen shot.
I've put up a simple handler at the address in the screen shot. It echoes the JSON struct it receives. No guarantees this will remain up for any period of time.
If you want to watch it operate, open the debugging console in the browser. Radio3 shows you the struct it's sending before the send, and the struct it received back. At this time it does nothing with the returned value, but maybe we should use it.
Also: Getting started with Radio3.
Here's an example of the JSON that's sent when a post is updated.
A new post will have a ctSends value of 0. It's a serial number, so it increments with each post.
You can use the twitterScreenName field to identify the user.
The when field is when the post was created.
text is the contents of the big edit box. It's used in the description element of the RSS item that represents the post.
idTweet is only present if the item has been posted to Twitter. You can turn off posting to Twitter through the Platforms panel in the Radio3 settings dialog, even though you must be signed in to Twitter to use Radio3. So you can't depend on idTweet being there.
guid is the value of the guid sub-element of item in the user's RSS feed.
I'm pretty sure the meaning of the other fields is self-evident. If there are questions, please post a comment below.
The combination of twitterScreenName and when uniquely identifies a post.