section-upload: Flickcurl Flickr API Manual

section-upload

Functions

void	flickcurl_free_ticket ()
void	flickcurl_free_tickets ()
void	flickcurl_free_upload_status ()
void	flickcurl_free_user_upload_status ()
void	flickcurl_upload_status_free ()

Types and Values

	flickcurl_ticket
	flickcurl_upload_params
	flickcurl_upload_status
	flickcurl_user_upload_status

Description

Functions

flickcurl_free_ticket ()

void
flickcurl_free_ticket (flickcurl_ticket *ticket);

Destructor for ticket object

Parameters

ticket

ticket object

flickcurl_free_tickets ()

void
flickcurl_free_tickets (flickcurl_ticket **tickets_object);

Destructor for array of ticket objects

Parameters

tickets_object

ticket object array

flickcurl_free_upload_status ()

void
flickcurl_free_upload_status (flickcurl_upload_status *status);

Destructor - free a flickcurl_upload_status

Parameters

status

status object

flickcurl_free_user_upload_status ()

void
flickcurl_free_user_upload_status (flickcurl_user_upload_status *u);

Destructor for user upload status object

Parameters

user upload status object

flickcurl_upload_status_free ()

void
flickcurl_upload_status_free (flickcurl_upload_status *status);

flickcurl_upload_status_free is deprecated and should not be used in newly-written code.

Types and Values

flickcurl_ticket

typedef struct {
  int id;
  int photoid;
  int complete;
  int invalid;
} flickcurl_ticket;

An aysnchronous photo upload ticket.

Members

int `id`;	ticket ID
int `photoid`;
int `complete`;	complete flag
int `invalid`;	invalid flag

flickcurl_upload_params

typedef struct {
  const char* photo_file;
  const char *title;
  const char *description;
  const char *tags;

  int is_public;
  int is_friend;
  int is_family;

  int safety_level;
  int content_type;
  /* Flickcurl 1.22+ */
  int hidden;
} flickcurl_upload_params;

Photo upload parameters

Members

const char *`photo_file`;	photo filename
const char *`title`;	title or NULL
const char *`description`;	description of photo (HTML) (or NULL)
const char *`tags`;	space-separated list of tags (or NULL)
int `is_public`;	is public photo boolean (non-0 true)
int `is_friend`;	is friend photo boolean (non-0 true)
int `is_family`;	is family photo boolean (non-0 true)
int `safety_level`;	<=0 default, 1=safe, 2=moderate, 3=restricted
int `content_type`;	<=0 default, 1=photo, 2=screenshot, 3=other/artwork
int `hidden`;	<=0 default, 1=in global search, 2=hidden from publish searches (Flickcurl 1.22+)

flickcurl_upload_status

typedef struct {
  char *photoid;
  char *secret;
  char *originalsecret;
  char *ticketid;
} flickcurl_upload_status;

An upload response.

Members

char *`photoid`;	photo ID that was uploaded/replaced (upload only)
char *`secret`;	secret of photo uploaded (replace only)
char *`originalsecret`;	secret of original photo (replace only)
char *`ticketid`;	ticket ID for asynchronous upload (replace only)

flickcurl_user_upload_status

typedef struct {
  char* username;
  int bandwidth_maxbytes;
  int bandwidth_maxkb;
  int bandwidth_usedbytes;
  int bandwidth_usedkb;
  int bandwidth_remainingbytes;
  int bandwidth_remainingkb;

  int filesize_maxbytes;
  int filesize_maxkb;

  int sets_created;
  char* sets_remaining;
} flickcurl_user_upload_status;

A user's upload status

Members

char *`username`;	user name
int `bandwidth_maxbytes`;	max bytes
int `bandwidth_maxkb`;	max kbytes
int `bandwidth_usedbytes`;	used bytes
int `bandwidth_usedkb`;	used kbytes
int `bandwidth_remainingbytes`;	remaining bytes
int `bandwidth_remainingkb`;	remaining kbytes
int `filesize_maxbytes`;	max file size in bytes
int `filesize_maxkb`;	max file size in kbytes
int `sets_created`;	number of sets created
char *`sets_remaining`;	remaining sets: 0, 1, 2, 3 or "lots"