c2talk.net APIはHTTPリクエストとして実装されています。以下のURLにいくつかのURLパラメータとともに、GETもしくはPOSTメソッドでリクエストを発行します。
http://api.c2talk.net/event/rest
どの機能を使う場合でも、apidとmethodパラメータは必ず必要です。
パラメータ
apid アプリケーションID
method 関数名(機能名)
アプリケーションID(apid)とは
c2talk.net APIを使う上で必須なIDで、各リクエスト毎に必ずつける必要があります。
c2talk.netユーザーであれば、どなたでもいくつでも申請登録することができます。
使用されるアプリケーション毎に登録するようお願いします。
パラメータに日本語を使用される場合には、utf-8バイト列にURLエンコード(%##表記)したものを使用してください。
HTTPメソッドは(GETもしくはPOST)は、methodパラメータで指定する機能によりどちらを使用するか決まっています。
全ての機能はレスポンスとして以下のようなXMLドキュメントを返します。
< ?xml version="1.0" encoding="utf-8"?> <response version="1.0" status="success"> ... </response> < ?xml version="1.0" encoding="utf-8"?> <response version="1.0" status="failed"> <message>...</message> </response>