<div dir="ltr"><br><div class="gmail_extra"><div class="gmail_quote">On Mon, Oct 21, 2013 at 7:06 PM, Paul Belanger <span dir="ltr"><<a href="mailto:paul.belanger@polybeacon.com" target="_blank">paul.belanger@polybeacon.com</a>></span> wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div class="im">On Mon, Oct 21, 2013 at 10:56 AM, David M. Lee <<a href="mailto:dlee@digium.com">dlee@digium.com</a>> wrote:<br>

><br>
> On Oct 21, 2013, at 8:09 AM, Alistair Cunningham <<a href="mailto:acunningham@integrics.com">acunningham@integrics.com</a>> wrote:<br>
><br>
>> When I now check this page:<br>
>><br>
>> <a href="https://wiki.asterisk.org/wiki/display/AST/Asterisk+12+REST+Data+Models" target="_blank">https://wiki.asterisk.org/wiki/display/AST/Asterisk+12+REST+Data+Models</a><br>
>><br>
>> I see no mention of Answer or Hangup. Have these already been removed, or am I looking on the wrong page?<br>
><br>
> That's the right page.<br>
><br>
>> I must confess that I'm not quite sure where to look on the Wiki for information about the websocket events. Is the "Data Models" page the same as the "Events" page? Matt showed me the correct place, but I foolishly failed to bookmark it. Apologies for the confusion…<br>

><br>
> No worries… it's new for everyone.<br>
><br>
> The "_ REST API" pages all of the basic structure. It leads off with a summary table, with HTTP method, URI path, return model (what you can expect as a response to the call) and a short summary of the operation.<br>

><br>
> The "Path" column links further down the page where you can find more details about the operation (longer description, operation parameters, etc.).<br>
><br>
> The "Return Model" column links into the "REST Data Models" page, where the return model schema is documented.<br>
><br>
> The /events WebSocket is a bit wonky, because it can return many different types of messages.<br>
><br>
> The way the model is structured, the 'Message' return model is actually a base-type for all of the events that could come over the /events WebSocket. If you click the 'Message' link, it will take you to the docs for that type, where all of the subtypes for Message are listed. That doc also tells you that the 'type' field in 'Message' is used as the discriminator, so you can tell what type of event you actually received.<br>

><br>
> While this all seems very clear to me, I'm the one who wrote it :-D<br>
><br>
> Suggestions for clarifying the wiki docs are gladly welcomed.<br>
><br>
</div>So, I guess the first question is do we want to keep the AMI / ARI<br>
naming of events is _somewhat_ similar?  AMI tends to be now,<br>
DTMFBegin and ARI the past, PlaybackStarted.<br>
<div class="im HOEnZb"><br></div></blockquote><div><br></div><div>I'm sorry I even mentioned the AMI... I'd much rather keep it past tense...</div><div> </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
<div class="im HOEnZb">
--<br>
Paul Belanger | PolyBeacon, Inc.<br>
Jabber: <a href="mailto:paul.belanger@polybeacon.com">paul.belanger@polybeacon.com</a> | IRC: pabelanger (Freenode)<br>
Github: <a href="https://github.com/pabelanger" target="_blank">https://github.com/pabelanger</a> | Twitter: <a href="https://twitter.com/pabelanger" target="_blank">https://twitter.com/pabelanger</a><br>
<br>
</div><div class="HOEnZb"><div class="h5">_______________________________________________<br>
asterisk-app-dev mailing list<br>
<a href="mailto:asterisk-app-dev@lists.digium.com">asterisk-app-dev@lists.digium.com</a><br>
<a href="http://lists.digium.com/cgi-bin/mailman/listinfo/asterisk-app-dev" target="_blank">http://lists.digium.com/cgi-bin/mailman/listinfo/asterisk-app-dev</a><br>
</div></div></blockquote></div><br></div></div>