Fwd: New Version Notification for draft-snell-activitystreams-actions-00.txt

[James M Snell]

Hello all,

First of all, I apologize for any of you who receive this note twice,
I'm cross posting to both the Activity Streams and OpenSocial mailing
lists.

Matt Marum and I have written up an initial draft of "Action Handlers
for Activity Streams 2.0" [1]. This is intended to fill in many of the
open details left open by the current Activity Streams 2.0 draft [2].

[1] http://www.ietf.org/id/draft-snell-activitystreams-actions-00.txt
[2] http://tools.ietf.org/html/draft-snell-activitystreams-05

There is still lots to do here but we wanted to get this initial set
of thoughts published and out and solicit feedback from the community
at large. The draft is still very rough and I'll be adding detail in
future iterations. Please post any feedback you may have to the
Activity Streams mailing list (see http://activitystrea.ms).

Thanks all!

- James

---------- Forwarded message ----------
From: <interne...@ietf.org>
Date: Thu, Dec 12, 2013 at 2:22 PM
Subject: New Version Notification for draft-snell-activitystreams-actions-00.txt
To: Matthew Marum <mgm...@gmail.com>, "James M. Snell" <jas...@gmail.com>



A new version of I-D, draft-snell-activitystreams-actions-00.txt
has been successfully submitted by James M Snell and posted to the
IETF repository.

Filename: draft-snell-activitystreams-actions
Revision: 00
Title: JSON Activity Streams 2.0 - Action Handlers
Creation date: 2013-12-12
Group: Individual Submission
Number of pages: 15
URL:
http://www.ietf.org/internet-drafts/draft-snell-activitystreams-actions-00.txt
Status:
http://datatracker.ietf.org/doc/draft-snell-activitystreams-actions
Htmlized:
http://tools.ietf.org/html/draft-snell-activitystreams-actions-00


Abstract:
This specification defines Action Handlers for use with the Activity
Streams 2.0 format.




Please note that it may take a couple of minutes from the time of submission
until the htmlized version and diff are available at tools.ietf.org.

The IETF Secretariat

[James M Snell]

Hey Pat,

I saw your previous note but I have to apologize, I've been tied up
catching back up after taking vacation for a few weeks... some
responses inline below...

On Wed, Jan 8, 2014 at 12:16 PM, cappelaere <cappe...@gmail.com> wrote:
> James, Matt,
>
> Actions are of high interest for us at NASA.
> The proposed spec is very interesting. I have a few questions regarding the
> POST action.
> It is well defined for a GET (with template).
> But for a POST, it seems under-defined. We need to know what security
> protocol may be required...

You're right.. the "under-defined" is actually intentional until we
(as a community) have a much better idea of what the overall
requirements will be...

> Post parameters may be required or optional
> Parameters may show up in the url path (as defined in the template), in the
> query section or at some location in the body.

Just to make sure, did you see the HtmlForm and Parameters objects
defined in the AS Actions draft? [1] and [2]

[1] http://tools.ietf.org/html/draft-snell-activitystreams-actions-02#section-7
[2] http://tools.ietf.org/html/draft-snell-activitystreams-actions-02#section-9

You can use a UrlTemplate and HtmlForm together if necessary, and the
Parameters object has a "required" property.

What's not clearly defined yet, however, are non-HTML form inputs.
That'll be something we need to look at eventually.

> The Google API discovery API defines that very well.
> Could it be possible to enhance “actions” and be compatible with that
> current implementation or are you thinking about doing something else?

We intentionally designed actions to be very openly extensible. It
would be very possible to bring the Google API discovery approach
together with this. Technically, it just a matter of embedding the
json into the action handler. I definitely encourage experimentation
in this area and would gladly help where I can.

- James

> Many thanks,
> Pat,

> --
> You received this message because you are subscribed to the Google Groups
> "Activity Streams" group.
> To unsubscribe from this group and stop receiving emails from it, send an
> email to activity-strea...@googlegroups.com.
> To post to this group, send email to activity...@googlegroups.com.
> Visit this group at http://groups.google.com/group/activity-streams.
> For more options, visit https://groups.google.com/groups/opt_out.