Uploading

## Uploading Uploading — Uploading APIs and Asynchronous upload tickets. |

## Synopsis

                        flickcurl_ticket;
    void                flickcurl_free_ticket               (flickcurl_ticket *ticket);
    void                flickcurl_free_tickets              (flickcurl_ticket **tickets_object);
                        flickcurl_upload_params;
                        flickcurl_upload_status;
                        flickcurl_user_upload_status;
    void                flickcurl_free_upload_status        (flickcurl_upload_status *status);
    void                flickcurl_free_user_upload_status   (flickcurl_user_upload_status *u);

## Description

Uploading APIs and Asynchronous upload tickets.

## Details

### flickcurl_ticket

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

An aysnchronous photo upload ticket.

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

### flickcurl_free_ticket ()

    void                flickcurl_free_ticket               (flickcurl_ticket *ticket);

Destructor for ticket object

`ticket` : | ticket object

### flickcurl_free_tickets ()

    void                flickcurl_free_tickets              (flickcurl_ticket **tickets_object);

Destructor for array of ticket objects

`tickets_object` : | ticket object array

### 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_upload_params;

Photo upload parameters

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`; | 1=safe, 2=moderate, 3=restricted
int `content_type`; | 1=photo, 2=screenshot, 3=other/artwork

### flickcurl_upload_status

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

An upload response.

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

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"

### flickcurl_free_upload_status ()

    void                flickcurl_free_upload_status        (flickcurl_upload_status *status);

Destructor - free a flickcurl_upload_status

`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

`u` : | user upload status object