Spring til hovedindhold

Documentation Index

Fetch the complete documentation index at: https://docs.smartsend.io/llms.txt

Use this file to discover all available pages before exploring further.

Når noget går galt, er den hurtigste vej til en løsning at kunne udpege præcis den request, der fejlede. Smart Send-API’et understøtter et lille sæt valgfrie headers, der gør debugging markant nemmere — både for dig og for vores supportteam.

​
User-Agent

Vi anbefaler, at du inkluderer en beskrivende User-Agent-header på hver API-request. Det hjælper os med at identificere din integration og er uvurderligt, når vi debugger problemer på dine vegne. Følg mønsteret Product/Version (Comments), der er fastlagt i RFC 7231. Angiv navnet og versionen på din applikation samt eventuelle relevante platformdetaljer i kommentarerne.
Example
User-Agent: my-shipping-app/1.0.0 (MyPlatform/2.3.1; PHP/8.2)
Til reference sender vores eget WooCommerce-plugin følgende header:
WooCommerce plugin example
User-Agent: smart-send-logistics/8.1.0 (WooCommerce/8.5.0; WordPress/6.4.2; PHP/8.1)
Uden en beskrivende User-Agent fremstår dine requests som anonym trafik, hvilket gør det meget sværere for vores supportteam at spore og løse problemer.

​
Request-ID

Request-ID-headeren er det enkeltstående mest nyttige værktøj, du har til at debugge Smart Send-API-kald. Det er en identifikator, som du sætter på hver request, og API’et sender den samme værdi tilbage i Request-ID-headeren i responsen.
Example
Request-ID: order-4521-book-a1b2c3
Vi anbefaler følgende mønster:
1

Generér et unikt ID for hver request

Generér en unik identifikator i din ende, før du laver requesten. En UUID fungerer godt, men en beskrivende nøgle knyttet til din forretningslogik (for eksempel et ordrenummer kombineret med handlingen) er ofte mere nyttig, når du senere skal finde den i dine egne logs.
2

Send det i Request-ID-headeren

Vedhæft identifikatoren til requesten ved hjælp af Request-ID-headeren. Smart Send-API’et returnerer den samme værdi i Request-ID-headeren i responsen, så du kan verificere, at den blev modtaget korrekt.
3

Log det i din ende

Inkludér Request-ID i dine egne applikationslogs sammen med eventuel anden kontekst om requesten. På den måde kan du, hvis noget går galt, slå kaldet op i dine logs og videresende Request-ID til Smart Send-support.
Request-ID indgår i vores interne logs, så når du kontakter support om en specifik request, kan du ved at oplyse Request-ID lade os spore den gennem vores systemer hurtigt og udpege præcis, hvad der skete.
Brug en vilkårlig streng på op til 128 tegn, der indeholder bogstaver, tal, punktummer, bindestreger eller understregninger.