Create data source

curl --request POST \
  --url https://apiweb.mile.app/api/v3/data \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "dataId": "OutletAdi",
  "dataTypeId": "63f854cff2bd7b342a098962",
  "hubId": "63c63ab1b6972d3150348172",
  "outletName": "Cabang Jakarta Pusat",
  "outletHours": 12,
  "outletType": "minimarket",
  "outletOpen": "09:00",
  "outletClose": "17:00",
  "outletContractExpired": "2023-02-02",
  "outletOpenInWeekend": true,
  "outletGeolocation": "-6.171702325136309,106.81775093078615",
  "outletPhoneNumber": "+62 123 456 789",
  "outletCloseOrder": "2023-02-02 17:00:00"
}
'

import requests

url = "https://apiweb.mile.app/api/v3/data"

payload = {
    "dataId": "OutletAdi",
    "dataTypeId": "63f854cff2bd7b342a098962",
    "hubId": "63c63ab1b6972d3150348172",
    "outletName": "Cabang Jakarta Pusat",
    "outletHours": 12,
    "outletType": "minimarket",
    "outletOpen": "09:00",
    "outletClose": "17:00",
    "outletContractExpired": "2023-02-02",
    "outletOpenInWeekend": True,
    "outletGeolocation": "-6.171702325136309,106.81775093078615",
    "outletPhoneNumber": "+62 123 456 789",
    "outletCloseOrder": "2023-02-02 17:00:00"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    dataId: 'OutletAdi',
    dataTypeId: '63f854cff2bd7b342a098962',
    hubId: '63c63ab1b6972d3150348172',
    outletName: 'Cabang Jakarta Pusat',
    outletHours: 12,
    outletType: 'minimarket',
    outletOpen: '09:00',
    outletClose: '17:00',
    outletContractExpired: '2023-02-02',
    outletOpenInWeekend: true,
    outletGeolocation: '-6.171702325136309,106.81775093078615',
    outletPhoneNumber: '+62 123 456 789',
    outletCloseOrder: '2023-02-02 17:00:00'
  })
};

fetch('https://apiweb.mile.app/api/v3/data', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://apiweb.mile.app/api/v3/data",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'dataId' => 'OutletAdi',
    'dataTypeId' => '63f854cff2bd7b342a098962',
    'hubId' => '63c63ab1b6972d3150348172',
    'outletName' => 'Cabang Jakarta Pusat',
    'outletHours' => 12,
    'outletType' => 'minimarket',
    'outletOpen' => '09:00',
    'outletClose' => '17:00',
    'outletContractExpired' => '2023-02-02',
    'outletOpenInWeekend' => true,
    'outletGeolocation' => '-6.171702325136309,106.81775093078615',
    'outletPhoneNumber' => '+62 123 456 789',
    'outletCloseOrder' => '2023-02-02 17:00:00'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://apiweb.mile.app/api/v3/data"

	payload := strings.NewReader("{\n  \"dataId\": \"OutletAdi\",\n  \"dataTypeId\": \"63f854cff2bd7b342a098962\",\n  \"hubId\": \"63c63ab1b6972d3150348172\",\n  \"outletName\": \"Cabang Jakarta Pusat\",\n  \"outletHours\": 12,\n  \"outletType\": \"minimarket\",\n  \"outletOpen\": \"09:00\",\n  \"outletClose\": \"17:00\",\n  \"outletContractExpired\": \"2023-02-02\",\n  \"outletOpenInWeekend\": true,\n  \"outletGeolocation\": \"-6.171702325136309,106.81775093078615\",\n  \"outletPhoneNumber\": \"+62 123 456 789\",\n  \"outletCloseOrder\": \"2023-02-02 17:00:00\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://apiweb.mile.app/api/v3/data")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"dataId\": \"OutletAdi\",\n  \"dataTypeId\": \"63f854cff2bd7b342a098962\",\n  \"hubId\": \"63c63ab1b6972d3150348172\",\n  \"outletName\": \"Cabang Jakarta Pusat\",\n  \"outletHours\": 12,\n  \"outletType\": \"minimarket\",\n  \"outletOpen\": \"09:00\",\n  \"outletClose\": \"17:00\",\n  \"outletContractExpired\": \"2023-02-02\",\n  \"outletOpenInWeekend\": true,\n  \"outletGeolocation\": \"-6.171702325136309,106.81775093078615\",\n  \"outletPhoneNumber\": \"+62 123 456 789\",\n  \"outletCloseOrder\": \"2023-02-02 17:00:00\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://apiweb.mile.app/api/v3/data")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"dataId\": \"OutletAdi\",\n  \"dataTypeId\": \"63f854cff2bd7b342a098962\",\n  \"hubId\": \"63c63ab1b6972d3150348172\",\n  \"outletName\": \"Cabang Jakarta Pusat\",\n  \"outletHours\": 12,\n  \"outletType\": \"minimarket\",\n  \"outletOpen\": \"09:00\",\n  \"outletClose\": \"17:00\",\n  \"outletContractExpired\": \"2023-02-02\",\n  \"outletOpenInWeekend\": true,\n  \"outletGeolocation\": \"-6.171702325136309,106.81775093078615\",\n  \"outletPhoneNumber\": \"+62 123 456 789\",\n  \"outletCloseOrder\": \"2023-02-02 17:00:00\"\n}"

