About sample test application

About sample test application

Contacts Application is a sample CRUD application. The application allows you to browse through a list of contacts, as well as add, update, and delete contacts.

In this cookbook, we will demonstrate, how you can validate this sample test application using vREST.

Useful links:

  1. Download the source code from Github.

  2. REST API specifications: Swagger File (TODO)

  3. Setup / install contacts application.

REST Endpoints:

The application has the following REST API endpoints:

Method

API Endpoint

Action

Method

API Endpoint

Action

GET

/contacts

Retrieve all contacts

GET

/contacts/{{id}}

Retrieve the contact with the specified id

POST

/contacts

Add a new contact

PUT

/contacts/{{id}}

Update the contact with the specified id

DELETE

/contacts/{{id}}

Delete the contact with the specified id

Versions:

The application has two versions.

  • Version 1.0.0: In this version, the contact model has the following schema with some validations. 

    { name: {type: String, required: true, maxLength: 35}, email: {type: String}, designation: {type: String, maxLength: 35}, organization: {type: String, maxLength: 35}, country: {type: String, maxLength: 35}, aboutMe: {type: String}, linkedInId: {type: String}, githubId: {type: String}, facebookId: {type: String}, twitterId: {type: String} }

    The version 1.0.0 of the Contacts Application can be accessed at the following URL:

    http://example.vrest.io/contacts/v1/test
     

  • Version 2.0.0: In this version, we added the following functional additions in the contact model of the application:

    • added a email validator for email field

    • aboutMe field can now be maximum 500 characters long only

    { name: {type: String, required: true, maxLength: 35}, email: {type: String, validator: emailValidator}, designation: {type: String, maxLength: 35}, organization: {type: String, maxLength: 35}, country: {type: String, maxLength: 35}, aboutMe: {type: String, maxLength: 500}, linkedInId: {type: String}, githubId: {type: String}, facebookId: {type: String}, twitterId: {type: String} }

    The version 2.0.0 of the Contacts Application can be accessed at the following URL:
    http://example.vrest.io/contacts/v2/test