Turing Front-end

Welcome

Welcome to the Turing Challenge. Here you'll find some examples to reach your goal.

Swagger Documentation

https://backendapi.turing.com/docs

Root Endpoint

https://backendapi.turing.com

Images directory

https://backendapi.turing.com/images/products/

Example: https://backendapi.turing.com/images/products/wreath.gif

Authentication

Just some endpoint required Authentication, you can check it in the documentation. The Customer login provide the Token to use in the other endpoints that required it.

Token's example: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJjdXN0b21lcl9pZCI6MTIsIm5hbWUiOiJFZGVyIFRhdmVpcmEiLCJyb2xlIjoiY3VzdG9tZXIiLCJpYXQiOjE1NTA3ODYyMjAsImV4cCI6MTU1MDg3MjYyMH0.QEGdry367EQNxBqzuUDCGJscWkq8YQwJdGBgV3hztR0

The Token need to be in the header param "user-key". Let's see an example below.

Example Using login Authentication (jQuery):

$.ajax({ 
         url: "https://backendapi.turing.com/customer/login",
         data: {email: "CUSTOMER EMAIL", passsword: "CUSTOMER PASSWORD"},
         type: "POST",
         success: function(resp) { console.log(resp.responseText); },
         error: function(error) { console.log(error.responseText); }
});		

Response example:

{
  "user": {
    "customer_id": 12,
    "name": "Eder Taveira",
    "email": "challenge@turing.com",
    "address_1": "",
    "address_2": "",
    "city": "",
    "region": "",
    "postal_code": "",
    "shipping_region_id": null,
    "day_phone": null,
    "eve_phone": null,
    "mob_phone": null
  },
  "accessToken": "Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJjdXN0b21lcl9pZCI6MTIsIm5hbWUiOiJFZGVyIFRhdmVpcmEiLCJyb2xlIjoiY3VzdG9tZXIiLCJpYXQiOjE1NTA3ODYyMjAsImV4cCI6MTU1MDg3MjYyMH0.QEGdry367EQNxBqzuUDCGJscWkq8YQwJdGBgV3hztR0",
  "expires_in": "24h"
}

Example with header and token:

$.ajax({ 
         url: "https://backendapi.turing.com/customer",
         headers: { 'user-key': 'Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJjdXN0b21lcl9pZCI6MTIsIm5hbWUiOiJFZGVyIFRhdmVpcmEiLCJyb2xlIjoiY3VzdG9tZXIiLCJpYXQiOjE1NTA3ODYyMjAsImV4cCI6MTU1MDg3MjYyMH0.QEGdry367EQNxBqzuUDCGJscWkq8YQwJdGBgV3hztR0' },
         type: "GET",
         success: function(resp) { console.log(resp.responseText); },
         error: function(error) { console.log(error.responseText); }
});		

Pagination

All params of pagination are not required.

The pagination can to have the query params below:

• page - Number of page. Default is "1".
• limit - Number of limit por page. (Check the documentation to see what the default for each endpoint).

Examples:

• https://backendapi.turing.com/categories?page=1&limit=20
• https://backendapi.turing.com/products?page=1
• https://backendapi.turing.com/products?limit=30

Some endpoints (shoppingcart and products) have a no required param "description_length".

Return of list with pagination:

{
  "count": 40,
  "rows": [
    {
      "category_id": 1,
      "name": "French",
      "description": "The French have always had an eye for beauty. One look at the T-shirts below and you'll see that same appreciation has been applied abundantly to their postage stamps. Below are some of our most beautiful and colorful T-shirts, so browse away! And don't forget to go all the way to the bottom - you don't want to miss any of them!",
      "department_id": 1
    }
  ]
}

Order

To sort some lists use the no required param "order".

The format of param is as this REGEX: '/^([^\s]+),(DESC|ASC)$/'

Example:

• https://backendapi.turing.com/categories?order=name,DESC

Facebook Login

APP ID: 352854622106208

to test your application you can use ngrok, as in the example below:

• Create a account (https://ngrok.com/)
• terminal $ ./ngrok authtoken 2UfRLdXvX5exYu86bJDyu_5UmDhqR2adSoW3TPLaJ00
• terminal $ ./ngrok http 3000 (Place the port you are using)
• Test using https address generated.

Below you can see a simple example to do a login with facebook.

<fb:login-button scope="public_profile,email" onlogin="logInWithFacebook();"></fb:login-button>
  <div class="result"></div>
  <script src="https://ajax.googleapis.com/ajax/libs/jquery/3.3.1/jquery.min.js"></script>
  <script>
    logInWithFacebook = function () {
   
       FB.getLoginStatus(function (response) {
        if (response.authResponse) {
          $.post("https://backendapi.turing.com/customers/facebook", { access_token: response.authResponse.accessToken }, function (data) {
            $(".result").html(JSON.stringify(data));
          });
        } else {
          alert('User cancelled login or did not fully authorize.');
        }
      });
      return false;
    };
    window.fbAsyncInit = function () {
      FB.init({
        appId: '352854622106208',
        cookie: true,
        xfbml: true,
        version: 'v2.2'
      });
      FB.AppEvents.logPageView();
    };

    (function (d, s, id) {
      var js, fjs = d.getElementsByTagName(s)[0];
      if (d.getElementById(id)) { return; }
      js = d.createElement(s); js.id = id;
      js.src = "https://connect.facebook.net/en_US/sdk.js";
      fjs.parentNode.insertBefore(js, fjs);
    }(document, 'script', 'facebook-jssdk'));

  </script>

Stripe Itegration

Do as the example in this link using this stripe public key pk_test_NcwpaplBCuTL6I0THD44heRe

After that use the TOKEN created in the endpoint "https://backendapi.turing.com/stripe/charge".

Errors

The error response has the following structure:

• code - Error's Code.
• message - Error's Message.
• field - Error's Field.

Example of Error:

{"error":{"status":400,"code":"USR_05","message":"The email don't exists.","field":"email"}}