Re: [aerogear-dev] UnifiedPush - REST endpoints

On Tue, 18 Jun 2013 16:26:26 +0200 Sebastien Blanc<scm.blanc(a)gmail.com> wrote: > +9006 > And we should check that the integrations tests are always in sync with the > cookbook (use the same use cases / data) . Asciidoc provides a nice feature of including snippets of code from real files into documentation. Not sure if that would be possible with making groovy syntax for integration tests nicely fitting cookbook syntax, but might be worth investigating ;-) > Seb > > > > On Tue, Jun 18, 2013 at 1:54 PM, Matthias Wessendorf<matzew(a)apache.org>wrote: > >> >> >> On Tue, Jun 18, 2013 at 1:46 PM, Karel Piwko<kpiwko(a)redhat.com> wrote: >> >>> On Wed, 12 Jun 2013 10:22:10 +0200 >>> Matthias Wessendorf<matzew(a)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(a)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 >> >> _______________________________________________ >> aerogear-dev mailing list >> aerogear-dev(a)lists.jboss.org >> https://lists.jboss.org/mailman/listinfo/aerogear-dev >> _______________________________________________ aerogear-dev mailing list aerogear-dev(a)lists.jboss.org https://lists.jboss.org/mailman/listinfo/aerogear-dev