メニュー

Rate this page:

Thanks for rating this page!

We are always striving to improve our documentation quality, and your feedback is valuable to us. How could this documentation serve you better?

Fax Mediaリソース

Faxメディアリソースは個々のFaxインスタンスに添付されたメディアについての追加情報を提供します。 これは各Faxインスタンスのサブリソースです。 もしMessaging Media APIをすでにお使いいただいていれば、これはすでにお馴染みでしょう。

Fax Mediaインスタンスリソース

このリソースはFax通信の一部として送受信されたメディアを表します。

リソース URL

https://fax.twilio.com/v1/Faxes/{FaxSid}/Media/{MediaSid}

{FaxSid}および{MediaSid}にはそれぞれ、FaxおよびFaxメディアに関連づけられた34文字の一意なIDです。

リソースのプロパティ

Fax Mediaインスタンスは下記のプロパティーによって表されます:

Names in PHP format
sid
sid<ME> Not PII

A 34 character string that uniquely identifies this fax media.

accountSid
sid<AC> Not PII

The unique SID identifier of the Account.

faxSid
sid<FX> Not PII

The unique SID identifier of the fax for which this media is associated.

contentType
文字列 Not PII

The content type of the stored fax media (example: application/pdf).

dateCreated
date_time<iso8601> Not PII

The date that this fax media was created, given in ISO 8601 format.

dateUpdated
date_time<iso8601> Not PII

The date that this fax media was updated, given in ISO 8601 format.

url
url Not PII

The URL of this resource.

HTTP GET

単一のFax Mediaインスタンスを取得します。

希望するメディアの表現を選択するには、 Accept ヘッダーを使用することが必要です。

  • application/jsonが指定されると、上記のインスタンスプロパティーはJSONオブジェクトとして返されます。
  • */* が指定されるか、ヘッダーが存在しない場合は、メディア自体はそのネイティブ形式 (通常は application/pdf) で返されます。 (この機能はまだ実装されていませんが、ライブラリーの実装に前方互換性を持たせられるようにここに記載されていることにご注意ください。)

If requesting fax media from a web application, you must specify a User-Agent header in your request to Twilio.

戻り値

指定された FaxSid に対するMediaSid が見つかった場合、単一のMediaインスタンスリソースを伴ったHTTP 200を返します

MediaSid が見つからない場合、コード 404 を返します。

HTTP POST

サポートされていません。

HTTP PUT

サポートされていません。

HTTP DELETE

メタデータと関連づけられたメディアファイル療法を含む、Fax Mediaインスタンスを削除します。 この操作は取り消しが行えないため、十分ご注意ください。

戻り値

Fax Mediaインスタンスリソースの削除に成功した、あるいは以前に削除された、または見つからなかった場合にはHTTP 200を返します

Fax Mediaリストリソース

このリソースはFax通信の一部として送受信された全メディアを一覧します。

リソース URL

https://fax.twilio.com/v1/Faxes/{FaxSid}/Media

{FaxSid} はそれぞれ、FaxおよびFaxメディアに関連づけられた34文字の一意なIDです。

HTTP GET

指定されたFaxインスタンスに対するFax Mediaインスタンスを一覧します。

戻り値

Twilioの標準ページ情報を伴って (fax_media キー配下に) リソースを一覧しHTTP 200を返します (Faxインスタンスに関連づけられたメディアが保存されていない場合は一覧は空になることがあります) 。

HTTP POST

サポートされていません。

HTTP PUT

サポートされていません。

HTTP DELETE

サポートされていません。

Rate this page:

ヘルプが必要ですか?

We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd browsing the Twilio tag on Stack Overflow.