B2B Mobility Toll Transaction Data v1.0.0 | Panduan Permulaan Pantas

API Data Transaksi Tol Mobiliti B2B Shell - Panduan Permulaan CepatVersi API: 1.0.0 | Autentikasi: OAuth 2.0 | Status:Mendapatkan data transaksi tol mengikut nombor akaun

Menapis transaksi mengikut julat tarikh (tarikh dari dan ke)

Mencari mengikut status invois dan VRN (Nombor Pendaftaran Kenderaan)

Keupayaan penyusunan lanjutan pada pelbagai medan

Sokongan paginasi untuk set data besar

Maklumat tol menyeluruh termasuk titik masuk/keluar

Kebolehsesuaian yang tinggi untuk memadankan keperluan pengguna

Butiran tol menyeluruh termasuk titik masuk/keluar

Sokongan untuk pelbagai rangkaian dan pengendali tolPengesahanOAuth 2.0 (Kaedah Pengesahan Standard)API Data Transaksi Tol Shell menggunakan aliran Kredensial Klien OAuth 2.0 untuk pengesahan selamat.Aliran OAuth 2.0Langkah 1: Dapatkan Token AksesMinta token akses daripada titik akhir token OAuth:

POST /oauth/token
Content-Type: application/x-www-form-urlencoded

grant_type=client_credentials&client_id=your-client-id&client_secret=your-client-secret

Langkah 2: Gunakan Token Akses dalam Permintaan API

Authorization: Bearer Content-Type: application/json RequestId: eb621f45-a543-4d9a-a934-2f223b263c42" id="e" data-list-item-id="e" data-list-item-id="e" data-list-item-id="e" data-list-item-id="e" data-list-item-id="e" data-list-item-id="e" data-list-item-id="e" data-list-item-id="e" data-list-item-id="e" data-list-item-id="e" data-list-item-id="e" data-list-item-id="e" data-list-item-id="e" data-list-item-id="e" data-list-item-id="e" data-list-item-id="e" data-list-item-id="e" data-list-item-id="e" data-list-item-id="e" data-list-item-id="e" data-list-item-id="e" data-list-item-id="e" data-list-item-id="e" data-list-item-id="e" data-list-item-id="e" data-list-item-id="e" data-list-item-id="e" data-list-item-id="e" data-list-item-id="e" data-list-item-id="e" data-list-item-id="e" data-list-item-id="e" data-list-item-id="e" data-list-item-id="e" data-list-item-id="e" data-list-item-id="af5ec1dc7f39ee2114d41121aaf6be38">Token akses mempunyai jangka hayat terhad (biasanya 15 minit)

Laksana pengeksanan token untuk mengelakkan permintaan token yang tidak perlu

Jangan kongsi client_secret anda atau menyelitkannya dalam kod sisi klienPersekitaranAPI tersedia dalam dua persekitaran:PersekitaranURL AsasTujuanPengeluaranhttps://api.shell.com/toll-data/v1Persekitaran pengeluaran langsungUji (UAT)https://api-test.shell.com/toll-data/v1Persekitaran ujian dan pembangunanURL Token OAuth:

PersekitaranURL TokenPengeluaranhttps://api.shell.com/v2/oauth/tokenUjian (UAT)https://api-test.shell.com/v2/oauth/token

Petua: Sentiasa uji integrasi anda dalam persekitaran Ujian sebelum beralih ke pengeluaran.Permulaan Cepat1. Dapatkan Butiran Akses OAuth Anda

Hubungi Sokongan Teknikal Shell

Meminta kelayakan OAuth 2.0 (client_id dan client_secret)

Semak terma perkhidmatan2. Dapatkan Token AksesPertama, dapatkan token akses OAuth anda:Contoh cURL:

curl -X POST https://api-test.shell.com/v2/oauth/token \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=client_credentials&client_id=your-client-id&client_secret=your-client-secret"

Respon:

{
  "access_token": "eyJhbGciOi*******5cCI6IkpXVCJ9...",
  "token_type": "Bearer",
  "expires_in": 899
}

3. Buat Permintaan API Pertama AndaContoh: Cari Transaksi TolContoh cURL:

