วิธีการรับ API Key & Key Secret?

ก่อนที่คุณจะเริ่มต้นด้วยการใช้บริการ REST API ของเราคุณจะต้องขอรับรหัส API ภายใต้บัญชีผู้ใช้ของคุณเอง

  1. เข้าสู่ระบบบัญชี ETrackings ของคุณ หากคุณยังไม่มี สมัคร - ฟรี
  2. ไปที่หน้า จัดการ > แอปพลิเคชัน



ตัวอย่าง Curl สำหรับ ETrackings API ของ เคอรี่ เอ็กซ์เพรส แบบใช้ /find
curl --location --request POST 'https://fast.etrackings.com/api/v3/tracks/find'  --header 'Etrackings-api-key: <YOUR_API_KEY>'  --header 'Etrackings-key-secret: <YOUR_KEY_SECRET>'  --header 'Accept-Language: th'  --header 'Content-Type: application/json'  --data-raw '{ "courier": "kerry-express", "trackingNo": "SHP5040314158" }'



API endpoint

endpoints ทั้งหมดสามารถเข้าถึงได้ผ่านทางเท่านั้น https ผ่าน URL fast.etrackings.com

https://fast.etrackings.com/api/v3



Headers

การเรียก API ทั้งหมดต้องส่ง Headers นี้เพื่อตรวจสอบการใช้งาน ETrackings API

แทนที่ YOUR_API_KEY และ YOUR_KEY_SECRET ของคุณ ด้วยรหัสของคุณเอง.

Etrackings-Api-Key: YOUR_API_KEY
Etrackings-Key-Secret: YOUR_KEY_SECRET
Accept-Language: YOUR_LANGUAGE (TH | EN)
Content-Type: application/json



Body

คำขอและการตอบกลับทั้งหมดอยู่ในรูปแบบของ JSON




META

meta key ใช้เพื่อสื่อสารข้อมูลเพิ่มเติมเกี่ยวกับการตอบสนองต่อนักพัฒนา หากทุกอย่างเป็นไปด้วยดีคุณจะเห็นรหัสคีย์ที่มีค่า 200 อย่างไรก็ตามบางครั้งสิ่งผิดปกติและในกรณีนี้คุณอาจเห็นการตอบสนองเช่น

{
  "meta": {
    "code": 401,
    "message": "Invalid API key or Key secret."
  }
}



DATA

Data คือข้อมูลเนื้อของการตอบสนอง อาจเป็นรายการผลลัพธ์ แต่วิธีใดก็ตามที่คุณจะพบข้อมูลที่คุณร้องขอ

นี่คือตัวอย่างสำหรับ POST /kerry_express

{
  "meta": {
    "code": 200,
    "message": "OK"
  },
  "data": {
    "trackingNo": "SHP5054369172",
    "courier": "เคอรี่ เอ็กซ์เพรส",
    "courierKey": "kerry-express",
    "color": "#FB8523",
    "status": "ON_DELIVERED",
    "currentStatus": "13:59 เคอรี่จัดส่งพัสดุของคุณเรียบร้อยแล้ว - คานหาม, พระนครศรีอยุธยา",
    "detail": {
      "sender": "ETrackings****",
      "recipient": "สหรัก ม******",
      "qty": 0,
      "address": "",
      "originCity": "",
      "originProvince": "นนทบุรี",
      "originCountry": "",
      "destinationCity": "",
      "destinationProvince": "พระนครศรีอยุธยา",
      "destinationCountry": "",
      "signer": "สหรัก ม******",
      "signerImageURL": "",
      "weight": 0,
      "shippingService": "",
      "returnShippingService": "",
      "deliveryType": "Normal",
      "packaging": "",
      "senderPhoneNumber": "",
      "recipientPhoneNumber": "",
      "sendDate": "",
      "dueDate": "2021-02-10",
      "cashOnDelivery": "0",
      "isPayCashOnDelivery": false,
      "deliveryStaffName": "",
      "deliveryStaffPhoneNumber": "",
      "deliveryStaffBranchPhoneNumber": "",
      "senderCompany": "",
      "senderAddress": "",
      "recipientCompany": "",
      "recipientAddress": "",
      "courierTrackingNumber": "",
      "courierPartner": ""
    },
    "shareLink": "https://apps.etrackings.com/share?track=Y291cmllcj1rZXJyeS1leHByZXNzJnRyYWNraW5nLW5vPVNIUDUwNTQzNjkxNzImZW1haWw9",
    "timelines": [
      {
        "date": "2021-02-10",
        "details": [
          {
            "dateTime": "2021-02-10T13:59:56+07:00",
            "date": "2021-02-10",
            "time": "13:59",
            "status": "ON_DELIVERED",
            "description": "13:59 เคอรี่จัดส่งพัสดุของคุณเรียบร้อยแล้ว - คานหาม, พระนครศรีอยุธยา"
          },
          {
            "dateTime": "2021-02-10T08:57:06+07:00",
            "date": "2021-02-10",
            "time": "08:57",
            "status": "ON_SHIPPING",
            "description": "08:57 พนักงานกำลังจัดส่งพัสดุของคุณ - คานหาม, พระนครศรีอยุธยา"
          }
        ]
      },
      {
        "date": "2021-02-09",
        "details": [
          {
            "dateTime": "2021-02-09T08:10:59+07:00",
            "date": "2021-02-09",
            "time": "08:10",
            "status": "ON_OTHER_STATUS",
            "description": "08:10 พัสดุของคุณถึงสาขาปลายทางแล้ว เตรียมจัดส่ง - คานหาม, พระนครศรีอยุธยา"
          },
          {
            "dateTime": "2021-02-09T03:09:31+07:00",
            "date": "2021-02-09",
            "time": "03:09",
            "status": "ON_OTHER_STATUS",
            "description": "03:09 พัสดุของคุณอยู่ระหว่างขนส่ง - ตลิ่งชั่น, พระนครศรีอยุธยา"
          }
        ]
      },
      {
        "date": "2021-02-08",
        "details": [
          {
            "dateTime": "2021-02-08T22:03:55+07:00",
            "date": "2021-02-08",
            "time": "22:03",
            "status": "ON_OTHER_STATUS",
            "description": "22:03 พัสดุของคุณอยู่ระหว่างขนส่ง - ศูนย์คัดแยกสินค้าสมุทรสาคร, กรุงเทพมหานคร"
          },
          {
            "dateTime": "2021-02-08T13:35:59+07:00",
            "date": "2021-02-08",
            "time": "13:35",
            "status": "ON_PICKED_UP",
            "description": "13:35 เคอรี่เข้ารับพัสดุแล้ว"
          }
        ]
      }
    ]
  }
}