response = http.request(request)
puts response.read_body

{
  "status": true,
  "message": "Success",
  "data": {
    "dataId": "Outlet",
    "dataTypeId": "63db2fb476bc679c540369c4",
    "outletName": "Cabang Jakarta Pusat",
    "outletHours": 12,
    "outletType": "minimarket",
    "outletOpen": "09:00",
    "outletClosed": "17:00",
    "outletContractExpired": "2023-02-02",
    "outletOpenInWeekend": true,
    "outletGeolocation": "-6.171702325136309,106.81775093078615",
    "outletPhoneNumber": "+62 123 456 789",
    "outletCloseOrder": "2023-02-02 17:00:00",
    "data_type": {
      "_id": "63db2fb476bc679c540369c4",
      "name": "outlets"
    },
    "hubId": "63c63ab1b6972d3150348172",
    "organizationId": "63c61d865347e356d05e3052",
    "createdBy": "john.doe@mile.app",
    "updatedTime": "2023-02-03 01:32:11",
    "createdTime": "2023-02-03 01:32:11"
  }
}

{
  "status": false,
  "message": "Bad request - invalid parameters provided."
}

{
  "status": false,
  "message": "Internal server error, please contact support@mile.app."
}

Data Source

Create data source

When creating a new datasource, the payload includes dynamic keys whose structure is determined by the data type specified by dataTypeId. To understand which fields are required and their respective types, you must first retrieve the schema of the data type from the endpoint GET /data-type/. The response from this endpoint defines the additional dynamic keys needed in the payload beyond the standard fields such as dataId, dataTypeId, and hubId.

For example, if the dataTypeId refers to an outlet or store, the /data-type/ endpoint might return a schema that specifies keys like outletName, outletHours, outletType, etc. These fields and their types (string, integer, boolean, etc.) must be included in the request payload when creating the datasource.

POST

data

Create data source

curl --request POST \
  --url https://apiweb.mile.app/api/v3/data \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "dataId": "OutletAdi",
  "dataTypeId": "63f854cff2bd7b342a098962",
  "hubId": "63c63ab1b6972d3150348172",
  "outletName": "Cabang Jakarta Pusat",
  "outletHours": 12,
  "outletType": "minimarket",
  "outletOpen": "09:00",
  "outletClose": "17:00",
  "outletContractExpired": "2023-02-02",
  "outletOpenInWeekend": true,
  "outletGeolocation": "-6.171702325136309,106.81775093078615",
  "outletPhoneNumber": "+62 123 456 789",
  "outletCloseOrder": "2023-02-02 17:00:00"
}
'