curl -X POST https://api-test.shell.com/toll-data/v1/transactions/search \
  -H "Authorization: Bearer eyJhbGci******NiIsInR5cCI6IkpXVCJ9..." \
  -H "Content-Type: application/json" \
  -H "RequestId: eb621f45-a543-4d9a-a934-2f223b263c42" \
  -d '{
    "Penapis": {
 "ColCoCode": 86,
 "PayerNumber": "NL20016398",
 "AccountNumber": "NL20027701",
        "Filter": "Semua",
 "DariTarikh": "2026-01-01",
 "KeTarikh": "2026-01-31"
    },
    "Halaman": 1,
    "PageSize": 10
}'

Tindak Balas Contoh:

{
  "RequestId": "eb621f45-a543-4d9a-a934-2f223b263c42",
  "Status": "SUCCESS",
  "Page": 1,
  "TotalRecords": 150,
  "TotalPages": 15,
  "PageSize": 10,
  "Data": [
    {
 "NetworkDescription": "Societa Autostradali",
 "TollChargerCode": "410|610",
      "DelcoCode": "714",
 "DelcoName": "Shell Fleet Solutions Consorzio",
 "NetworkCode": "TLI",
 "Network": "euroShell Consortio",
 "PurchasedInCountry": "Italy",
 "PurchasedInCountryCode": "IT",
 "CardNumber": "707737*******334272",
 "CardId": 123456789,
 "CardGroupName": "Shell Fleet Solutions Consorzio",
      "VehicleRegistration": "KN 00000",
 "CostCenter": "100",
 "SystemEntryDate": "20260123",
 "SystemEntryTime": "13:14:25",
 "TarikhTransaksi": "20260120",
 "MasaTransaksi": "10:30:00",
 "TarikhPencatatan": "20260123",
      "PostingTime": "00:00:00",
      "Nombor Pembayar": "NL20016398",
 "Nombor Akaun": "NL20027701",
 "Nama Akaun": "Nama Akaun Ujian",
 "Tarikh Mula": "20260120",
      "StartTime": "06:47:41",
 "EndDate": "20260120",
 "EndTime": "07:30:15",
      "TollGateEntry": "ROMA NORD",
 "TollGateExit": "BRENNERO",
 "DistanceDriven": "71.6",
 "RouteDescription": "ROMA NORD - BRENNERO",
      "JenisTransaksi": "Cukai jalan",
 "KodProduk": "14",
 "DeskripsiProduk": "Cukai jalan",
 "JumlahBersihTransaksi": "127.1",
 "CukaiTransaksi": "0.0",
      "JumlahKasauTransaksi": "127.1",
 "KodMataWangTransaksi": "EUR",
 "StatusTransaksi": "Pelaporan",
 "NomborInvois": "8600397548",
      "TarikhInvois": "20260125",
      "StatusInvois": "Telah Ditagih",
 "Kaedah Pembayaran": "Bayaran Pos",
 "Nombor Siri OBU": "00049000000836932426",
      "EmissionClass": "Euro 6",
 "ContractID": "fb75eb53-46eb-450b-862e-6045002c3fa8",
      "ShellTransactionID": "04176c5c-e7b2-49c8-bcb3-23d07ba583f2",
      "TollOperator": "Toll4Europe",
 "TollDomain": "Toll4Europe",
 "TariffRelevantInformation": "Kelas Kenderaan: 2, Bilangan Gandar: 2, Kategori Jalan: Lebuhraya",
 "Maklumat Transaksi Tambahan": "Lokasi:1",
 "Nombor Invois TC": "12343343",
      "TCInvoiceDate": "20260123"
    }
  ]
}

Rujukan Titik Akhir APITransaksi Tol

Titik AkhirKaedahKeterangan//toll-data/v1/transactions/searchPOSTMendapatkan data transaksi tol dengan penapisan dan pemajakan yang fleksibel

>Kes Penggunaan Umum:

Penapis mengikut status invois (Telah diinvois, Belum diinvois, Semua)

Mendapatkan transaksi tol mengikut julat tarikh

Penapis mengikut status invois (Telah diinvois, Belum diinvois, Semua)

Mendapatkan transaksi tol mengikut julat tarikh

Tapis mengikut status invois (Telah diinvois, Belum diinvois, Semua)

Tapis mengikut kumpulan kad

Susun transaksi mengikut pelbagai kriteria

