Re: [aerogear-dev] UnifiedPush - REST endpoints
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
Attachments:
- attachment.html (text/html — 3.4 KB)