soncojmk / reachreact

reachREACT

Getting Started

Repo Hierarchy:

'Post': Event app, contains the main event model and views controlling the website 'account': Account app, contains the extended User model that handles user login/signup 'restapi': REST app, app where all models are converted to rest endpoints with GET/POST/DELETE ... endpoints. All rest endpoints end up here. 'blog': Stories app, 'mysite': main django project file

most of the other apps are external apps that I needed to make changes to. They really don't matter.

How to send Token: 
        Authorization: Token xxxxxxxxxxxxxx23 --> The 'xxxxxxxxxxxxxx23' is the user's actual token value. the 'Authorization' is the key and the 'Token xxxxxxxxxxxxxx23' is the value.   
                                              --> Swift Example 
                                              request.addValue("Token a9edb73eb1ecfa66b87037cbfeada07406749f96", forHTTPHeaderField: "Authorization")

API Endpoints
    Updating Profile:
        /api/account/<user_id>/update_profile/ --> (POST) send about or college(int) or avatar with auth token
        
    Login:
        /api-token-auth/ --> (POST) send username and password
                         --> Returns user token
    Sign Up:
       api/wp/auth/register/ --> (POST) send username, password, and email
                             --> returns HTTP 200 if successful.
                             --> You then need to ping the login api to get the new user's token
                             
    Posting a new Event/Moment:
        api/events/ (POST) --> post a new event (need to send token with request)
                           --> Send other variables (check api/events for variable types. They must match. The integers must be sent as Strings
        api/events/<event_id>/save/ (POST) --> save an event for requesting user (need to send token with request)
        api/events/<event_id>/people_saving (GET) --> returns a list of users who have saved a particular event
     
    
    My Profile Page:
        api/myrecommended --> Recommended people to follow (need to send token with request)
        api/myaccount --> The requesting users account info: email, token ... (need to send token with request)
        api/account/<user_id>/saved --> User's saved events based on their url
        api/account/<user_id>/posted --> User's posted events based on their url
        api/account/<user_id>/followers --> Get a user's followers list
        api/account/<user_id>/following --> Get a user's following list 
        api/account/<user_id>/requesting --> Get a list of users that are requesting to follow the current user (need to send token)
        api/account/<user_id>/requested --> Get a list of users the current user has requested to follow (need to send token with request)
    
    Following a user:
        api/account/<user_id>/follow  (POST) --> Follow a user (need to send token with request)
        api/account/<user_id>/follow (PUT) --> Accept a follow request (need to send token with request)
        api/account/<user_id>/follow (DELETE) --> Delete a follower or a follow request (need to send token with request)
        api/account/<user_id>/follow_status (GET) --> Check whether the requesting user is following the url user(need to send token with request)
                        --> Get back this object {
                                                  "following": "false",
                                                  "requested": "false",
                                                  "neither": "true"
                                                }
        
    Event Card:
        api/events/<event_id>/save (POST) --> Save an event (need to send token with request)
        api/events/<event_id>/save (DELETE) --> Unsave an event (need to send token with request)
        api/events/<event_id>/people_saving (GET) --> get a list of users saving an event
        
    Personal Event:  (just like normal events) --> just check is  'is_personal' field is true to determine if it's a personal event
       
        
    Notifications:
        api/devices (POST) --> Required Parameters:
                           --> registration_id (integer), active(boolean- should be set to true), type (android, ios, or web)
                           --> (need to send token with request)                   
                        
                    --> Add a user's registration_id to our database. Link a user to a device 
                    -->  Needed in order to allow device specific notifications on events like following, commenting...
                    
   Notification Feed:
       api/notificationfeed/ (GET) --> (need to send authorization token with request)
                                  --> outputs the actor, recipient, verb, and action_object of the notification
                                  --> Sort of like "Joe (actor) followed (Verb) Jake (recipient) 
                                  --> or "Jake (Actor) saved (verb) Jake's (recipient) event, the roast of time (action_object)
                                  
   Comments API:
       api/events/<event_id>/post_comment/ (POST) --> This is for posting a comment to an event
                                                  --> (need to send authorization token with request)
                                                  --> parameters -> [comment]
                                           (DELETE) --> To delete a comment from an event, grab the 'pk' from the comment object and 
                                                        send it as a parameter with a DELETE request to that particular <event'surl>/post_comment
       api/events/ (GET) --> comments now included in the event object with the comment author's account nested
                                 
  Searching for other users:
      api/accounts?search=<username or first name or last name> (GET) --> This will return a list of accounts that have that keyword
      
  
  

All other API endpoints that don't have any internal/hidden endpoints and are fairly straight forward to use are in the link below --> http://wpoppin.com/api/ (the links are pretty self explanatory)

CURL Commands for testing REST API (You have to have curl installed before hand - simplest way is to use pip)

curl -X POST -H "Content-Type: application/json" -H "Authorization: Token xxxxxxxxxxxxxx" -d '{"key1":"value1", "key2":"value2"}' http://www.wpoppin.com/api/devices/

The 'POST' can change depending on the type of request you want. i.e 'PUT', 'PATCH' ...

Reference https://gist.github.com/subfuzion/08c5d85437d5d4f00e58 for more curl commands