สร้างโครงการ API

ไปที่หน้า โครงการของฉัน และเปิดแท็บ API คลิกที่ปุ่ม สร้าง API โครงการ

ขั้นตอนที่ 1: เลือก API ที่คุณต้องการรวมไว้ในโครงการของคุณ

ตรวจสอบโควตา API ขีดจำกัดอัตรา และรายละเอียดการตรวจสอบ API

ขั้นตอนที่ 2: กำหนดค่ารายละเอียดโครงการ

• ตั้งชื่อโครงการ โดยเป็นชื่อที่สามารถบ่งชี้ตัวตนได้และไม่ซ้ำกับชื่อโครงการอื่นขององค์กร
• เลือกประเทศที่คุณวางแผนจะจัดส่งไปเพื่อที่เราจะสามารถกำหนดบัญชีทดสอบให้คุณได้ เพื่อทดสอบการจัดส่งพัสดุภายในประเทศในสหภาพยุโรป คุณต้องดำเนินการทดสอบแยกเป็นแต่ละประเทศ โดยคุณสามารถเพิ่ม/ลบประเทศได้ในภายหลัง
• หากต้องการรับการแจ้งเตือนเกี่ยวกับการอัปเดต API ล่าสุดและข้อมูลที่เกี่ยวข้องกับการหยุดทำงาน โปรดตั้งค่าการแจ้งเตือนของคุณ

ขั้นตอนที่ 3: อ่านและยอมรับเงื่อนไขต่างๆ ซึ่งรวมถึงข้อตกลงการอนุญาตใช้สิทธิ์สำหรับ FedEx Developer Portal

เมื่อคุณยอมรับเงื่อนไขต่างๆ และคลิกปุ่มสร้างเรียบร้อยแล้ว คุณจะเห็นหน้าจอยืนยัน จากนั้น คุณจะสามารถดูข้อมูลประจำตัวสำหรับทดสอบภายในโครงการใหม่ของคุณได้

สร้างโครงการเว็บฮุค

สร้าง URL (การเรียกกลับ) ที่ถูกต้องในแอปพลิเคชันหรือแพลตฟอร์มปลายทางของคุณ

URL ปลายทางของคุณจะมีไว้เพื่อรับรหัสและข้อความรับรอง รวมถึงการแจ้งเตือนเว็บฮุคสถานะเพย์โหลดจาก FedEx URL ของคุณต้องใช้ HTTPS เพื่อรับประกันความปลอดภัย URL ของคุณจะถูกบล็อกหากประกอบด้วย:

• ที่อยู่ IP RFC1918
• fedex.com หรือโดเมนย่อยใดๆ
• ที่อยู่ IP ใน URL (รวมถึง localhost, 127.0.0.1)

สร้างโทเค็นรักษาความปลอดภัย

โทเค็นรักษาความปลอดภัยนี้สามารถใช้เป็นรหัสลับในการรับรองและตรวจสอบข้อมูลที่ส่งผ่านระหว่างองค์กรของคุณและ FedEx โทเค็นรักษาความปลอดภัยของคุณต้องประกอบด้วย:

• อักขระต่ำสุด 26 ตัวและสูงสุด 100 ตัว
• อักขระตัวพิมพ์ใหญ่ 1 ตัว
• อักขระตัวพิมพ์เล็ก 1 ตัว
• อักขระตัวเลข 1 ตัว

เช่น: Y1F6OiVUQW2JPSElmRE9U0IY5

หลังจากกำหนด URL และโทเค็นรักษาความปลอดภัยเรียบร้อยแล้ว คุณก็พร้อมที่จะสร้างโครงการเว็บฮุค ไปที่หน้า โครงการของฉัน และเปิดแท็บ เว็บฮุค คลิกที่ปุ่ม สร้างโครงการเว็บฮุค

เลือกประเภทการสมัครรับข้อมูล

ผู้ส่งกับ FedEx สามารถสมัครรับข้อมูลกิจกรรมสำหรับหมายเลขบัญชีหรือหมายเลขการติดตามได้

ขั้นตอนที่ 1: ยืนยันบัญชีการเรียกเก็บเงินและเลือกคุณสมบัติของคุณ