Pilih medan tertentu untuk mengoptimumkan saiz responsKes Penggunaan BiasaBahagian ini memetakan senario perniagaan biasa kepada corak penggunaan API untuk membantu anda mengenal pasti dengan cepat cara menggunakan API untuk keperluan khusus anda.Kes Penggunaan 1: Penyelarasan Transaksi Tol HarianSenario: Anda perlu menyelaras semua transaksi tol daripada armada anda setiap hari untuk tujuan perakaunan.API yang disyorkan: /toll-data/v1/transactions/searchMengapa API ini: Titik akhir ini menyediakan butiran transaksi tol yang komprehensif dengan penapisan tarikh yang fleksibel, menyokong kedua-dua transaksi yang telah ditagih dan belum ditagih, dan termasuk paginasi untuk set data yang besar. Sempurna untuk aliran kerja penyelarasan harian.Parameter Utama:

FromDate dan ToDate - Tetapkan kepada tarikh semalam untuk penyelarasan harian Search.InvoiceStatus - Tetapkan kepada 'Invoice' untuk menyertakan kedua-dua transaksi yang telah ditagih dan belum ditagihParameter Utama: FromDate dan ToDate - Gunakan "All" untuk menyertakan kedua-dua transaksi yang telah ditagih dan belum ditagih Search.InvoiceStatus - Tetapkan kepada 'Invoice' untuk menyertakan kedua-dua transaksi yang telah ditagih dan belum ditagihMengapa API ini: Titik akhir ini menyediakan butiran transaksi tol yang komprehensif dengan penapisan tarikh yang fleksibel, menyokong kedua-dua transaksi yang telah ditagih dan belum ditagih, dan termasuk pemhalaman untuk set data yang besar.Sempurna untuk aliran kerja penyelarasan harian.Parameter Utama: FromDate dan ToDate - Gunakan "All" untuk menyertakan kedua-dua transaksi yang telah ditagih dan belum ditagih PageSize - Tetapkan kepada 100 untuk pengambilan data yang cekap Penapis - Gunakan "All" untuk mendapatkan butiran transaksi lengkapKes Penggunaan 2: Pengesahan dan Pemeriksaan InvoisSenario: Anda menerima invois dan perlu mengesahkan semua butiran dan caj transaksi tol.API yang disyorkan: /toll-data/v1/transactions/searchMengapa API ini: API ini menyediakan maklumat terperinci mengenai transaksi tol termasuk nombor invois, tarikh, jumlah, dan butiran rangkaian tol. Sesuai untuk pengesahan invois kerana ia sepadan dengan struktur invois.Parameter Utama: Search.InvoiceStatus - Tetapkan kepada "Telah Ditagih" untuk mendapatkan hanya transaksi yang telah ditagih FromDate dan ToDate - Tetapkan kepada tarikh tempoh invois Penapis - Nyatakan medan seperti "NomborInvois, TarikhInvois, JumlahKasTransaksi" untuk pengesahan terpusatKes Penggunaan 3: Analisis Penggunaan Tol Kenderaan ArmadaSenario: Anda perlu menganalisis corak penggunaan tol untuk kenderaan tertentu dalam armada anda bagi mengoptimumkan laluan dan mengurangkan kos tol.API yang disyorkan: /toll-data/v1/transactions/searchMengapa API ini: API ini membolehkan penapisan mengikut Nombor Pendaftaran Kenderaan (VRN) dan menyediakan maklumat laluan terperinci termasuk titik masuk/keluar, jarak yang dilalui, dan caj tol. Sesuai untuk analisis peringkat kenderaan.Parameter Utama: Search.VehicleRegistrationNumber Parameter Utama: - Nyatakan VRN untuk dianalisis -id="e864de9cbfaac791097c68292a10126a8"> Search.VehicleRegistrationNumber Parameter Utama: - Nyatakan VRN untuk dianalisis SortOption - Gunakan 1 (Tarikh Transaksi menaik) untuk analisis kronologi Penapis - Sertakan medan seperti "RouteDescription, DistanceDriven, TollGateEntry, TollGateExit, TransactionGrossAmount"Kes Penggunaan 4: Penjejakan Perbelanjaan Kumpulan KadSenario: Anda menguruskan pelbagai kumpulan kad dan perlu menjejaki perbelanjaan tol mengikut kumpulan kad untuk peruntukan bajet dan pelaporan pusat kos.API yang disyorkan: /toll-data/v1/transactions/search"">Search.CardGroup" - Nyatakan nama kumpulan kad atau gunakan "All" untuk mendapatkan semua kumpulan kad. Mengapa API ini: API ini menyokong penapisan mengikut kumpulan kad dan merangkumi maklumat pusat kos, menjadikannya sesuai untuk penjejakan perbelanjaan dan pelaporan pada peringkat kumpulan kad. Parameter Utama: Search.CardGroup - Nyatakan nama kumpulan kad atau gunakan "All" untuk semua kumpulan FromDate dan ToDate - Tetapkan kepada tempoh pelaporan Filter - Sertakan "CardGroupName, CostCenter, TransactionGrossAmount, TransactionNetAmount, TransactionTax" SortOption - Gunakan 3 (Jumlah Transaksi meningkat) untuk analisis perbelanjaanKes Penggunaan 5: Pelaporan Tol Pelbagai AkaunSenario: Anda menguruskan pelbagai akaun dan perlu menjana laporan tol terkumpul merentas semua akaun.API yang Disyorkan: /toll-data/v1/transactions/searchKenapa API ini: API ini menyokong pertanyaan berbilang akaun (2-5 disyorkan) dalam satu permintaan, mengurangkan panggilan API dan meningkatkan prestasi untuk senario berbilang akaun.Parameter Utama: NomborAkaun - Sediakan nombor akaun yang dipisahkan dengan koma (maksimum 2-5 untuk prestasi optimum) FromDate dan ToDate - Tetapkan kepada tempoh pelaporan PageSize - Gunakan saiz halaman yang lebih besar (contohnya, 100-500) untuk prestasi yang lebih baikKes Penggunaan 6: Pemantauan Transaksi Belum DitagihSenario: Anda ingin memantau transaksi tol belum ditagih untuk meramalkan invois akan datang dan mengurus aliran tunai.API Disyorkan: /toll-data/v1/transactions/search"">Search.InvoiceStatus - Tetapkan kepada "Uninvoiced" untuk caj yang belum ditagihMengapa API ini: API ini membolehkan penapisan mengikut status invois, memudahkan pengesanan transaksi yang belum ditagih dan menganggarkan caj akan datang.Parameter Utama: Search.InvoiceStatus - Tetapkan kepada "Uninvoiced" untuk caj yang belum ditagih FromDate dan ToDate - Tetapkan kepada tempoh pengebilan semasa Penapis - Masukkan "TarikhTransaksi, JumlahKasherTransaksi, NomborAkaun, PendaftaranKenderaan"Kes Penggunaan 7: Analisis Penggunaan Rangkaian TolSenario: Anda perlu menganalisis rangkaian tol dan pengendali mana yang paling kerap digunakan oleh armada anda untuk merunding kadar yang lebih baik atau mengoptimumkan laluan.API yang Disyorkan: /toll-data/v1/transactions/searchMengapa API ini: API ini menyediakan maklumat terperinci rangkaian tol termasuk penerangan rangkaian, pengendali tol, kod pemungut tol, dan kod rangkaian, sesuai untuk analisis penggunaan rangkaian.Parameter Utama: FromDate dan ToDate - Tetapkan kepada tempoh analisis (contohnya, suku tahunan) Penapis - Sertakan "NetworkDescription, TollOperator, TollChargerCode, Network, TransactionGrossAmount" PageSize - Gunakan saiz halaman yang lebih besar untuk pengekstrakan data menyeluruhContoh Penggunaan

