SOAP の応答形式

サーバからSOAP 形式の応答が返ってくるようにするには、"format"パラメータに"soap"と設定してリクエストを送ります。

簡単なエコーサービスを実行すると戻り値はこうなります。:

<?xml version="1.0" encoding="utf-8" ?>
<s:Envelope
	xmlns:s="http://www.w3.org/2003/05/soap-envelope"
	xmlns:xsi="http://www.w3.org/1999/XMLSchema-instance"
	xmlns:xsd="http://www.w3.org/1999/XMLSchema"
>
	<s:Body>
		<x:FlickrResponse xmlns:x="urn:flickr">
			[escaped-xml-payload]
		</x:FlickrResponse>
	</s:Body>
</s:Envelope>

エラーが発生した場合は、以下の戻り値が返ってきます:

<?xml version="1.0" encoding="utf-8" ?>
<s:Envelope xmlns:s="http://www.w3.org/2003/05/soap-envelope">
	<s:Body>
		<s:Fault>
			<faultcode>flickr.error.[error-code]</faultcode>
			<faultstring>[error-message]</faultstring>
			<faultactor>
				http://www.flickr.com/services/soap/
			</faultactor>
			<details>
				Please see 
				http://www.flickr.com/services/docs/ 
				for more details
			</details>
		</s:Fault>
	</s:Body>
</s:Envelope>

ここで応答のデモを見ることができます。

SOAPの詳細については www.w3.org/TR/soap/で参照することができます。

もう一つのSOAP 応答形式

formatパラメータの値に"soap2"を設定することで、flickrはアンエスケープXMLとしてAPIの応答を返します。 応答に名前空間を設定することによって、直接envelopeエレメント内に応答を格納しています。 エラー時の応答は通常のSOAPと変わりませんが、成功時の応答は以下のようになります:

<?xml version="1.0" encoding="utf-8" ?>
<s:Envelope xmlns:s="http://www.w3.org/2003/05/soap-envelope">
	<s:Body>
		<FlickrResponse xmlns="/ns/api#">
			[xml-payload]
		</FlickrResponse>
	</s:Body>
</s:Envelope>

この応答タイプは新しく実装した試験的なものなので、将来のバージョンではサポートされない可能性があります。

ここで応答のデモを見ることができます。



注意事項

  • 本サイトはflickrのサイトを翻訳したものであり、flickrに関する著作権は全てそちらに帰属しています。
  • 誤訳が判明した場合、より分かりやすい言い回しが見つかった場合、原文が変更された場合などにより、本サイトの内容は予告なく変更されることがあります。
  • 誤訳についての指摘や未翻訳部分についての助言など、ご意見についてはこちらへいただけると助かります。
  • 翻訳の内容には誤りがある可能性があります。本サイトの記述内容によって不利益が発生した場合も、サイト管理人は一切の責任を負いません。
    •