• ตรวจสอบบัญชีการเรียกเก็บเงินพื้นฐานที่กำหนดเพื่อยืนยันหรือเลือกบัญชีอื่นขององค์กรของคุณ
• กำหนดค่าโครงการของคุณโดยการเลือกคุณสมบัติ เช่น หลักฐานการส่งมอบ ตัวเลือกการจัดส่งโดยประมาณ การติดตามกิจกรรม และตัวกรองที่เกี่ยวกับกิจกรรม

ขั้นตอนที่ 2: ป้อนรายละเอียดโครงการ

• ตั้งชื่อโครงการ โดยเป็นชื่อที่สามารถบ่งชี้ตัวตนได้และไม่ซ้ำกับชื่อโครงการอื่นขององค์กร
• ป้อน URL ปลายทางและรายละเอียดโทเค็นรักษาความปลอดภัยที่คุณสร้างระหว่างการรับรองการตั้งค่าล่วงหน้า (ดูขั้นตอนจากด้านบน)
• หากต้องการรับการแจ้งเตือนเกี่ยวกับการอัปเดตเว็บฮุคล่าสุดและข้อมูลที่เกี่ยวข้องกับการหยุดทำงาน โปรดป้อนที่อยู่อีเมลและภาษาที่ต้องการ

ขั้นตอนที่ 3: อ่านและยอมรับเงื่อนไข

เมื่อคุณยอมรับเงื่อนไขต่างๆ รวมถึงข้อตกลงการอนุญาตใช้สิทธิ์สำหรับ FedEx Developer Portal คำสั่งการกำหนดราคา และคลิกปุ่มสร้างเรียบร้อยแล้ว คุณจะเห็นหน้าจอยืนยัน

อาจมีขั้นตอนเพิ่มเติมที่ต้องดำเนินการตามประเภทการสมัครรับข้อมูลที่เลือกไว้ โปรดไปที่ เอกสาร เพื่อเรียนรู้เพิ่มเติม

ที่หน้า ภาพรวมโครงการ API คุณสามารถรับข้อมูลประจำตัวสำหรับใช้งานจริง ได้แก่​​— รหัส API รหัสลับ และบัญชีการจัดส่ง — ได้จากแท็บ รหัสทดสอบ 

ขั้นตอนที่ 1: ร้องขอโทเค็นการเข้าถึง OAuth

จำเป็นต้องใช้โทเค็นการเข้าถึง OAuth ในการทำรายการ API แต่ละรายการ โทเค็นมีอายุการใช้งานเพียง 1 ชั่วโมง ดังนั้น คุณจำเป็นต้องเขียนรหัสด้วยโปรแกรมสำหรับแอปพลิเคชันของคุณเพื่อรีเฟรชโทเค็นก่อนที่เซสชันจะหมดอายุ หากต้องการรายละเอียดเพิ่มเติม โปรดดูที่ เอกสารการให้สิทธิ์อนุญาต API

ขั้นตอนที่ 2: ตรวจสอบเอกสาร API

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

ขั้นตอนที่ 3: ใช้แซนด์บ็อกซ์เพื่อทดสอบตัวอย่างการทำรายการ

คลิกที่ปลายทางที่ต้องการตรงการนำทางด้านซ้ายเพื่อไปยังแซนด์บ็อกซ์นั้นๆ ระบุคำขอตัวอย่างที่ตรงกับกรณีการใช้งานของคุณ จากนั้นใช้ข้อมูลประจำตัวสำหรับใช้งานจริงและ URL ทดสอบของ FedEx เพื่อดำเนินการเรียกใช้ไปยังปลายทางตามที่ระบุไว้ในคำขอตัวอย่าง ตรวจสอบว่าการตอบกลับการเรียกใช้ API ที่ได้รับนั้นตรงกับตัวอย่างที่แสดงในเอกสาร เรียนรู้เพิ่มเติมเกี่ยวกับประสบการณ์การทดสอบได้ใน คู่มือการจำลองเสมือนระบบแซนด์บ็อกซ์

การทดสอบกับเว็บฮุค

การทดสอบสามารถช่วยให้คุณเข้าใจได้ดีขึ้นว่า URL ที่คุณสร้างนั้นถูกต้องหรือไม่ และช่วยให้ FedEx สามารถระบุ URL ของคุณและสร้างการเชื่อมต่อกับ URL ของคุณเพื่อส่งข้อมูลได้ การทดสอบยังสามารถระบุตัวอย่างข้อมูลการทดสอบที่สามารถช่วยคุณตรวจสอบและยืนยันว่าคุณสามารถประมวลผลข้อมูลการติดตามที่ให้ไว้ในแอปพลิเคชันของคุณได้หรือไม่ อย่างไรก็ตาม การทดสอบไม่ใช่การรับรอง URL ของคุณ ไปที่ เอกสารเว็บฮุค ของเราเพื่อเรียนรู้วิธีทดสอบ URL ของเว็บฮุค

