<div dir="ltr"><br><div class="gmail_extra"><br><br><div class="gmail_quote">On Tue, Jun 18, 2013 at 5:13 PM, Bruno Oliveira <span dir="ltr">&lt;<a href="mailto:bruno@abstractj.org" target="_blank">bruno@abstractj.org</a>&gt;</span> wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">What do you think about tag the current version and merge the security<br>
branch? Only if you want to we also can release the version 0.1.0 on<br>
maven central.<br></blockquote><div><br></div><div style>are u talking about the REST API doc (this thread)</div><div style>or the (real :-)) work I did for security branch ? </div><div> </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">

<br>
Just let me know.<br>
<div class="HOEnZb"><div class="h5"><br>
Karel Piwko wrote:<br>
&gt; On Tue, 18 Jun 2013 16:26:26 +0200<br>
&gt; Sebastien Blanc&lt;<a href="mailto:scm.blanc@gmail.com">scm.blanc@gmail.com</a>&gt;  wrote:<br>
&gt;<br>
&gt;&gt; +9006<br>
&gt;&gt; And we should check that the integrations tests are always in sync with the<br>
&gt;&gt; cookbook (use the same use cases / data) .<br>
&gt;<br>
&gt; Asciidoc provides a nice feature of including snippets of code from real<br>
&gt; files into documentation. Not sure if that would be possible with making groovy<br>
&gt; syntax for integration tests nicely fitting cookbook syntax, but might be worth<br>
&gt; investigating ;-)<br>
&gt;<br>
&gt;<br>
&gt;&gt; Seb<br>
&gt;&gt;<br>
&gt;&gt;<br>
&gt;&gt;<br>
&gt;&gt; On Tue, Jun 18, 2013 at 1:54 PM, Matthias Wessendorf&lt;<a href="mailto:matzew@apache.org">matzew@apache.org</a>&gt;wrote:<br>
&gt;&gt;<br>
&gt;&gt;&gt;<br>
&gt;&gt;&gt;<br>
&gt;&gt;&gt; On Tue, Jun 18, 2013 at 1:46 PM, Karel Piwko&lt;<a href="mailto:kpiwko@redhat.com">kpiwko@redhat.com</a>&gt;  wrote:<br>
&gt;&gt;&gt;<br>
&gt;&gt;&gt;&gt; On Wed, 12 Jun 2013 10:22:10 +0200<br>
&gt;&gt;&gt;&gt; Matthias Wessendorf&lt;<a href="mailto:matzew@apache.org">matzew@apache.org</a>&gt;  wrote:<br>
&gt;&gt;&gt;&gt;<br>
&gt;&gt;&gt;&gt;&gt; Hi,<br>
&gt;&gt;&gt;&gt;&gt;<br>
&gt;&gt;&gt;&gt;&gt; a little doc about the REST endpoints:<br>
&gt;&gt;&gt;&gt;&gt; <a href="https://gist.github.com/matzew/73ec38d853863e7bb1dd" target="_blank">https://gist.github.com/matzew/73ec38d853863e7bb1dd</a><br>
&gt;&gt;&gt;&gt; Extremely helpful, thanks! I wish I&#39;d found it before I was wondering why<br>
&gt;&gt;&gt;&gt; unified push server started returning 201 instead of 200.<br>
&gt;&gt;&gt;&gt;<br>
&gt;&gt;&gt;&gt;&gt; I _think_ it would be nice IF the above &quot;REST APIs&quot; are also describing<br>
&gt;&gt;&gt;&gt; the<br>
&gt;&gt;&gt;&gt;&gt; &quot;params&quot; and HTTP headers that are required.<br>
&gt;&gt;&gt;&gt;&gt;<br>
&gt;&gt;&gt;&gt;&gt; These are currently (at least for sending) described in here:<br>
&gt;&gt;&gt;&gt;&gt; <a href="http://staging.aerogear.org/docs/specs/aerogear-push-messages/" target="_blank">http://staging.aerogear.org/docs/specs/aerogear-push-messages/</a><br>
&gt;&gt;&gt;&gt;&gt;<br>
&gt;&gt;&gt;&gt;&gt; What do you think?<br>
&gt;&gt;&gt;&gt;&gt; Should we merge the &quot;message format&quot; spec with the &quot;Sender REST-API&quot;<br>
&gt;&gt;&gt;&gt;&gt; endpoint documentation?<br>
&gt;&gt;&gt;&gt; Wouldn&#39;t they make a nice cookbook together if merged?<br>
&gt;&gt;&gt;&gt;<br>
&gt;&gt;&gt; +1000<br>
&gt;&gt;&gt;<br>
&gt;&gt;&gt; I am currently on some security work, but I plan to merge the &quot;message<br>
&gt;&gt;&gt; format + REST API&quot;<br>
&gt;&gt;&gt;<br>
&gt;&gt;&gt; I think in three different &quot;chapters&quot;<br>
&gt;&gt;&gt; * REST Management APIs (for creating PushApplication / Variant) (+ crud<br>
&gt;&gt;&gt; workflow -&gt;  basically all used by the (future) Admin UI)<br>
&gt;&gt;&gt; * REST Auth Endpoint (Login/Logout and &quot;enroll&quot;)<br>
&gt;&gt;&gt; * REST Sender (for sending push messages)<br>
&gt;&gt;&gt; * REST &quot;Device Registration&quot; (for the MobileVariantInstances (aka<br>
&gt;&gt;&gt; Installations))<br>
&gt;&gt;&gt;<br>
&gt;&gt;&gt; That ensure the doc is not too long.....<br>
&gt;&gt;&gt;<br>
&gt;&gt;&gt;<br>
&gt;&gt;&gt;<br>
&gt;&gt;&gt;<br>
&gt;&gt;&gt;&gt;&gt; Also, if we do the merge.... I&#39;d update the above gist to include other<br>
&gt;&gt;&gt;&gt;&gt; values/headers/params for the<br>
&gt;&gt;&gt;&gt;&gt; MobileVariant/PushApplication/Installation(aka MobileVariantInstance) as<br>
&gt;&gt;&gt;&gt;&gt; well<br>
&gt;&gt;&gt;&gt;&gt;<br>
&gt;&gt;&gt;&gt;&gt;   -Matthias<br>
&gt;&gt;&gt;&gt;&gt;<br>
&gt;&gt;&gt;&gt; _______________________________________________<br>
&gt;&gt;&gt;&gt; aerogear-dev mailing list<br>
&gt;&gt;&gt;&gt; <a href="mailto:aerogear-dev@lists.jboss.org">aerogear-dev@lists.jboss.org</a><br>
&gt;&gt;&gt;&gt; <a href="https://lists.jboss.org/mailman/listinfo/aerogear-dev" target="_blank">https://lists.jboss.org/mailman/listinfo/aerogear-dev</a><br>
&gt;&gt;&gt;&gt;<br>
&gt;&gt;&gt;<br>
&gt;&gt;&gt;<br>
&gt;&gt;&gt; --<br>
&gt;&gt;&gt; Matthias Wessendorf<br>
&gt;&gt;&gt;<br>
&gt;&gt;&gt; blog: <a href="http://matthiaswessendorf.wordpress.com/" target="_blank">http://matthiaswessendorf.wordpress.com/</a><br>
&gt;&gt;&gt; sessions: <a href="http://www.slideshare.net/mwessendorf" target="_blank">http://www.slideshare.net/mwessendorf</a><br>
&gt;&gt;&gt; twitter: <a href="http://twitter.com/mwessendorf" target="_blank">http://twitter.com/mwessendorf</a><br>
&gt;&gt;&gt;<br>
&gt;&gt;&gt; _______________________________________________<br>
&gt;&gt;&gt; aerogear-dev mailing list<br>
&gt;&gt;&gt; <a href="mailto:aerogear-dev@lists.jboss.org">aerogear-dev@lists.jboss.org</a><br>
&gt;&gt;&gt; <a href="https://lists.jboss.org/mailman/listinfo/aerogear-dev" target="_blank">https://lists.jboss.org/mailman/listinfo/aerogear-dev</a><br>
&gt;&gt;&gt;<br>
&gt;<br>
&gt; _______________________________________________<br>
&gt; aerogear-dev mailing list<br>
&gt; <a href="mailto:aerogear-dev@lists.jboss.org">aerogear-dev@lists.jboss.org</a><br>
&gt; <a href="https://lists.jboss.org/mailman/listinfo/aerogear-dev" target="_blank">https://lists.jboss.org/mailman/listinfo/aerogear-dev</a><br>
<br>
</div></div><span class="HOEnZb"><font color="#888888">--<br>
abstractj<br>
</font></span><div class="HOEnZb"><div class="h5"><br>
_______________________________________________<br>
aerogear-dev mailing list<br>
<a href="mailto:aerogear-dev@lists.jboss.org">aerogear-dev@lists.jboss.org</a><br>
<a href="https://lists.jboss.org/mailman/listinfo/aerogear-dev" target="_blank">https://lists.jboss.org/mailman/listinfo/aerogear-dev</a><br>
</div></div></blockquote></div><br><br clear="all"><div><br></div>-- <br>Matthias Wessendorf <br><br>blog: <a href="http://matthiaswessendorf.wordpress.com/" target="_blank">http://matthiaswessendorf.wordpress.com/</a><br>
sessions: <a href="http://www.slideshare.net/mwessendorf" target="_blank">http://www.slideshare.net/mwessendorf</a><br>twitter: <a href="http://twitter.com/mwessendorf" target="_blank">http://twitter.com/mwessendorf</a>
</div></div>