Re: [weirds] vCard | Was: Re: Entity postal address information in draft-ietf-weirds-json-response-01

[Gavin Brown <[e-mail]>]

On 21/12/2012 14:13, Simon Perreault wrote:
> Please allow me to remind everyone that the IETF has a standard for such
> information: vCard. Let's use it and focus on WEIRDS, not on postal
> address formats.
> 
> And there is a draft about a JSON representation for vCard:
> http://tools.ietf.org/html/draft-bhat-vcarddav-json-00

Reusing an existing representation makes a lot of sense to me, as long as:

1. the profile is restricted to pretty much the same data as the current
spec supports.

2. both flat and structured address data is supported.

3. data which are common to all the object types (registration/update
times, sponsoring registrar, etc) have the same names across all objects.

4. the formatting of dates, telephone numbers, etc are the same across
all objects.

Otherwise, implementations are going to have to introduce special
object-specific handlers for the same data, which will be a pain.

Here's how I see an entity representation working, with a vCard
representation merged with the format in draft-ietf-weirds-json-response-01:

    {
        "handle" : "SH8013-REP",
        "fn" : "John Doe",
        "status" : [ "validated", "locked" ],
        "org" : { "text" : "Example Inc" },
        "adr" : {

            /* used by servers with flat address data */
            "label" : "123 Example Dr., Suite 100, Dulles, VA,
20166-6503, US",

            /* used by servers with structured address data */
            "street" : "123 Example Dr., Suite 100",
            "locality" : "Dulles",
            "region" : "VA",
            "code" : "20166-6503",
            "country" : "US"
        },
        "tel" : [
            {
                "type" : "voice",
                "uri" : "tel : [phone]x1234"
            },
            {
                "type" : "fax",
                "uri" : "tel : [phone]"
            }
        ],
        "email" : { "text" : "[e-mail]" },
        "remarks" : [
            "she sells seas shells",
            "down by the seashore"
        ],
        "links" : [
            {
                "value" : "http : //example.com/entity/XXXX",
                "rel" : "self",
                "href" : "http : //example.com/entity/XXXX"
            }
        ],
        "port43" : "whois.example.net",
        "registrationDate" : "1990-12-31T23 : 59 : 60Z",
        "registrationBy" : "ABC123",
        "lastChangedDate" : "1990-12-31T23 : 59 : 60Z",
        "lastChangedBy" : "ABC123",
        "sponsoredBy" : "SponsorXYZ",
        "resoldBy" : "ResellerPDQ"
    }

-- 
Gavin Brown
Chief Technology Officer
CentralNic Ltd
Innovative, Reliable and Flexible Registry Services
for ccTLD, gTLD and private domain name registries
https://www.centralnic.com/

CentralNic Ltd is a company registered in England and Wales with company
number 4985780. Registered Offices: 35-39 Moorgate, London, EC2R 6AR.