/// <summary>
/// Returns the url to a group's page.
/// </summary>
/// <param name="groupId">The NSID of the group to fetch the url for.</param>
/// <returns>An instance of the <see cref="Uri"/> class containing the URL of the group page.</returns>
public string UrlsGetGroup(string groupId)
{
var parameters = new Dictionary <string, string>();
parameters.Add("method", "flickr.urls.getGroup");
parameters.Add("group_id", groupId);
UnknownResponse response = GetResponseCache <UnknownResponse>(parameters);
System.Xml.XmlNode node = response.GetXmlDocument().SelectSingleNode("*/@url");
return(node == null ? null : node.Value.Replace("http://", "https://"));
}
/// <summary>
/// Retrieve a temporary FROB from the Flickr service, to be used in redirecting the
/// user to the Flickr web site for authentication. Only required for desktop authentication.
/// </summary>
/// <remarks>
/// Pass the FROB to the <see cref="AuthCalcUrl"/> method to calculate the url.
/// </remarks>
/// <example>
/// <code>
/// string frob = flickr.AuthGetFrob();
/// string url = flickr.AuthCalcUrl(frob, AuthLevel.Read);
///
/// // redirect the user to the url above and then wait till they have authenticated and return to the app.
///
/// Auth auth = flickr.AuthGetToken(frob);
///
/// // then store the auth.Token for later use.
/// string token = auth.Token;
/// </code>
/// </example>
/// <returns>The FROB.</returns>
public string AuthGetFrob()
{
CheckSigned();
var parameters = new Dictionary <string, string>();
parameters.Add("method", "flickr.auth.getFrob");
UnknownResponse response = GetResponseNoCache <UnknownResponse>(parameters);
return(response.GetXmlDocument().SelectSingleNode("frob/text()").Value);
}
/// <summary>
/// Adds a new comment to a photo.
/// </summary>
/// <param name="photoId">The ID of the photo to add the comment to.</param>
/// <param name="commentText">The text of the comment. Can contain some HTML.</param>
/// <returns>The new ID of the created comment.</returns>
public string PhotosCommentsAddComment(string photoId, string commentText)
{
var parameters = new Dictionary <string, string>();
parameters.Add("method", "flickr.photos.comments.addComment");
parameters.Add("photo_id", photoId);
parameters.Add("comment_text", commentText);
UnknownResponse response = GetResponseCache <UnknownResponse>(parameters);
System.Xml.XmlNode nav = response.GetXmlDocument().SelectSingleNode("*/@id");
return(nav == null ? null : nav.Value);
}
/// <summary>
/// Returns a group NSID, given the url to a group's page or photo pool.
/// </summary>
/// <param name="urlToFind">The url to the group's page or photo pool.</param>
/// <returns>The ID of the group at the specified URL on success, a null reference (Nothing in Visual Basic) if the group cannot be found.</returns>
public string UrlsLookupGroup(string urlToFind)
{
var parameters = new Dictionary <string, string>();
parameters.Add("method", "flickr.urls.lookupGroup");
parameters.Add("api_key", apiKey);
parameters.Add("url", urlToFind);
UnknownResponse response = GetResponseCache <UnknownResponse>(parameters);
System.Xml.XmlNode nav = response.GetXmlDocument().SelectSingleNode("*/@id");
return(nav == null ? null : nav.Value.Replace("http://", "https://"));
}
/// <summary>
/// UploadPicture method that does all the uploading work.
/// </summary>
/// <param name="stream">The <see cref="Stream"/> object containing the pphoto to be uploaded.</param>
/// <param name="fileName">The filename of the file to upload. Used as the title if title is null.</param>
/// <param name="title">The title of the photo (optional).</param>
/// <param name="description">The description of the photograph (optional).</param>
/// <param name="tags">The tags for the photograph (optional).</param>
/// <param name="isPublic">false for private, true for public.</param>
/// <param name="isFamily">true if visible to family.</param>
/// <param name="isFriend">true if visible to friends only.</param>
/// <param name="contentType">The content type of the photo, i.e. Photo, Screenshot or Other.</param>
/// <param name="safetyLevel">The safety level of the photo, i.e. Safe, Moderate or Restricted.</param>
/// <param name="hiddenFromSearch">Is the photo hidden from public searches.</param>
/// <returns>The id of the photograph after successful uploading.</returns>
public string UploadPicture(Stream stream, string fileName, string title, string description, string tags,
bool isPublic, bool isFamily, bool isFriend, ContentType contentType,
SafetyLevel safetyLevel, HiddenFromSearch hiddenFromSearch)
{
CheckRequiresAuthentication();
var uploadUri = new Uri(UploadUrl);
var parameters = new Dictionary <string, string>();
if (!string.IsNullOrEmpty(title))
{
parameters.Add("title", title);
}
if (!string.IsNullOrEmpty(description))
{
parameters.Add("description", description);
}
if (!string.IsNullOrEmpty(tags))
{
parameters.Add("tags", tags);
}
parameters.Add("is_public", isPublic ? "1" : "0");
parameters.Add("is_friend", isFriend ? "1" : "0");
parameters.Add("is_family", isFamily ? "1" : "0");
if (safetyLevel != SafetyLevel.None)
{
parameters.Add("safety_level", safetyLevel.ToString("D"));
}
if (contentType != ContentType.None)
{
parameters.Add("content_type", contentType.ToString("D"));
}
if (hiddenFromSearch != HiddenFromSearch.None)
{
parameters.Add("hidden", hiddenFromSearch.ToString("D"));
}
parameters.Add("api_key", apiKey);
parameters.Add("auth_token", apiToken);
string responseXml = UploadData(stream, fileName, uploadUri, parameters);
var t = new UnknownResponse();
((ITwentyThreeParsable)t).Load(responseXml);
return(t.GetElementValue("photoid"));
}
/// <summary>
/// Returns the url to a user's profile.
/// </summary>
/// <param name="userId">The NSID of the user to fetch the url for. If omitted, the calling user is assumed.</param>
/// <returns>An instance of the <see cref="Uri"/> class containing the URL for the users profile.</returns>
public string UrlsGetUserProfile(string userId)
{
var parameters = new Dictionary <string, string>();
parameters.Add("method", "flickr.urls.getUserProfile");
if (userId != null && userId.Length > 0)
{
parameters.Add("user_id", userId);
}
UnknownResponse response = GetResponseCache <UnknownResponse>(parameters);
System.Xml.XmlNode nav = response.GetXmlDocument().SelectSingleNode("*/@url");
return(nav == null ? null : nav.Value.Replace("http://", "https://"));
}
/// <summary>
/// Add a note to a picture.
/// </summary>
/// <param name="photoId">The photo id to add the note to.</param>
/// <param name="noteX">The X co-ordinate of the upper left corner of the note.</param>
/// <param name="noteY">The Y co-ordinate of the upper left corner of the note.</param>
/// <param name="noteWidth">The width of the note.</param>
/// <param name="noteHeight">The height of the note.</param>
/// <param name="noteText">The text in the note.</param>
/// <returns></returns>
public string PhotosNotesAdd(string photoId, int noteX, int noteY, int noteWidth, int noteHeight, string noteText)
{
var parameters = new Dictionary <string, string>();
parameters.Add("method", "flickr.photos.notes.add");
parameters.Add("photo_id", photoId);
parameters.Add("note_x", noteX.ToString(System.Globalization.NumberFormatInfo.InvariantInfo));
parameters.Add("note_y", noteY.ToString(System.Globalization.NumberFormatInfo.InvariantInfo));
parameters.Add("note_w", noteWidth.ToString(System.Globalization.NumberFormatInfo.InvariantInfo));
parameters.Add("note_h", noteHeight.ToString(System.Globalization.NumberFormatInfo.InvariantInfo));
parameters.Add("note_text", noteText);
UnknownResponse response = GetResponseCache <UnknownResponse>(parameters);
System.Xml.XmlNode node = response.GetXmlDocument().SelectSingleNode("*/@id");
return(node == null ? null : node.Value);
}
/// <summary>
/// Gets the currently authenticated users default safety level.
/// </summary>
/// <returns></returns>
public SafetyLevel PrefsGetSafetyLevel()
{
CheckRequiresAuthentication();
var parameters = new Dictionary <string, string>();
parameters.Add("method", "flickr.prefs.getSafetyLevel");
UnknownResponse response = GetResponseCache <UnknownResponse>(parameters);
System.Xml.XmlNode nav = response.GetXmlDocument().SelectSingleNode("*/@safety_level");
if (nav == null)
{
throw new ParsingException("Unable to find safety level in returned XML.");
}
return((SafetyLevel)int.Parse(nav.Value, System.Globalization.NumberFormatInfo.InvariantInfo));
}
/// <summary>
/// Replace an existing photo on Flickr.
/// </summary>
/// <param name="stream">The <see cref="Stream"/> object containing the photo to be uploaded.</param>
/// <param name="fileName">The filename of the file to replace the existing item with.</param>
/// <param name="photoId">The ID of the photo to replace.</param>
/// <returns>The id of the photograph after successful uploading.</returns>
public string ReplacePicture(Stream stream, string fileName, string photoId)
{
var replaceUri = new Uri(ReplaceUrl);
var parameters = new Dictionary <string, string>
{
{ "photo_id", photoId }
};
parameters.Add("api_key", apiKey);
parameters.Add("auth_token", apiToken);
var responseXml = UploadData(stream, fileName, replaceUri, parameters);
var t = new UnknownResponse();
((ITwentyThreeParsable)t).Load(responseXml);
return(t.GetElementValue("photoid"));
}
private void UploadDataAsync(Stream imageStream, string fileName, Uri uploadUri, Dictionary <string, string> parameters, Action <TwentyThreeResult <string> > callback)
{
string boundary = "TWENTYTHREE_MIME_" + DateTime.Now.ToString("yyyyMMddhhmmss", System.Globalization.DateTimeFormatInfo.InvariantInfo);
var dataBuffer = CreateUploadData(imageStream, fileName, parameters, boundary);
var req = (HttpWebRequest)WebRequest.Create(uploadUri);
req.Method = "POST";
req.ContentType = "multipart/form-data; boundary=" + boundary;
#if (!SILVERLIGHT && !WINDOWS_PHONE)
req.SendChunked = true;
#endif
req.AllowWriteStreamBuffering = false;
req.BeginGetRequestStream(
r =>
{
using (var reqStream = req.EndGetRequestStream(r))
{
var bufferSize = 32 * 1024;
if (dataBuffer.Length / 100 > bufferSize)
{
bufferSize = bufferSize * 2;
}
dataBuffer.UploadProgress += (o, e) => { if (OnUploadProgress != null)
{
OnUploadProgress(this, e);
}
};
dataBuffer.CopyTo(reqStream, bufferSize);
reqStream.Close();
}
req.BeginGetResponse(
r2 =>
{
var result = new TwentyThreeResult <string>();
try
{
var res = req.EndGetResponse(r2);
var sr = new StreamReader(res.GetResponseStream());
var responseXml = sr.ReadToEnd();
sr.Close();
var t = new UnknownResponse();
((ITwentyThreeParsable)t).Load(responseXml);
result.Result = t.GetElementValue("photoid");
result.HasError = false;
}
catch (Exception ex)
{
result.Error = ex;
}
callback(result);
},
this);
},
this);
}