API documentation

Standard APIs

Product Category

http://druidry.com/v1/products/category

HTTP Method GET
Authentication API Key

Examples


Search Products

http://druidry.com/v1/products/search

HTTP Method GET
Authentication API Key

Parameters

category required ACCOMM, TOUR, HIRE, TRANSPORT, ATTRACTION, EVENT, DESTINFO, INFO Product category
state optional NT, QLD, NSW, ACT, VIC, SA, WA, TAS State
STO optional TQ, TNSW, TVIC, TTAS, ACTC, SATC, WATC, NTTC STO
name optional any string A search term to be applied against product names.
limit optional 10 limit number of objects.
verbose optional true return full product detail
updated optional 1333112400 only return objects with changes after given unix timestamp
own optional true only return objects owned by user

Examples


Nearby Products

http://druidry.com/v1/products/nearby

HTTP Method GET
Authentication API Key

Parameters

ll required -35.2820396423, 149.1285858154 latitude, longitude
category optional ACCOMM, TOUR, HIRE, TRANSPORT, ATTRACTION, EVENT, DESTINFO, INFO Product category
name optional any string A search term to be applied against product names.
radius optional 1000 Limit results to products within set meters. Defaults to 3km, maximum radius 100,000 (100km)
limit optional 10 limit number of results.
updated optional 1333112400 only return objects with changes after given unix timestamp
verbose optional true return full product detail
compact optional true return compact product object
format optional kml KML for nearby products
own/watch optional true only return objects owned/watched by user, only accept 1 parameter, "owned" has higher priority

Examples


Product KML

http://druidry.com/v1/product/kml

HTTP Method GET
Authentication API Key

Parameters

id required 4f8f65cd6803faab49000026 Product ID

Examples

Skater HQ - http://druidry.com/v1/product/kml/id/5281e0711a55b77d208b4569/api_key/515bccdcd199f6243f000000

View Product

http://druidry.com/v1/product/info

HTTP Method GET
Authentication API Key

Parameters

id required 4f8f65cd6803faab49000014 Product ID

Examples

Skater HQ - http://druidry.com/v1/product/info/id/5281e0711a55b77d208b4569/api_key/515bccdcd199f6243f000000
Multimedia - Cape Hillsborough http://druidry.com/v1/product/info/id/5281e0701a55b777208b4569/api_key/515bccdcd199f6243f000000
Service - Alonga Cottages http://druidry.com/v1/product/info/id/5281e0971a55b773208b45bd/api_key/515bccdcd199f6243f000000

Add Product

http://druidry.com/v1/product/info

HTTP Method POST
Authentication API Key

Parameters

data required {"category": "HIRE", ...} JSON object containing product details
Response { "status" : true/false, "product_id" : 4f8f65cd6803faab49000014 }

Edit Product

http://druidry.com/v1/product/info

HTTP Method PUT
Authentication API Key

Parameters

id required 4f8f65cd6803faab49000014 Product ID
data required {"category": "HIRE", ...} JSON object containing update details, this example changes the product category to HIRE
Response { "status" : true/false }

Delete Product

http://druidry.com/v1/product/info

HTTP Method DELETE
Authentication API Key

Parameters

id required 4f8f65cd6803faab49000014 Product ID
Response { "status" : true/false }

View Service

http://druidry.com/v1/product/service

HTTP Method GET
Authentication API Key

Parameters

id required 4f8f65cd6803faab49000014 Service ID

Examples

Finch Hatton Gorge to Eungella National Park Walks - http://druidry.com/v1/product/service/id/5281e0711a55b77d208b4569/api_key/515bccdcd199f6243f000000

Add Service

http://druidry.com/v1/product/service

HTTP Method POST
Authentication API Key

Parameters

product required 4f8f65cd6803faab49000014 Product ID
data required { "key": value, ...} JSON object containing service details
Response { "status" : true/false, "s_id" : 4f8f65cd6803faab49000014 }

Edit Service

http://druidry.com/v1/product/service

HTTP Method PUT
Authentication API Key

Parameters

id required 4f8f65cd6803faab49000014 Service ID
data required {"name": "Other name", ...} JSON object containing update details
Response { "status" : true/false }

Delete Service

http://druidry.com/v1/product/service

HTTP Method DELETE
Authentication API Key

Parameters

id required 4f8f65cd6803faab49000014 Service ID
Response { "status" : true/false }

JSON Schema

        {
            "content_type": {
                "type": "string",
                "required": true,
                "enum": ["LOGO", "IMAGE", "FULLIMAGE"]
            },
            "alt_text": {
                "type": "string",
                "required": true
            },
            "orientation": {
                "type": "string",
                "required": true,
                "enum": ["LANDSCAPE", "PORTRAIT"]
            },
            "sequence":{
              "type": "integer",
              "required": true,
              "maximum": 4294967295,
              "minimum": 1
            },
            "copyright":{
                "type": "string",
                "optional": true
            },
            "photographer":{
                "type": "string",
                "optional": true
            }
        }
    

View Product Multimedia

http://druidry.com/v1/product/multimedia

HTTP Method GET
Authentication API Key

Parameters

id required 4f8f65cd6803faab49000014 Multimedia ID

Examples

9001149_001.jpg - http://druidry.com/v1/product/multimedia/id/5281a14a1a55b795518b4998/api_key/515bccdcd199f6243f000000

Add Product Multimedia

http://druidry.com/v1/product/multimedia

HTTP Method POST
Authentication API Key

Parameters

Content Type multipart/form-data File upload parameter key file
product required 4f8f65cd6803faab49000014 Product ID
data required {"content_type": "IMAGE", ...} JSON object containing new multimedia details
Response { "status" : true/false, "items" : [ {}, {} ] }

Update Product Multimedia metadata

http://druidry.com/v1/product/multimedia

HTTP Method PUT
Authentication API Key

Parameters

Content Type application/json
id required 4f8f65cd6803faab49000014 Multimedia ID
data required {"children_catered_for": 0, ...} JSON object
Response { "status" : true/false, "item": {} } (alt_text will be applied to all multimedia with same sequence number)

Delete Product Multimedia By ID

http://druidry.com/v1/product/multimedia

HTTP Method DELETE
Authentication API Key

Parameters

id required 4f8f65cd6803faab49000014 Multimedia ID
Response { "status" : true/false, "item": {} }

Delete Product Multimedia By Sequence

http://druidry.com/v1/product/multimedia

HTTP Method DELETE
Authentication API Key

Parameters

sequence required 100 Sequence ID
product required 4f8f65cd6803faab49000014 Product ID
Response { "status" : true/false, "items": [ {}, {} ] }

View Service Multimedia

http://druidry.com/v1/service/multimedia

HTTP Method GET
Authentication API Key

Parameters

id required 4f8f65cd6803faab49000014 Multimedia ID

Examples

ATDW_Landscape__TQ_DSC_0097.jpg - http://druidry.com/v1/service/multimedia/id/5281b2381a55b7296e8b458e/api_key/515bccdcd199f6243f000000

Add Service Multimedia

http://druidry.com/v1/service/multimedia

HTTP Method POST
Authentication API Key

Parameters

Content Type multipart/form-data File upload parameter key file
service required 4f8f65cd6803faab49000014 Product ID
data required {"content_type": "IMAGE", ...} JSON object containing new multimedia details
Response { "status" : true/false, "items" : [ {}, {} ] }

Update Service Multimedia metadata

http://druidry.com/v1/service/multimedia

HTTP Method PUT
Authentication API Key

Parameters

Content Type application/json
id required 4f8f65cd6803faab49000014 Multimedia ID
data required {"children_catered_for": 0, ...} JSON object
Response { "status" : true/false, "item": {} } (alt_text will be applied to all multimedia with same sequence number)

Delete Service Multimedia By ID

http://druidry.com/v1/service/multimedia

HTTP Method DELETE
Authentication API Key

Parameters

id required 4f8f65cd6803faab49000014 Multimedia ID
Response { "status" : true/false, "item": {} }

Delete Service Multimedia By Sequence

http://druidry.com/v1/service/multimedia

HTTP Method DELETE
Authentication API Key

Parameters

sequence required 100 Sequence ID
service required 4f8f65cd6803faab49000014 Service ID
Response { "status" : true/false, "items": [ {}, {} ] }

Attribute List by Category

http://druidry.com/v1/attribute/category

HTTP Method GET
Authentication API Key

Parameters

category optional ACCOMM, HIRE, etc
verbose optional true return full list of attributes
updated optional 1333112400 only return objects with changes after given unix timestamp

Examples

Default http://druidry.com/v1/attribute/category/api_key/515bccdcd199f6243f000000
Verbose http://druidry.com/v1/attribute/category/verbose/true/api_key/515bccdcd199f6243f000000

Full Attribute List

http://druidry.com/v1/attribute/list

HTTP Method GET
Authentication API Key

Examples

Full Attribute List http://druidry.com/v1/attribute/list/api_key/515bccdcd199f6243f000000

Attribute Types

http://druidry.com/v1/attribute/types

HTTP Method GET
Authentication API Key

Examples

Attribute Types http://druidry.com/v1/attribute/types/api_key/515bccdcd199f6243f000000

Search Attributes

http://druidry.com/v1/attribute/search

HTTP Method GET
Authentication API Key

