イベントを新規追加します。
追加するイベント本体は、HTTPリクエストのボディに以下のContent-Typeとともに指定します。
text/xml
XML形式でイベントを指定します。イベントとして完結させるためには最低summaryとstartdateが必要になります。
event要素を複数指定すると、一度に複数のイベントを追加することができます。
<?xml version="1.0" encoding="utf-8"?>
<root>
<event>
<summary>｛イベント名｝</summary>
<startdate>｛開始日時：YYYY-MM-DD HH:MM:SS｝</startdate>
<enddate>｛終了日時：YYYY-MM-DD HH:MM:SS｝</enddate>
<allday>｛終日イベントか:trueまたはfalse｝</allday>
<personal>｛私的イベントか:trueまたはfalse｝</personal>
<description>｛イベントの説明｝</description>
<url>｛ホームページのアドレス｝</url>
<location>｛場所の説明｝</location>
<image type="{イメージのMIMEタイプ：image/pngなど}">
｛イメージをBASE64でエンコードした内容｝</image>
<venue>
<name>｛場所の名前｝</name>
<address>｛場所の住所｝</address>
<zipcode>｛場所の郵便番号｝</zipcode>
<url>｛場所のホームページのアドレス｝</url>
<district>｛場所の都道府県｝</district>
<region>｛場所の地域｝</region>
<country>｛場所の国｝</country>
<latitude>｛場所の緯度｝</latitude>
<longitude>｛場所の経度｝</longitude>
</venue>
<tags>
<tag>｛タグ｝</tag>
...
</tags>
<otags>
<otag>｛オーナータグ｝</otag>
...
</otags>
</event>
</root>
application/x-www-form-urlencoded,multipart/form-data
FORM形式でイベントを指定します。XMLと同様にイベントとして完結させるために最低summaryとstartdateは指定する必要があります。
apid/methodパラメータの他に、以下のパラメータを指定することでイベントを構成します。
tags/otagsはカンマ(,)で区切ると複数指定することができます。
summary イベント名
startdate 開始日時：YYYY-MM-DD HH:MM:SS
enddate 終了日時：YYYY-MM-DD HH:MM:SS
allday 終日イベントか：trueまたはfalse
personal 私的イベントか：trueまたはfalse
description イベントの説明
url ホームページのアドレス
location 場所の説明
tags タグ
otags オーナータグ
image 画像イメージ：multipart/form-data形式
venue_name 場所の名前
venue_address 場所の住所
venue_zipcode 場所の郵便番号
venue_url 場所のホームページのアドレス
venue_district 場所の都道府県
venue_region 場所の地域
venue_country 場所の国
venue_latitude 場所の緯度
venue_longitude 場所の経度
イベントの追加に成功すると以下のように、追加されたイベントがレスポンスとして戻ります。
<?xml version="1.0" encoding="utf-8"?>
<response version="1.0" status="success">
<event>
<id>｛イベントID｝</id>
<summary>｛イベント名｝</summary>
<startdate>｛開始日時｝</startdate>
<enddate>｛終了日時｝</enddate>
<validenddate>｛終了日時が有効かどうか｝</validenddate>
<allday>｛終日イベントならtrue｝</allday>
<description>｛イベントの説明｝</description>
<location>｛場所などの説明｝</location>
<url>｛イベントを案内などしてるホームページのアドレス｝</url>
<personal>｛私的イベントならtrue｝</personal>
<tags>
<tag>｛タグ｝</tag>
...
</tags>
<otags>
<otag>｛オーナータグ｝</otag>
...
</otags>
<images>
<small>｛サムネイル用イメージ用のURL｝</small>
<large>｛イメージのURL｝</large>
</images>
<venue>
<name>｛場所の名前｝</name>
<address>｛場所の住所｝</address>
<zipcode>｛場所の郵便番号｝</zipcode>
<url>｛場所のURL｝</url>
<district>｛場所の｝</district>
<region>｛場所の｝</region>
<country>｛場所の国｝</country>
<latitude>｛場所の緯度｝</latitude>
<longitude>｛場所の経度｝</longitude>
</venue>
<comments>｛イベントを閲覧できるc2evt内のURL｝</comments>
</event>
</response>
HTTPサンプル
POST /event/rest?apid=########&method=event.add HTTP/1.1
Content-Type: text/xml; charset=utf-8
Authorization: Basic ########
Host: api.c2talk.net
Content-Length: ########
<?xml version="1.0" encoding="utf-8"?>
<root>
<event>
<summary>イベント名</summary>
<startdate>2007-08-18 12:00:00</startdate>
<enddate>2007-08-18 13:00:00</enddate>
<allday>false</allday>
<personal>false</personal>
<tags>
<tag>tag1</tag>
<tag>tag2</tag>
</tags>
</event>
</root>
HTTP/1.1 201 Created
Date: Mon, 27 Aug 2007 08:20:19 GMT
Server: Apache/2.0.55 (Unix) PHP/5.1.4 mod_ssl/2.0.55 OpenSSL/0.9.7l
X-Powered-By: PHP/5.1.4
Content-Length: ########
Content-Type: text/xml; charset=utf-8
<?xml version="1.0" encoding="utf-8"?>
<response version="1.0" status="success">
<event>
<id>########</id>
<summary>イベント名</summary>
<startdate>2007-08-18 12:00:00</startdate>
<enddate>2007-08-18 13:00:00</enddate>
<validenddate>true</validenddate>
<allday>false</allday>
<description/>
<location/>
<url/>
<personal>false</personal>
<tags>
<tag>tag1</tag>
<tag>tag2</tag>
</tags>
<comments>http://www.c2talk.net/event/id/#######</comments>
</event>
</response>
