Parameters |
- access_token
- Required. This is the authentication token for the user that is creating the note.
- title
- At least one of
title or message is required. This is the title of the note. If no title is added, one will be created based on the 'message' contents.
- message
- At least one of
title or message is required. This is the main text of the note.
- visibility
- Required. One of
self , recipients , or public . If recipients , an additional parameter called recipients with an array of user IDs is expected.
- location
- Required. Location is a hash with the required fields
latitude and longitude with both in decimal degrees. In addition, location may accept an optional human-readable address (e.g., "1600 Pennsylvania Avenue, Washington, D.C., United States") and optional zoom_level that corresponds to Google Maps API zoom level and may be used in note presentation in certain contexts. Finally, a note may also be added to a place in one of two ways:
- To create a new brand new place (e.g., "my favorite couch"), simply add
name field to the location hash.
- To add a note to an existing place (e.g. "Golden Gate Bridge"), instead include an
id field with the place's ID as its value.
- tags
- Optional. This takes an array of strings, where each string is the tag name.
- image_file
- Optional. This is the content of the image file to upload. We support any JPEGs, PNGs, and GIFs up to 20 MBs.
|
Example Response |
{
"data": {
"author": {
"avatar": {
"hasAvatar": false,
"hash": "c35b4cf1ce6644ff4b2b26983677282c",
"urlRoot": "https://s3-us-west-1.amazonaws.com/avatars1.dev.findery.com/default/"
},
"id": 257699140080,
"link": "https://findery.com/MRMAN",
"name": null,
"username": "MRMAN"
},
"comments": {
"meta": {
"count": 0,
"nextUrl": "/v2/notes/932009001403/comments"
}
},
"createdAt": 1415156288,
"currentUserData": {
"canComment": true,
"canFavorite": true,
"isFavorited": false,
"isFound": false,
"isUnfound": false
},
"displayAddress": null,
"favoriters": {
"meta": {
"count": 0,
"nextUrl": "/v2/notes/932009001403/favoriters"
}
},
"finders": {
"meta": {
"count": 0,
"nextUrl": "/v2/notes/932009001403/finders"
}
},
"id": 932009001403,
"link": "https://findery.com/MRMAN/notes/testmessage234234-5",
"location": {
"city": "Coulterville",
"country": "United States",
"isoCountryCode": "US",
"latitude": 37.7,
"longitude": -120.1,
"neighborhood": null,
"postalCode": "95311",
"state": "California",
"street": "Ponderosa Way",
"streetAddress": "Stanislaus National Forest, 9416 Ponderosa Way, Coulterville, CA 95311, USA",
"streetNumber": "9416",
"zoomLevel": 13
},
"message": null,
"notemaps": {
"meta": {
"count": 0,
"nextUrl": "/v2/notes/932009001403/notemaps"
}
},
"tags": {
"meta": {
"count": 0,
"nextUrl": "/v2/notes/932009001403/tags"
}
},
"title": "testmessage234234",
"updatedAt": 1415156288,
"visibility": "public"
},
"meta": {
"http_status": 201
}
}
|