Contoh 1: Cari Transaksi Tol mengikut Akaun dan Julat Tarikh

Permintaan:

POST /toll-data/v1/transactions/search

{
  "Filters": {
    "ColCoCode": 86,
    "PayerNumber": "NL20016398",
    "AccountNumber": "NL20027701",
    "Filter": "All",
    "FromDate": "2026-01-01",
    "ToDate": "2026-01-31"
  },
  "Page": 1,
  "PageSize": 10
}

Respon:

{
  "RequestId": "eb621f45-a543-4d9a-a934-2f223b263c42",
  "Status": "SUCCESS",
  "Page": 1,
  "TotalRecords": 150,
  "TotalPages": 15,
  "PageSize": 10,
  "Data": [
    {
 "NetworkDescription": "Societa Autostradali",
 "TollChargerCode": "410|610",
      "DelcoCode": "714",
 "DelcoName": "Shell Fleet Solutions Consorzio",
 "NetworkCode": "TLI",
      "Network": "euroShell Consortio",
 "PurchasedInCountry": "Italy",
 "PurchasedInCountryCode": "IT",
 "CardNumber": "707737*******334272",
      "CardId": 123456789,
 "CardGroupName": "Shell Fleet Solutions Consorzio",
 "VehicleRegistration": "KN 00000",
      "CostCenter": "100",
 "SystemEntryDate": "20260123",
 "SystemEntryTime": "13:14:25",
 "TransactionDate": "20260120",
      "TransactionTime": "10:30:00",
 "PostingDate": "20260123",
 "PostingTime": "00:00:00",
 "PayerNumber": "NL20016398",
      "NomborAkaun": "NL20027701",
 "NamaAkaun": "Nama Akaun Uji",
 "TarikhMula": "20260120",
 "WaktuMula": "06:47:41",
      "EndDate": "20260120",
 "EndTime": "07:30:15",
 "TollGateEntry": "ROMA NORD",
      "TollGateExit": "BRENNERO",
 "DistanceDriven": "71.6",
 "RouteDescription": "ROMA NORD - BRENNERO",
 "TransactionType": "Cukai jalan",
 "ProductCode": "14",
      "ProductDescription": "Cukai jalan",
 "TransactionNetAmount": "127.1",
 "TransactionTax": "0.0",
 "TransactionGrossAmount": "127.1",
      "TransactionCurrencyCode": "EUR",
 "TransactionStatus": "Pelaporan",
 "InvoiceNumber": "8600397548",
 "InvoiceDate": "20260125",
      "StatusInvois": "Telah Ditagih",
 "Kaedah Pembayaran": "Post Pay",
      "OBUSerialNumber": "00049000000836932426",
 "EmissionClass": "Euro 6",
 "ContractID": "fb75eb53-46eb-450b-862e-6045002c3fa8",
 "ShellTransactionID": "04176c5c-e7b2-49c8-bcb3-23d07ba583f2",
      "PengendaliLeung": "Toll4Europe",
 "DomainLeung": "Toll4Europe",
 "MaklumatRelevanTarif": "Kelas Kenderaan: 2, Bilangan Gandar: 2, Kategori Jalan: Lebuhraya",
      "AdditionalTransactionInfo": "Location:1",
 "TCInvoiceNumber": "12343343",
 "TCInvoiceDate": "20260123"
    }
  ]
}