import requests

url = "https://apiweb.mile.app/api/v3/data"

payload = {
    "dataId": "OutletAdi",
    "dataTypeId": "63f854cff2bd7b342a098962",
    "hubId": "63c63ab1b6972d3150348172",
    "outletName": "Cabang Jakarta Pusat",
    "outletHours": 12,
    "outletType": "minimarket",
    "outletOpen": "09:00",
    "outletClose": "17:00",
    "outletContractExpired": "2023-02-02",
    "outletOpenInWeekend": True,
    "outletGeolocation": "-6.171702325136309,106.81775093078615",
    "outletPhoneNumber": "+62 123 456 789",
    "outletCloseOrder": "2023-02-02 17:00:00"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    dataId: 'OutletAdi',
    dataTypeId: '63f854cff2bd7b342a098962',
    hubId: '63c63ab1b6972d3150348172',
    outletName: 'Cabang Jakarta Pusat',
    outletHours: 12,
    outletType: 'minimarket',
    outletOpen: '09:00',
    outletClose: '17:00',
    outletContractExpired: '2023-02-02',
    outletOpenInWeekend: true,
    outletGeolocation: '-6.171702325136309,106.81775093078615',
    outletPhoneNumber: '+62 123 456 789',
    outletCloseOrder: '2023-02-02 17:00:00'
  })
};

fetch('https://apiweb.mile.app/api/v3/data', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://apiweb.mile.app/api/v3/data",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'dataId' => 'OutletAdi',
    'dataTypeId' => '63f854cff2bd7b342a098962',
    'hubId' => '63c63ab1b6972d3150348172',
    'outletName' => 'Cabang Jakarta Pusat',
    'outletHours' => 12,
    'outletType' => 'minimarket',
    'outletOpen' => '09:00',
    'outletClose' => '17:00',
    'outletContractExpired' => '2023-02-02',
    'outletOpenInWeekend' => true,
    'outletGeolocation' => '-6.171702325136309,106.81775093078615',
    'outletPhoneNumber' => '+62 123 456 789',
    'outletCloseOrder' => '2023-02-02 17:00:00'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://apiweb.mile.app/api/v3/data"

	payload := strings.NewReader("{\n  \"dataId\": \"OutletAdi\",\n  \"dataTypeId\": \"63f854cff2bd7b342a098962\",\n  \"hubId\": \"63c63ab1b6972d3150348172\",\n  \"outletName\": \"Cabang Jakarta Pusat\",\n  \"outletHours\": 12,\n  \"outletType\": \"minimarket\",\n  \"outletOpen\": \"09:00\",\n  \"outletClose\": \"17:00\",\n  \"outletContractExpired\": \"2023-02-02\",\n  \"outletOpenInWeekend\": true,\n  \"outletGeolocation\": \"-6.171702325136309,106.81775093078615\",\n  \"outletPhoneNumber\": \"+62 123 456 789\",\n  \"outletCloseOrder\": \"2023-02-02 17:00:00\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://apiweb.mile.app/api/v3/data")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"dataId\": \"OutletAdi\",\n  \"dataTypeId\": \"63f854cff2bd7b342a098962\",\n  \"hubId\": \"63c63ab1b6972d3150348172\",\n  \"outletName\": \"Cabang Jakarta Pusat\",\n  \"outletHours\": 12,\n  \"outletType\": \"minimarket\",\n  \"outletOpen\": \"09:00\",\n  \"outletClose\": \"17:00\",\n  \"outletContractExpired\": \"2023-02-02\",\n  \"outletOpenInWeekend\": true,\n  \"outletGeolocation\": \"-6.171702325136309,106.81775093078615\",\n  \"outletPhoneNumber\": \"+62 123 456 789\",\n  \"outletCloseOrder\": \"2023-02-02 17:00:00\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://apiweb.mile.app/api/v3/data")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"dataId\": \"OutletAdi\",\n  \"dataTypeId\": \"63f854cff2bd7b342a098962\",\n  \"hubId\": \"63c63ab1b6972d3150348172\",\n  \"outletName\": \"Cabang Jakarta Pusat\",\n  \"outletHours\": 12,\n  \"outletType\": \"minimarket\",\n  \"outletOpen\": \"09:00\",\n  \"outletClose\": \"17:00\",\n  \"outletContractExpired\": \"2023-02-02\",\n  \"outletOpenInWeekend\": true,\n  \"outletGeolocation\": \"-6.171702325136309,106.81775093078615\",\n  \"outletPhoneNumber\": \"+62 123 456 789\",\n  \"outletCloseOrder\": \"2023-02-02 17:00:00\"\n}"