ไปที่หน้า ภาพรวมโครงการ และเปิดแท็บ รหัสสำหรับใช้งานจริง โครงการที่มีการสมัครรับข้อมูลการติดตามสถานะแบบรวมระบบขั้นสูงที่อิงจากหมายเลขบัญชี ไม่จำเป็นต้องย้ายไปสู่การใช้งานจริง

ขั้นตอนที่ 1: กำหนดค่าโครงการ

• สามารถเปลี่ยนชื่อรหัสของคุณได้ตามต้องการ
• ตรวจสอบหมายเลขบัญชีที่คุณเลือกในขั้นตอนที่ 1 ของขั้นตอนการสร้างโครงการ ซึ่งใช้เพื่อย้ายโครงการของคุณไปใช้งานในระบบจริง เมื่อโครงการของคุณอยู่ในระบบจริงแล้ว คุณสามารถเพิ่มบัญชีเพิ่มเติมได้ตามต้องการ

ขั้นตอนที่ 2: รับรหัสโครงการ

คัดลอกรหัส API และรหัสลับสำหรับใช้งานจริงไปเก็บไว้ในที่ปลอดภัย เพื่อให้รหัสลับสำหรับใช้งานจริงของคุณปลอดภัย เราจะแสดงรหัสครั้งเดียวเท่านั้น หากคุณลืมรหัสลับ คุณสามารถสร้างรหัสชุดใหม่ได้

หลังจากได้รหัสโครงการและคลิกที่ ถัดไป คุณจะเห็นรายละเอียดโครงการของคุณในแท็บ รหัสสำหรับใช้งานจริง

• หากต้องการเพิ่มบัญชีการจัดส่งไปยังโครงการของคุณ ให้คลิกที่ แก้ไข ด้านบนของตารางบัญชีการจัดส่ง

API บางส่วนต้องมีการตรวจสอบฉลากการจัดส่งเพื่อใช้ในระบบใช้งานจริงของเรา ตรวจสอบว่า API ของคุณจำเป็นต้องมีการตรวจสอบหรือไม่

ขั้นตอนที่ 1: พัฒนาและทดสอบ API ของ FedEx ด้วยแอปพลิเคชันที่ใช้งานบนเว็บของคุณ

เมื่อคุณพัฒนาแอปพลิเคชันที่ใช้งานบนเว็บเสร็จแล้ว ก็ถึงเวลาที่จะทำการทดสอบให้เสร็จสมบูรณ์โดยใช้ข้อมูลประจำตัวสำหรับทดสอบ (บัญชีการจัดส่งสำหรับทดสอบ รหัส API และรหัสลับ) รหัส API สำหรับทดสอบและรหัสลับของคุณจะปรากฏในหน้า ภาพรวมโครงการ ซึ่งสามารถดูได้ทุกเมื่อ

ขั้นตอนที่ 2: ย้ายโครงการของคุณให้ใช้งานในระบบจริง

หลังจากทดสอบกับ API ของ FedEx แล้ว คุณจะต้องเริ่มดำเนินกระบวนการตรวจสอบโดยการย้ายโครงการของคุณให้ใช้งานในระบบจริงบน FedEx Developer Portal เมื่อดำเนินการเรียบร้อยแล้ว คุณจะเห็นรหัส API สำหรับใช้งานจริงและรหัสลับของคุณ โดยที่คุณจะเห็นรหัสลับสำหรับใช้งานจริงเพียงครั้งเดียวเท่านั้น ทั้งนี้ คุณสามารถสร้างรหัสใหม่ได้ในภายหลัง

ขั้นตอนที่ 3: กรอกข้อมูลบนฉลากปะหน้า

กรอกข้อมูลบน ฉลากปะหน้า พร้อมข้อมูลการติดต่อที่เหมาะสมและบริการที่คุณวางแผนที่จะใช้ รวมถึงหมายเลขบัญชีและรหัสสำหรับใช้งานจริงของคุณ

ขั้นตอนที่ 4: สร้างฉลากทดสอบและส่งไปยังกลุ่มวิเคราะห์บาร์โค้ด