Contoh 2: Tapis Transaksi mengikut Nombor Pendaftaran Kenderaan (VRN)Permintaan:

POST /toll-data/v1/transactions/search

{
  "Penapis": {
    "ColCoCode": 86,
    "NomborPembayar": "NL20016398",
    "AccountNumber": "NL20027701",
    "Filter": "VehicleRegistration, RouteDescription, TransactionGrossAmount, TransactionDate",
    "FromDate": "2026-01-01",
    "ToDate": "2026-03-31",
    "Search": {
 "NomborPendaftaranKenderaan": "KN 00000",
 "StatusInvois": "Semua"
    }
  },
  "Page": 1,
  "PageSize": 50
}

Respon:

{
  "RequestId": "9d2dee33-7803-485a-a2b1-2c7538e597ee",
  "Status": "SUCCESS",
  "Page": 1,
  "TotalRecords": 45,
  "TotalPages": 1,
  "PageSize": 50,
  "Data": [
    {
 "VehicleRegistration": "KN 00000",
      "RouteDescription": "ROMA NORD - BRENNERO",
 "TransactionGrossAmount": "127.1",
 "TransactionDate": "20260120"
    },
    {
      "VehicleRegistration": "KN 00000",
 "RouteDescription": "MILANO EST - VERONA SUD",
 "TransactionGrossAmount": "85.4",
      "TransactionDate": "20260125"
    }
  ]
}

Contoh 3: Cari mengikut Kumpulan KadPermintaan:

POST /toll-data/v1/transactions/search

{
  "Filters": {
    "ColCoCode": 86,
    "PayerNumber": "NL20016398",
    "AccountNumber": "NL20027701",
    "Penapis": "NamaKumpulanKad, PendaftaranKenderaan, JumlahKasTransaksi, TarikhTransaksi",
    "TarikhMula": "2026-01-01",
    "TarikhTamat": "2026-01-31",
    "Carian": {
      "CardGroup": "Shell Fleet Solutions Consorzio",
 "InvoiceStatus": "All"
    }
  },
  "Page": 1,
  "PageSize": 30
}

Respon:

{
  "RequestId": "5f1bded6-416d-4478-ab7f-33905d7b5d4b",
  "Status": "JAYA",
  "Halaman": 1,
  "JumlahRekod": 87,
  "JumlahHalaman": 3,
  "PageSize": 30,
  "Data": [
    {
 "CardGroupName": "Shell Fleet Solutions Consorzio",
 "VehicleRegistration": "KN 00000",
      "JumlahKasTransaksi": "127.1",
 "TarikhTransaksi": "20260120"
    },
    {
 "NamaKumpulanKad": "Shell Fleet Solutions Consorzio",
 "PendaftaranKenderaan": "LM 11111",
 "JumlahKasTransaksi": "95.8",
 "TarikhTransaksi": "20260122"
    }
  ]
}