Parameters

type optional ACCREDITN, ACTIVITY, BED TYPE, ENTITY FAC... Attribute Types

Examples

Type AAACAT http://druidry.com/v1/attribute/search/api_key/515bccdcd199f6243f000000/type/AAACAT

User Login

http://druidry.com/v1/user/login

Return API Key

HTTP Method GET
Authentication USERNAME / PASSWORD
Response {
"api_key" : 4f98b39e6803fa4c64000001,
"uid" : 4f98b39e6803fa4c64000001
}

User Info

http://druidry.com/v1/user/info

HTTP Method GET
Authentication API Key

Change User Password

http://druidry.com/v1/user/info

HTTP Method PUT
Authentication API Key

Parameters

data required {"password": "new_password"} JSON object containing update details, this example changes the password

Examples

User Info http://druidry.com/v1/user/info?api_key=515bccdcd199f6243f000000

User Products

http://druidry.com/v1/user/products

HTTP Method GET
Authentication API Key
verbose optional true return product details

Examples

User Products http://druidry.com/v1/user/products?api_key=515bccdcd199f6243f000000

User Watchlist

http://druidry.com/v1/user/watchlist

HTTP Method GET
Authentication API Key

Examples

http://druidry.com/v1/user/watchlist?api_key=515bccdcd199f6243f000000

Add to Watchlist

http://druidry.com/v1/user/watchlist

HTTP Method POST
Authentication API Key

Parameters

id required true Product ID

Delete from Watchlist

http://druidry.com/v1/user/watchlist

HTTP Method DELETE
Authentication API Key

Parameters

id required true Product ID

List Facebook friends and their products

http://druidry.com/v1/social/friends

HTTP Method GET
Authentication API_KEY

Parameters

uid required 593535990 Facebook User ID
token required AAADMl2mgyTcBABnz2a8hIHtPI7d8S9sHdsxa7ukzh4w8RIaBYb93wTCIoARP9ZBvfHbT7kV6YoXMhY0ZC6FKvvE0oKqskTAj0t1YnowwZDZD Facebook Access Token
Response {
"uid" : 532855068,
"name" : "Rolf Chen",
"pic_square": "https:\/\/fbcdn-profile-a.akamaihd.net\/hprofile-ak-snc4\/572223_532855068_1406332448_q.jpg",
"products":[{
"update_ts": 1335725126,
"id": "4fc56d2a6803faa41a00285b"
}] }

Examples

iGrow Friends http://druidry.com/v1/social/friends/uid/593535990/token/AAROIJOILDSOIO

Login with Facebook

http://druidry.com/v1/social/login

Return API Key

Authenticate user with Facebook on device and pass in uid/token to get node API_KEY

HTTP Method GET
Authentication UID / TOKEN

Examples

User Info http://druidry.com/v1/user/fblogin/uid/593535990/token/=AAROIJOILDSOIO
Response {
"api_key" : 4f98b39e6803fa4c64000001,
"uid" : 4f98b39e6803fa4c64000001
}

Add Facebook User to Node Login

http://druidry.com/v1/social/login

Assign Facebook UID to node for login purpose

HTTP Method POST
Authentication HMAC

Parameters

uid required 593535990 Facebook User ID
Response { "status" : true/false }

Remove Facebook User from Node Login

http://druidry.com/v1/social/login

HTTP Method DELETE
Authentication HMAC

Parameters

uid required 593535990 Facebook User ID
Response { "status" : true/false }

Country

http://druidry.com/v1/geo/country

HTTP Method GET
Authentication API_KEY

Examples

http://druidry.com/v1/geo/country/api_key/515bccdcd199f6243f000000

State

http://druidry.com/v1/geo/state

HTTP Method GET
Authentication API_KEY

Examples

http://druidry.com/v1/geo/state/api_key/515bccdcd199f6243f000000

Region

http://druidry.com/v1/geo/region

HTTP Method GET
Authentication API_KEY

Parameters

org optional TQ, SATC, TVIC, etc Organisation ID

Examples

http://druidry.com/v1/geo/region/api_key/515bccdcd199f6243f000000

Area

http://druidry.com/v1/geo/area

HTTP Method GET
Authentication API_KEY

Examples

http://druidry.com/v1/geo/area/api_key/515bccdcd199f6243f000000

City

http://druidry.com/v1/geo/city

HTTP Method GET
Authentication API_KEY

Examples

http://druidry.com/v1/geo/city/api_key/515bccdcd199f6243f000000

Suburb

http://druidry.com/v1/geo/suburb

HTTP Method GET
Authentication API_KEY

Examples

http://druidry.com/v1/geo/suburb/api_key/515bccdcd199f6243f000000

-->