Re: [Tools-discuss] RESTful API style guide

Tom Pusateri <pusateri@bangj.com> Tue, 18 June 2013 15:22 UTC

Return-Path: <pusateri@bangj.com>
X-Original-To: tools-discuss@ietfa.amsl.com
Delivered-To: tools-discuss@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 7725F21F9B92 for <tools-discuss@ietfa.amsl.com>; Tue, 18 Jun 2013 08:22:29 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -0.339
X-Spam-Level:
X-Spam-Status: No, score=-0.339 tagged_above=-999 required=5 tests=[BAYES_00=-2.599, HELO_MISMATCH_COM=0.553, HOST_MISMATCH_NET=0.311, MIME_QP_LONG_LINE=1.396]
Received: from mail.ietf.org ([12.22.58.30]) by localhost (ietfa.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id fTxoR7I5V0Xh for <tools-discuss@ietfa.amsl.com>; Tue, 18 Jun 2013 08:22:21 -0700 (PDT)
Received: from oj.bangj.com (amt0.gin.ntt.net [129.250.11.170]) by ietfa.amsl.com (Postfix) with ESMTP id 19A1F21F9B8E for <tools-discuss@ietf.org>; Tue, 18 Jun 2013 08:22:16 -0700 (PDT)
Received: from [10.60.9.86] (mobile-166-147-081-171.mycingular.net [166.147.81.171]) (using TLSv1 with cipher AES128-SHA (128/128 bits)) (No client certificate requested) by oj.bangj.com (Postfix) with ESMTPSA id 294421D7B; Tue, 18 Jun 2013 11:19:58 -0400 (EDT)
References: <21266.1371520672@sandelman.ca> <CANb2OvJS5dpZ4HZ6T=i3-9Mj1Zn0f9LzH7Qhj2hffzoxKSc5PQ@mail.gmail.com>
Mime-Version: 1.0 (1.0)
In-Reply-To: <CANb2OvJS5dpZ4HZ6T=i3-9Mj1Zn0f9LzH7Qhj2hffzoxKSc5PQ@mail.gmail.com>
Content-Type: text/plain; charset="us-ascii"
Content-Transfer-Encoding: quoted-printable
Message-Id: <E0CDAB4E-A9D2-4174-B54F-DD5E08CCF0A7@bangj.com>
X-Mailer: iPad Mail (10B329)
From: Tom Pusateri <pusateri@bangj.com>
Date: Tue, 18 Jun 2013 08:22:10 -0700
To: Ole Laursen <olau@iola.dk>
Cc: Tools Team Discussion <tools-discuss@ietf.org>
Subject: Re: [Tools-discuss] RESTful API style guide
X-BeenThere: tools-discuss@ietf.org
X-Mailman-Version: 2.1.12
Precedence: list
List-Id: IETF Tools Discussion <tools-discuss.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/tools-discuss>, <mailto:tools-discuss-request@ietf.org?subject=unsubscribe>
List-Archive: <http://www.ietf.org/mail-archive/web/tools-discuss>
List-Post: <mailto:tools-discuss@ietf.org>
List-Help: <mailto:tools-discuss-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/tools-discuss>, <mailto:tools-discuss-request@ietf.org?subject=subscribe>
X-List-Received-Date: Tue, 18 Jun 2013 15:22:30 -0000

On Jun 18, 2013, at 6:08 AM, Ole Laursen <olau@iola.dk> wrote:

> 2013/6/18 Michael Richardson <mcr+ietf@sandelman.ca>:
>> This is just *TOO SLOW*.  Too many small requests.  (I assume the browser has
>> a 1.1-persistent session open, but I haven't checked actually).
>> I'd like to replace it with:
>>    GET /groups.json
>> returning an array of groups.  Does this make sense, architecturally?
> 
> IMHO, you've got this question backwards - it doesn't make sense
> architecturally to access each individually. :)
> 

Maybe not for a web page that shows the whole agenda but there are mobile cases where it might make sense. It also might make sense to query all groups by date. But groups are not the only items on the agenda. There are lots of special sessions that are not groups. Querying these by the uuid in the iCal file would be helpful. I've been looking for a way to get the descriptions of the special sessions but apparently, they are only available from the database.

Thanks,
Tom