dripisforever/api-documentation

api-documentation

Views API

Making a request

All URLs start with http://api.views.ly/v1/. The path is prefixed with the account ID, but no /api/v1 API prefix. Also, note the different domain!

curl -H "Authorization: Token $ACCESS_TOKEN" -H 'User-Agent: MyApp (yourname@example.com)' https://3.basecampapi.com/999999999/projects.json

To search users, it's the same idea, but you also have to include the Content-Type header and the JSON data:

curl -H "Authorization: Token $ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  -H 'User-Agent: MyApp (yourname@example.com)' \
  -d '{ "name": "My new project!" }' \
  https://api.views.ly/v1/users/search?q=salam

Throughout the Basecamp 3 API docs, we include "Copy as cURL" examples. To try the examples in your shell, copy your OAuth 2.0 access token into your clipboard and run:

export ACCESS_TOKEN=PASTE_ACCESS_TOKEN_HERE
export ACCOUNT_ID=999999999

Then you should be able to copy/paste any example from the docs. After pasting a cURL example, you can pipe it to a JSON pretty printer to make it more readable. Try jsonpp or json_pp on OSX:

curl -s -H "Authorization: Token $ACCESS_TOKEN" https://3.basecampapi.com/999999999/projects.json | json_pp

API endpoints

• Comments
• Follow Suggestions
• Followers
• Following
• Likers
• Likes
• Locations
• Notification counts
• Notifications
• Posts
• Public Profiles
• Relationships
• Search
• Users
• Schedule entries
• Schedules
• Templates
• To-do lists
• To-dos
• To-do sets
• Uploads
• Vaults
• Webhooks

License

These API docs are licensed under Creative Commons (CC BY-SA 4.0). Please share, remix, and distribute as you see fit.