สร้างฉลากทดสอบในระบบทดสอบของ FedEx ที่เกี่ยวข้องกับแอปพลิเคชัน จากนั้น ส่งฉลากทดสอบไปยังทีมประเมินฉลากของ FedEx เพื่อขออนุมัติ กลุ่มวิเคราะห์บาร์โค้ดต้องใช้เวลาในการประเมินฉลากโดยมีช่วงเวลาแล้วเสร็จคือสามวันทำการ

ปฏิบัติตามแนวปฏิบัติที่ดีที่สุดเหล่านี้เพื่อหลีกเลี่ยงความล่าช้าในการประมวลผล:

• ต้องพิมพ์และสแกนฉลากที่ความละเอียดขั้นต่ำ 600 DPI ห้ามส่งไฟล์ที่สร้างโดย API
• สำหรับเครื่องพิมพ์ความร้อน จำเป็นต้องใช้ประเภทภาพฉลากตามด้วยรุ่นเครื่องพิมพ์ ตัวอย่าง: ZPLII สำหรับเครื่องพิมพ์ Zebra
• ให้ใช้ข้อมูลที่อยู่ของผู้จัดส่งและผู้รับเมื่อสร้างฉลากตัวอย่างสำหรับการประเมินผล โดยสร้างฉลากตัวอย่างสำหรับบริการเฉพาะที่ใช้งานเท่านั้น
• ฉลากเก็บเงินปลายทาง (C.O.D.) ของ FedEx® ต้องประกอบด้วยฉลากการส่งคืนของ C.O.D. ที่เกี่ยวข้อง
• การจัดส่งของ FedEx International Express® ต้องประกอบด้วยฉลากใบตราส่งสินค้าทางอากาศ (AWB) สำรอง/ลำดับรอง
• การจัดส่งพัสดุหลายชิ้น (MPS) ต้องประกอบด้วยหนึ่งฉลากต่อหนึ่งบรรจุภัณฑ์ในการจัดส่ง
• ส่ง PDF และฉลากปะหน้าผ่านทางอีเมลไปยัง label@fedex.com
• แผ่นฉลากอาจถูกส่งไปยังที่อยู่ตามด้านล่างนี้:

       บริการของ FedEx

       การทดสอบโซลูชันธุรกิจ WTC

       10 FedEx Parkway

       ชั้นที่ 2 ตามแนวนอน

       Collierville, TN 38017

หากฉลากแบบสแกนไม่มีข้อบกพร่องที่มองเห็นได้ชัดเจน (เช่น มีเส้นพาดผ่านแถบบาร์โค้ด มีหยดหมึก หรือมีความเสียหายทางกายภาพ) ฉลากนั้นอาจผ่านการตรวจสอบและได้รับการอนุมัติ


ในกรณีที่ส่งเป็นแผ่นฉลาก ควรให้ความสำคัญกับคุณภาพการพิมพ์และการย่อ/ขยายฉลากโดยไม่คาดคิด (เช่น การปรับขนาด) นี่คือสองเหตุผลแรกที่ว่าทำไมฉลากไม่ผ่านกระบวนการประเมินฉลาก

ขั้นตอนที่ 5: ตรวจสอบการประเมินฉลาก

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

ขั้นตอนที่ 6: เปิดใช้งานแอปพลิเคชัน

เมื่อกลุ่มวิเคราะห์บาร์โค้ดได้อนุมัติฉลากทดสอบสำหรับสถานะในระบบใช้งานจริงแล้ว ข้อมูลประจำตัวสำหรับใช้งานจริงของคุณจะได้รับอนุญาตให้สามารถส่งธุรกรรมของฉลากการจัดส่งที่ระบุ และพวกเขาจะแจ้งให้คุณทราบว่าการตรวจสอบเป็นผลสำเร็จผ่านทางอีเมล การอนุมัติของคุณนั้นขึ้นอยู่กับหลักเกณฑ์ของแต่ละโครงการ

ขั้นตอนที่ 7: แทนที่ URL และข้อมูลประจำตัว

ใช้ URL และข้อมูลประจำตัวสำหรับใช้งานจริงแทนที่ URL และข้อมูลประจำตัวสำหรับทดสอบ ทดสอบการใช้งานของคุณใหม่อีกครั้งในระบบใช้งานจริงโดยใช้ข้อมูลตัวอย่าง