Skip to content

Latest commit

 

History

History
209 lines (150 loc) · 4.82 KB

README.md

File metadata and controls

209 lines (150 loc) · 4.82 KB
Raw

Welcome to the AWS CodeStar sample web service

This sample code helps get you started with a simple Express web service deployed by AWS CloudFormation to AWS Lambda and Amazon API Gateway.

What's Here

This sample includes:

  • README.md - this file
  • buildspec.yml - this file is used by AWS CodeBuild to package your service for deployment to AWS Lambda
  • app.js - this file contains the sample Node.js code for the web service
  • index.js - this file contains the AWS Lambda handler code
  • template.yml - this file contains the AWS Serverless Application Model (AWS SAM) used by AWS CloudFormation to deploy your service to AWS Lambda and Amazon API Gateway.
  • tests/ - this directory contains unit tests for your application

What Do I Do Next?

If you have checked out a local copy of your repository you can start making changes to the sample code. We suggest making a small change to app.js first, so you can see how changes pushed to your project's repository are automatically picked up by your project pipeline and deployed to AWS Lambda and Amazon API Gateway. (You can watch the pipeline progress on your AWS CodeStar project dashboard.) Once you've seen how that works, start developing your own code, and have fun!

To run your tests locally, go to the root directory of the sample code and run the npm test command, which AWS CodeBuild also runs through your buildspec.yml file.

To test your new code during the release process, modify the existing tests or add tests to the tests directory. AWS CodeBuild will run the tests during the build stage of your project pipeline. You can find the test results in the AWS CodeBuild console.

Learn more about AWS CodeBuild and how it builds and tests your application here: https://docs.aws.amazon.com/codebuild/latest/userguide/concepts.html

Learn more about AWS Serverless Application Model (AWS SAM) and how it works here: https://github.com/awslabs/serverless-application-model/blob/master/HOWTO.md

AWS Lambda Developer Guide: http://docs.aws.amazon.com/lambda/latest/dg/deploying-lambda-apps.html

Learn more about AWS CodeStar by reading the user guide, and post questions and comments about AWS CodeStar on our forum.

User Guide: http://docs.aws.amazon.com/codestar/latest/userguide/welcome.html

Forum: https://forums.aws.amazon.com/forum.jspa?forumID=248

What Should I Do Before Running My Project in Production?

AWS recommends you review the security best practices recommended by the framework author of your selected sample application before running it in production. You should also regularly review and apply any available patches or associated security advisories for dependencies used within your application.

Best Practices: https://docs.aws.amazon.com/codestar/latest/userguide/best-practices.html?icmpid=docs_acs_rm_sec

REST-API

common IDs:

  • eventid : nnnnn (unique) - GUID
  • nfctagid : nnnnnnnn (for Event) (unique)
  • userid : xxxxx (unique) - GUID generated by smartphone -> + SALT

create UserID

/create-user

CREATE - Request

action

Gernerate userid - GUID based on smartphone + salt (for security purposes) and save it in an clientcookie

Response

{
userid : "12242354"
}

Create Event

used IDs:

  • userid
  • eventid

titel (unique)

/create-event

CREATE - Request
{
userid : "12242354"
(optional) nfctagid : "13123123123"
title : "Mittagessen"
}

action

Generate an unique EventID + URL or when given conet ist to an NFC-TagID and put it into DB

Response

{
eventid : "1231231233"
}

Subscribe Event

used IDs:

  • userid
  • eventid

/subscribe-event

POST - Request
{
userid : "12242354"
eventid : "1231231233"
}

Response

Call Event

used IDs:

  • userids
  • eventid

/call_event

POST - Request
{
eventid : "1231231233"
}

action

Send a notification to all userids stored in DB beloning to the eventid

Response

Edit Event

used IDs:

  • userid
  • eventid

/call-event

POST - Request
{
userid : "12242354"
eventid : "1231231233"
(optional) new_nfctagid : "13123123123"
(optional) new_titel : "Mittagessen AI2015"
}

action

Change title or nfctagid of an event (save in DB)

Response

List allEvents

used IDs:

none

/list-events

GET - Request

action

List all events saved in DB - title / userid

params

  • userid – filter events by userid

Response

{ 
    "Events": [
        {
            "EventId" : "01d06f62-edd6-4c0e-933b-477cdec96aae",  
            "Title" : "Mittagessen"  
        },
        {
            "EventId" : "b5314183-25ae-46ee-954d-426f4cf8c7bd",  
            "Title" : "Frühstück"  
        }
    ]
}