class FlickRaw::Flickr::Push

flickr.push.getSubscriptions request.

Returns a list of the subscriptions for the logged-in user. (this method is experimental and may change)

Arguments

Error codes

• 5: Service currently available only to pro accounts

  PuSH subscriptions are currently restricted to Pro account holders.

• 96: Invalid signature

  The passed signature was invalid.

• 97: Missing signature

  The call required signing but no signature was sent.

• 98: Login failed / Invalid auth token

  The login details or auth token passed were invalid.

• 99: User not logged in / Insufficient permissions

  The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions.

• 100: Invalid API Key

  The API key passed was not valid or has expired.

• 105: Service currently unavailable

  The requested service is temporarily unavailable.

• 106: Write operation failed

  The requested operation failed due to a temporary issue.

• 111: Format “xxx” not found

  The requested response format was not found.

• 112: Method “xxx” not found

  The requested method was not found.

• 114: Invalid SOAP envelope

  The SOAP envelope send in the request could not be parsed.

• 115: Invalid XML-RPC Method Call

  The XML-RPC request document could not be parsed.

• 116: Bad URL found

  One or more arguments contained a URL that has been used for abuse on Flickr.

Returns

# Generated automatically from flickr api
  def getSubscriptions(*args)
    @flickr.call 'flickr.push.getSubscriptions', *args
  end

flickr.push.getTopics request.

All the different flavours of anteater. (this method is experimental and may change)

Arguments

Error codes

• 100: Invalid API Key

  The API key passed was not valid or has expired.

• 105: Service currently unavailable

  The requested service is temporarily unavailable.

• 106: Write operation failed

  The requested operation failed due to a temporary issue.

• 111: Format “xxx” not found

  The requested response format was not found.

• 112: Method “xxx” not found

  The requested method was not found.

• 114: Invalid SOAP envelope

  The SOAP envelope send in the request could not be parsed.

• 115: Invalid XML-RPC Method Call

  The XML-RPC request document could not be parsed.

• 116: Bad URL found

  One or more arguments contained a URL that has been used for abuse on Flickr.

Returns

# Generated automatically from flickr api
  def getTopics(*args)
    @flickr.call 'flickr.push.getTopics', *args
  end

flickr.push.subscribe request.

In ur pandas, tickling ur unicorn (this method is experimental and may change)

Arguments

topic (required)

The type of subscription. See flickr.push.getTopics.

callback (required)

The url for the subscription endpoint. Limited to 255 bytes, and must be unique for this user, i.e. no two subscriptions for a given user may use the same callback url.

verify (required)

The verification mode, either sync or async. See the Google PubSubHubbub spec for details.

verify_token

The verification token to be echoed back to the subscriber during the verification callback, as per the Google PubSubHubbub spec. Limited to 200 bytes.

lease_seconds

Number of seconds for which the subscription will be valid. Legal values are 60 to 86400 (1 minute to 1 day). If not present, the subscription will be auto-renewing.

woe_ids

A 32-bit integer for a Where on Earth ID. Only valid if topic is geo.

The order of precedence for geo subscriptions is : woe ids, place ids, radial i.e. the lat, lon parameters will be ignored if place_ids is present, which will be ignored if woe_ids is present.

place_ids

A comma-separated list of Flickr place IDs. Only valid if topic is geo.

The order of precedence for geo subscriptions is : woe ids, place ids, radial i.e. the lat, lon parameters will be ignored if place_ids is present, which will be ignored if woe_ids is present.

lat

A latitude value, in decimal format. Only valid if topic is geo. Defines the latitude for a radial query centered around (lat, lon).

The order of precedence for geo subscriptions is : woe ids, place ids, radial i.e. the lat, lon parameters will be ignored if place_ids is present, which will be ignored if woe_ids is present.

lon

A longitude value, in decimal format. Only valid if topic is geo. Defines the longitude for a radial query centered around (lat, lon).

The order of precedence for geo subscriptions is : woe ids, place ids, radial i.e. the lat, lon parameters will be ignored if place_ids is present, which will be ignored if woe_ids is present.

radius

A radius value, in the units defined by radius_units. Only valid if topic is geo. Defines the radius of a circle for a radial query centered around (lat, lon). Default is 5 km.

The order of precedence for geo subscriptions is : woe ids, place ids, radial i.e. the lat, lon parameters will be ignored if place_ids is present, which will be ignored if woe_ids is present.

radius_units

Defines the units for the radius parameter. Only valid if topic is geo. Options are mi and km. Default is km.

The order of precedence for geo subscriptions is : woe ids, place ids, radial i.e. the lat, lon parameters will be ignored if place_ids is present, which will be ignored if woe_ids is present.

