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).