[aerogear-dev] UnifiedPush - REST endpoints

[Matthias Wessendorf]

On Tue, Jun 18, 2013 at 1:46 PM, Karel Piwko <kpiwko at redhat.com> wrote:

> On Wed, 12 Jun 2013 10:22:10 +0200
> Matthias Wessendorf <matzew at apache.org> wrote:
>
> > Hi,
> >
> > a little doc about the REST endpoints:
> > https://gist.github.com/matzew/73ec38d853863e7bb1dd
>
> Extremely helpful, thanks! I wish I'd found it before I was wondering why
> unified push server started returning 201 instead of 200.
>
> >
> > I _think_ it would be nice IF the above "REST APIs" are also describing
> the
> > "params" and HTTP headers that are required.
> >
> > These are currently (at least for sending) described in here:
> > http://staging.aerogear.org/docs/specs/aerogear-push-messages/
> >
> > What do you think?
> > Should we merge the "message format" spec with the "Sender REST-API"
> > endpoint documentation?
>
> Wouldn't they make a nice cookbook together if merged?
>

+1000

I am currently on some security work, but I plan to merge the "message
format + REST API"

I think in three different "chapters"
* REST Management APIs (for creating PushApplication / Variant) (+ crud
workflow -> basically all used by the (future) Admin UI)
* REST Auth Endpoint (Login/Logout and "enroll")
* REST Sender (for sending push messages)
* REST "Device Registration" (for the MobileVariantInstances (aka
Installations))

That ensure the doc is not too long.....




>
> >
> > Also, if we do the merge.... I'd update the above gist to include other
> > values/headers/params for the
> > MobileVariant/PushApplication/Installation(aka MobileVariantInstance) as
> > well
> >
> >  -Matthias
> >
>
> _______________________________________________
> aerogear-dev mailing list
> aerogear-dev at lists.jboss.org
> https://lists.jboss.org/mailman/listinfo/aerogear-dev
>



-- 
Matthias Wessendorf

blog: http://matthiaswessendorf.wordpress.com/
sessions: http://www.slideshare.net/mwessendorf
twitter: http://twitter.com/mwessendorf
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.jboss.org/pipermail/aerogear-dev/attachments/20130618/1f94b038/attachment.html