Giới thiệu

1App.vn Open API

1App.vn provides tokens to synchronize data between the services of 1App.vn and other systems.

Steps to get tokens

Created app

1. Click link following to create the app: https://open.1app.vn/app/list

2. Click button add app.

• App name: Your app name.

• Return data url: Url receives the returned data after synchronization: order, product, customer,...

• Verified key: Your security key, which will be returned with the returned Url, used for verifying the returned data

Get accessCode

1. Redirect link to 1app.

• https://open.1app.vn/oauth?appId={YOUR_APPID}&redirectLink={YOUR_REDIRECT_LINK}&businessId={YOUR_BUSINESSID}

Param	Data Type	Mandatory	Description
appId	int	Yes	Your app id
redirectLink	string	Yes	The link receives the accessCode returned
businessId	int	No	If you have many businesses, and want each business to have a different token

Get accessToken

Request

• Url request: https://open.1app.vn/oauth/access_token

• RESTful applications use HTTP requests to post data. The POST params include:

Param	Data Type	Mandatory	Description
appId	int	Yes	Your app id
secretKey	string(64)	Yes	Your app secret key
accessCode	string(64)	Yes	Your app access code

Response

  {
    "code": 1, // 1 = success, 0 = failed (see errors in messages)
    "messages": { // if the code = 0 the server will return error messages
        "error code": "message 1"
    },
    "accessToken": accessToken
  }

Code Sample

• Simple request: send product information

<?php

    $appId = "_YOUR_APPID_";
    $secretKey = "_YOUR_SECRET_KEY_";
    $accessCode = "_YOUR_ACCESS_CODE_";

    $postArray = array(
        "appId" => $appId,
        "secretKey" => $secretKey,
        "accessCode" => $accessCode
    );

    $curl = curl_init("https://open.1app.vn/oauth/access_token");
    curl_setopt($curl, CURLOPT_POST, 1);
    curl_setopt($curl, CURLOPT_POSTFIELDS, $postArray);
    curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);

    $curlResult = curl_exec($curl);

    if(! curl_error($curl)) {
        // success
        $response = json_decode($curlResult);
    } else {
        // failed, cannot connect nhanh.vn
        $response = new stdClass();
        $response->code = 0;
        $response->message = curl_error($curl);
    }
    curl_close($curl);

    if ($response->code == 1) {
        // get access token successfully
        echo $response->accessToken;
    } else {
        // failed, show error messages
        echo $response->message;
    }