flickrex v0.3.0 Flickr.Push

Summary

Functions

Returns a list of the subscriptions for the logged-in user.



(this method is experimental and may change)

All the different flavours of anteater.



(this method is experimental and may change)

In ur pandas, tickling ur unicorn



(this method is experimental and may change)

Why would you want to do this?



(this method is experimental and may change)

Types

args()
args() :: Keyword.t
client()
client() :: Flickrex.Client.t
response()
response() :: Flickrex.Parser.response

Functions

get_subscriptions(client, args \\ [])
get_subscriptions(client, args) :: response

Returns a list of the subscriptions for the logged-in user.



(this method is experimental and may change)

This method requires authentication with “read” permission.

Arguments

get_topics(client, args \\ [])
get_topics(client, args) :: response

All the different flavours of anteater.



(this method is experimental and may change)

This method does not require authentication.

Arguments

subscribe(client, args \\ [])
subscribe(client, args) :: response

In ur pandas, tickling ur unicorn



(this method is experimental and may change)

This method requires authentication with “read” permission.

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.

unsubscribe(client, args \\ [])
unsubscribe(client, args) :: response

Why would you want to do this?



(this method is experimental and may change)

This method requires authentication with “read” permission.

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.