com.podio.embed.EmbedAPI Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of api Show documentation

The official Java wrapper for the Podio API

There is a newer version: 0.7.9

package com.podio.embed;

import javax.ws.rs.core.MediaType;

import com.podio.BaseAPI;
import com.podio.ResourceFactory;

/**
 * Embeds are links shared by users in statuses, conversations and comments. One
 * or more embeds are also referred when creating items with an embed file type.
 */
public class EmbedAPI extends BaseAPI {

	public EmbedAPI(ResourceFactory resourceFactory) {
		super(resourceFactory);
	}

	/**
	 * Grabs metadata and returns metadata for the given url such as title,
	 * description and thumbnails.
	 * 
	 * @param url
	 *            The URL of the embed
	 * @return The full embed data
	 */
	public Embed createEmbed(String url) {
		return getResourceFactory().getApiResource("/embed/")
				.entity(new EmbedCreate(url), MediaType.APPLICATION_JSON_TYPE)
				.post(Embed.class);
	}
}