response = http.request(request)
puts response.read_body

{
  "status": true,
  "message": "Success",
  "data": {
    "dataId": "Outlet",
    "dataTypeId": "63db2fb476bc679c540369c4",
    "outletName": "Cabang Jakarta Pusat",
    "outletHours": 12,
    "outletType": "minimarket",
    "outletOpen": "09:00",
    "outletClosed": "17:00",
    "outletContractExpired": "2023-02-02",
    "outletOpenInWeekend": true,
    "outletGeolocation": "-6.171702325136309,106.81775093078615",
    "outletPhoneNumber": "+62 123 456 789",
    "outletCloseOrder": "2023-02-02 17:00:00",
    "data_type": {
      "_id": "63db2fb476bc679c540369c4",
      "name": "outlets"
    },
    "hubId": "63c63ab1b6972d3150348172",
    "organizationId": "63c61d865347e356d05e3052",
    "createdBy": "john.doe@mile.app",
    "updatedTime": "2023-02-03 01:32:11",
    "createdTime": "2023-02-03 01:32:11"
  }
}

{
  "status": false,
  "message": "Bad request - invalid parameters provided."
}

{
  "status": false,
  "message": "Internal server error, please contact support@mile.app."
}

Authorizations

Authorization

string

header

required

Use a valid Bearer token to authenticate.

Body

application/json

dataId

string

required

The identifier of fields from data type. Example: Outlet

dataTypeId

string

required

The identifier of data type. Use GET /data-types API to get the list of Data Type IDs. Example: 63db2fb476bc679c540369c4

hubId

string

required

Fundamental entity within an organization, serving as the central point for managing various operational components. Use GET /hubs endpoint to get the list of Hub IDs. Example: 634e98498ce07d29474a7e29

outletName

string

The dynamic field, outlet name. Use GET /data-types API to get detail fields of data source. Example: Cabang Jakarta Pusat

outletHours

integer

The dynamic field, outlet hours. Use GET /data-types API to get detail fields of data source. Example: 12

outletType

string

The dynamic field, outlet type. Use GET /data-types API to get detail fields of data source. Example: minimarket

outletOpen

string

The dynamic field, outlet open. Use GET /data-types API to get detail fields of data source. Example: 09:00

outletClosed

string

The dynamic field, outlet closed. Use GET /data-types API to get detail fields of data source. Example: 17:00

outletContractExpired

string

The dynamic field, outlet contract expired. Use GET /data-types API to get detail fields of data source. Example: 2023-02-02

outletOpenInWeekend

boolean

The dynamic field, outlet open in weekend. Use GET /data-types API to get detail fields of data source. Example: true

outletGeolocation

string

The dynamic field, outlet geolocation. Use GET /data-types API to get detail fields of data source. Example: -6.171702325136309,106.81775093078615

Response

Success

status

boolean

Status of response.

message

string

Message of API response.

data

object

Detail of object data source.

Read data source Read data source by ID

Getting Started

Tools

Webhook

Task

Routing

Flow

Workflow

Data

Setting

Import/Export

File

Auth

Objects

Create data source

Authorizations

Body

Response