Contoh 4: Pelbagai Akaun dengan Medan TertentuPermintaan:

POST /toll-data/v1/transactions/search

{
  "Penapis": {
    "ColCoCode": 86,
    "NomborPembayar": "NL20016398",
    "NomborAkaun": "NL20027701, NL20027702",
    "Penapis": "NomborAkaun, NamaAkaun, TarikhTransaksi, JumlahKasabohTransaksi, PendaftaranKenderaan",
    "DariTarikh": "2026-01-01",
    "KeTarikh": "2026-01-31"
  },
  "Page": 1,
  "PageSize": 100
}

Respon:

{
  "RequestId": "eb621f45-a543-4d9a-a934-2f223b263c42",
  "Status": "SUCCESS",
  "Page": 1,
  "TotalRecords": 245,
  "TotalPages": 3,
  "PageSize": 100,
  "Data": [
    {
 "AccountNumber": "NL20027701",
 "AccountName": "Nama Akaun Ujian",
      "TransactionDate": "20260120",
 "TransactionGrossAmount": "127.1",
 "VehicleRegistration": "KN 00000"
    },
    {
 "NomborAkaun": "NL20027702",
 "NamaAkaun": "Nama Akaun Kedua",
 "TarikhTransaksi": "20260121",
      "TransactionGrossAmount": "98.5",
 "VehicleRegistration": "PQ 22222"
    }
  ]
}

Penanganan RalatKod Ralat Biasa

Status HTTPKod RalatKeteranganPenyelesaian200Tidak TerpakaiStatus: BERJAYATidak Terpakai400E0001Kesilapan PengesahanSemak parameter permintaan, pastikan medan yang diperlukan dipenuhi dan sah401E0003Tidak DibenarkanPastikan token OAuth sah dan tidak tamat tempoh404E0005Tidak DitemuiSemak URL hujung dan sumber wujud500E0002Ralat Tidak Dikenali / Ralat Pelayan DalamanHubungi sokongan dengan RequestId503E0012Perkhidmatan Tidak Tersedia / Ralat KesambunganCuba semula selepas beberapa ketika, jika masalah berterusan hubungi sokongan

Contoh Respons RalatRalat Pengesahan (E0001):

{
  "RequestId": "eb621f45-a543-4d9a-a934-2f223b263c42",
  "Status": "GAGAL",
  "Ralat": [
    {
 "Kod": "E0001",
 "Tajuk": "Ralat Pengesahan",
 "Butiran": "Nilai hilang / Tidak sah untuk: ColCoCode",
      "AdditionalInfo": null
    }
  ]
}

Ralat Tidak Dibenarkan (E0003):

{
  "RequestId": "eb621f45-a543-4d9a-a934-2f223b263c42",
  "Status": "GAGAL",
  "Kesilapan": [
    {
      "Code": "E0003",
 "Title": "Tidak Dibenarkan",
 "Detail": "Butiran yang dibekalkan tidak sah atau pengguna tidak mempunyai akses kepada operasi tersebut",
 "AdditionalInfo": null
    }
  ]
}

Amalan Terbaik1. Gunakan Pengesahan OAuth 2.0PENTING: Sentiasa gunakan pengesahan OAuth 2.0. Laksana pengurusan token yang betul:

Simpan token akses dalam cache dan gunakan semula sehingga tamat tempoh

Pembaharuan token sebelum ia tamat (disyorkan 60 saat sebelum)

Jangan log atau dedahkan token akses dalam kod sisi klien2. Sentiasa Sertakan RequestIdSentiasa sertakan RequestId unik (format UUID) dalam header untuk penjejakan dari hujung ke hujung. Ini penting untuk penyelesaian masalah dan sokongan.3. Laksana Penanganan Ralat Laksana penanganan ralat yang kukuh:

Semak medan Status dalam setiap respons

Log RequestId untuk penyelesaian masalah

Laksana logik percubaan semula untuk ralat sementara (503)

Tangani ralat pengesahan (E0001) dengan memeriksa parameter inputSokongan & SumberSokongan Teknikal

Sokongan: