For All Calls
Host URLs
All requests should be preceded by the appropriate URL:
Development sandbox:https://api-dev.knod.es/
Production:https://api.knod.es/
Authentication
See authentication.
Data Format
Requests should specify their data format in the url:
<request URL>.json
So, the full URL for users/connect in production would be:
http://api.knod.es/v1/users/connect.jsonCurrently, JSON is the only supported data type.
HTTP Status Codes
| Val | Desc |
|---|---|
| 200 | OK |
| 204 | No content – returned when attempting to search for user who has not yet been fully indexed |
| 400 | Bad request |
| 401 | Unauthorized – auth credentials missing or invalid |
| 403 | Forbidden |
Enums
Network Names
| Val | Desc |
|---|---|
| foursquare | Foursquare |
| Google (contacts only currently) | |
| contacts | Pseudo-network defined by user’s address book |
Relationships
| Val | Desc |
|---|---|
| friend | Meaning of friendship is network dependent: Facebook – person & user are friends Twitter – user follows person LinkedIn – person & user are contacts Foursquare – friends |
| follower | Person follows user |
Communication Channels
| Val | Desc |
|---|---|
| dm | Private, direct message (twitter only) |
| tweet | Public tweet (twitter only) |
| wall_post | Public post on wall |
Document Types
| Val | Desc |
|---|---|
| status | Status message |
| photo | Photo |
| video | Video |
| link | Link |
| comment | Comment |
| retweet | Retweet (twitter only) |
Dates
Dates are returned as 32-bit int values representing seconds since the epoch (January 1, 1970 UTC).