92 lines
2.4 KiB
Java
92 lines
2.4 KiB
Java
/*
|
|
* Copyright 2007 Yusuke Yamamoto
|
|
*
|
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
* you may not use this file except in compliance with the License.
|
|
* You may obtain a copy of the License at
|
|
*
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
|
*
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
* See the License for the specific language governing permissions and
|
|
* limitations under the License.
|
|
*/
|
|
|
|
package twitter4j;
|
|
|
|
import java.io.Serializable;
|
|
|
|
/**
|
|
* @author Yusuke Yamamoto - yusuke at mac.com
|
|
* @since Twitter4J 3.0.2
|
|
* @see <a href="http://oembed.com">oEmded</a>
|
|
*/
|
|
public interface OEmbed extends TwitterResponse, Serializable {
|
|
/**
|
|
* The name of the author/owner of the resource.
|
|
*
|
|
* @return The name of the author/owner of the resource.
|
|
*/
|
|
String getAuthorName();
|
|
|
|
/**
|
|
* A URL for the author/owner of the resource.
|
|
*
|
|
* @return A URL for the author/owner of the resource.
|
|
*/
|
|
String getAuthorURL();
|
|
|
|
// provier_url is always "http://twitter.com/"
|
|
// String getProviderURL();
|
|
|
|
/**
|
|
* The suggested cache lifetime for this resource, in seconds. Consumers may
|
|
* choose to use this value or not.
|
|
*
|
|
* @return The suggested cache lifetime for this resource, in seconds.
|
|
* Consumers may choose to use this value or not.
|
|
*/
|
|
long getCacheAge();
|
|
|
|
// provider_name is always "Twitter"
|
|
// String getProviderName();
|
|
|
|
/**
|
|
* The HTML required to display the resource. The HTML should have no
|
|
* padding or margins. Consumers may wish to load the HTML in an off-domain
|
|
* iframe to avoid XSS vulnerabilities. The markup should be valid XHTML 1.0
|
|
* Basic.
|
|
*
|
|
* @return The HTML required to display the resource.
|
|
*/
|
|
String getHtml();
|
|
|
|
// type is always "rich"
|
|
// String getType();
|
|
|
|
/**
|
|
* The url of the resource provider.<br>
|
|
* The source URL of the image. Consumers should be able to insert this URL
|
|
* into an <img> element. Only HTTP and HTTPS URLs are valid.
|
|
*
|
|
* @return The url of the resource provider.
|
|
*/
|
|
String getURL();
|
|
|
|
/**
|
|
* The oEmbed version number.
|
|
*
|
|
* @return The oEmbed version number.
|
|
*/
|
|
String getVersion();
|
|
|
|
/**
|
|
* The width in pixels of the image specified in the url parameter.
|
|
*
|
|
* @return The width in pixels of the image specified in the url parameter.
|
|
*/
|
|
int getWidth();
|
|
}
|