accuracy

Defines the minimum accuracy required for photos to be included in a subscription. Only valid if topic is geo Legal values are 1-16, default is 1 (i.e. any accuracy level).

World level is 1 Country is ~3 Region is ~6 City is ~11 Street is ~16

nsids

A comma-separated list of nsids representing Flickr Commons institutions (see flickr.commons.getInstitutions). Only valid if topic is commons. If not present this argument defaults to all Flickr Commons institutions.

tags

A comma-separated list of strings to be used for tag subscriptions. Photos with one or more of the tags listed will be included in the subscription. Only valid if the topic is tags.

machine_tags

A comma-separated list of strings to be used for machine tag subscriptions. Photos with one or more of the machine tags listed will be included in the subscription. Currently the format must be namespace:tag_name=value Only valid if the topic is tags.

update_type

output_format

mailto

Error codes

• 1: Required parameter missing

  One of the required arguments for the method was not provided.

• 2: Invalid parameter value

  One of the arguments was specified with an illegal value.

• 3: Callback URL already in use for a different subscription

  A different subscription already exists that uses the same callback URL.

• 4: Callback failed or invalid response

  The verification callback failed, or failed to return the expected response to confirm the subscription.

• 5: Service currently available only to pro accounts

  PuSH subscriptions are currently restricted to Pro account holders.

• 6: Subscription awaiting verification callback response - try again later

  A subscription with those details exists already, but it is in a pending (non-verified) state. Please wait a bit for the verification callback to complete before attempting to update the subscription.

• 96: Invalid signature

  The passed signature was invalid.

• 97: Missing signature

  The call required signing but no signature was sent.

• 98: Login failed / Invalid auth token

  The login details or auth token passed were invalid.

• 99: User not logged in / Insufficient permissions

  The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions.

• 100: Invalid API Key

  The API key passed was not valid or has expired.

• 105: Service currently unavailable

  The requested service is temporarily unavailable.

• 106: Write operation failed

  The requested operation failed due to a temporary issue.

• 111: Format “xxx” not found

  The requested response format was not found.

• 112: Method “xxx” not found

  The requested method was not found.

• 114: Invalid SOAP envelope

  The SOAP envelope send in the request could not be parsed.

• 115: Invalid XML-RPC Method Call

  The XML-RPC request document could not be parsed.

• 116: Bad URL found

  One or more arguments contained a URL that has been used for abuse on Flickr.

# Generated automatically from flickr api
  def subscribe(*args)
    @flickr.call 'flickr.push.subscribe', *args
  end

flickr.push.unsubscribe request.

Why would you want to do this? (this method is experimental and may change)

Arguments

topic (required)

The type of subscription. See flickr.push.getTopics.

callback (required)

The url for the subscription endpoint (must be the same url as was used when creating the subscription).

verify (required)

The verification mode, either 'sync' or 'async'. See the Google PubSubHubbub spec for details.

verify_token

The verification token to be echoed back to the subscriber during the verification callback, as per the Google PubSubHubbub spec. Limited to 200 bytes.

Error codes

• 1: Required parameter missing

  One of the required arguments for the method was not provided.

• 2: Invalid parameter value

  One of the arguments was specified with an illegal value.

• 4: Callback failed or invalid response

  The verification callback failed, or failed to return the expected response to confirm the un-subscription.

• 6: Subscription awaiting verification callback response - try again later

  A subscription with those details exists already, but it is in a pending (non-verified) state. Please wait a bit for the verification callback to complete before attempting to update the subscription.

• 7: Subscription not found

  No subscription matching the provided details for this user could be found.

• 96: Invalid signature

  The passed signature was invalid.

• 97: Missing signature

  The call required signing but no signature was sent.

• 98: Login failed / Invalid auth token

  The login details or auth token passed were invalid.

• 99: User not logged in / Insufficient permissions

  The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions.

• 100: Invalid API Key

  The API key passed was not valid or has expired.

• 105: Service currently unavailable

  The requested service is temporarily unavailable.

• 106: Write operation failed

  The requested operation failed due to a temporary issue.

• 111: Format “xxx” not found

  The requested response format was not found.

• 112: Method “xxx” not found

  The requested method was not found.

• 114: Invalid SOAP envelope

  The SOAP envelope send in the request could not be parsed.

• 115: Invalid XML-RPC Method Call

  The XML-RPC request document could not be parsed.

• 116: Bad URL found

  One or more arguments contained a URL that has been used for abuse on Flickr.

# Generated automatically from flickr api
  def unsubscribe(*args)
    @flickr.call 'flickr.push.unsubscribe', *args
  end