Media Resource
The Media resource represents a piece of media, such as an image, that is associated with a message.
Twilio will create a Media resource and store the contents of the media when the following events occur:
- You send a message with an image via Twilio
- You receive media on one of your Twilio phone numbers
Twilio will keep that media around until you issue an HTTP DELETE on that instance.
To secure access to media stored on Twilio, you can enable HTTP basic authentication on the Console settings for Programmable Messaging.
Messages sent via Twilio can include up to 10 media files that have a total size of up to 5MB. Twilio will resize images as necessary for successful delivery based on carrier specifications. Messages with over 5MB of media will not be accepted.
Media properties
| Resource Properties in REST API format | |
|---|---|
account_sid
|
The SID of the Account that created this Media resource. |
content_type
|
デフォルトのメディアのMIMEタイプ例 : |
date_created
|
The date and time in GMT that this resource was created specified in RFC 2822 format. |
date_updated
|
The date and time in GMT that this resource was last updated, specified in RFC 2822 format. |
parent_sid
|
The SID of the resource that created the media. |
sid
|
The unique string that that we created to identify this Media resource. |
uri
|
The URI of this resource, relative to |
Fetch a Media resource
https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/Messages/{MessageSid}/Media/{Sid}.json
Returns a single media resource using one of several representations:
既定: content-type
Without an extension, the media is returned using the mime-type provided when the media was generated.
GET /2010-04-01/Accounts/AC.../Message/MM.../Media/ME557ce644e5ab84fa21cc21112e22c485
代替: XML
URI に「.xml」をつけると、通常の XML 表現を返します。 たとえば、次のようになります。
GET /2010-04-01/Accounts/AC.../Message/MM.../Media/ME557ce644e5ab84fa21cc21112e22c485.xml
<TwilioResponse>
<Media>
<Sid>ME557ce644e5ab84fa21cc21112e22c485</Sid>
<AccountSid>ACda6f1e11047ebd6fe7a55f120be3a900</AccountSid>
<ParentSid>MM8dfedb55c129dd4d6bd1f59af9d11080</ParentSid>
<ContentType>image/jpeg</ContentType>
<DateCreated>Fri, 17 Jul 2009 01:52:49 +0000</DateCreated>
<DateUpdated>Fri, 17 Jul 2009 01:52:49 +0000</DateUpdated>
<Uri>/2010-04-01/Accounts/ACda6f1e11047ebd6fe7a55f120be3a900/Message/MM8dfedb55c129dd4d6bd1f59af9d11080/Media/ME557ce644e5ab84fa21cc21112e22c485.xml</Uri>
</Media>
</TwilioResponse>代替: JSON
URI に「.JSON」をつけると、JSON 表現を返します。 たとえば、次のようになります。
GET /2010-04-01/Accounts/AC.../Message/MM.../Media/ME557ce644e5ab84fa21cc21112e22c485.json
{
"sid": "ME557ce644e5ab84fa21cc21112e22c485",
"account_sid": "ACda6f1e11047ebd6fe7a55f120be3a900",
"parent_sid": "MM8ff928b2451c0db925bd2d581f0fba79",
"content_type": "image/jpeg",
"date_created": "Fri, 26 Apr 2013 05:41:35 +0000",
"date_updated": "Fri, 26 Apr 2013 05:41:35 +0000",
"uri": "/2010-04-01/Accounts/ACda6f1e11047ebd6fe7a55f120be3a900/Message/MM8dfedb55c129dd4d6bd1f59af9d11080/Media/ME557ce644e5ab84fa21cc21112e22c485.json"
}パラメーター
| Parameters in REST API format | |
|---|---|
account_sid
Path
|
The SID of the Account that created the Media resource(s) to fetch. |
message_sid
Path
|
The SID of the Message resource that this Media resource belongs to. |
sid
Path
|
The Twilio-provided string that uniquely identifies the Media resource to fetch |
Because the stored media URLs are useful for many external applications, they are public and do not require HTTP Basic Auth to access. This allows you to embed the URL in a web application without revealing your Twilio API credentials.
If you have a need to restrict access on media stored with Twilio, you can enable HTTP Auth on the Console settings. When you fetch your message media after enabling HTTP auth, you will be directed to a signed URL that is only valid for 4 hours.
You can make subsequent API requests for new short-lived URLs for your media at any time.
例 1
Read multiple Media resources
https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/Messages/{MessageSid}/Media.json
メッセージに関連するメディアのリストを返します。このリストはページ情報を含みます。
Filter by date created
You may limit the list of Message Media to media created on a given date. Provide the following query string parameter to your API call:
パラメーター
| Parameters in REST API format | |
|---|---|
account_sid
Path
|
The SID of the Account that created the Media resource(s) to read. |
message_sid
Path
|
The SID of the Message resource that this Media resource belongs to. |
date_created
オプション
|
Only include media that was created on this date. Specify a date as |
例 1
Delete a Media resource
https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/Messages/{MessageSid}/Media/{Sid}.json
メディアをアカウントから削除。
削除に成功すると、ボディーのない HTTP 204 (No Content) レスポンスを返します。
パラメーター
| Parameters in REST API format | |
|---|---|
account_sid
Path
|
The SID of the Account that created the Media resource(s) to delete. |
message_sid
Path
|
The SID of the Message resource that this Media resource belongs to. |
sid
Path
|
The Twilio-provided string that uniquely identifies the Media resource to delete |
例 1
ヒントとテクニック
- Twilio will attempt to cache the media file the first time it is used. This may add a slight delay in sending the message.
- HTTPヘッダーが許可している（EtagおよびLast-Modifiedヘッダー経由）場合、Twilioはファイルのキャッシュを行います。
Cache-Control: no-cacheを伴ったレスポンスを行うと、Twilioはファイルが変更されたかどうかを常に確認するようになり、ご使用のWebサーバーが新しいバージョンのファイルでレスポンスするか、それとも403 Not Modifiedを返してTwilioにキャッシュされたバージョンを使用させることができます。
ヘルプが必要ですか？
We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd by visiting Twilio's Stack Overflow Collective or browsing the Twilio tag on Stack Overflow.