Denne artikel beskriver, hvordan man konstruerer en ReprintLabels anmodning til Shipment Server API'et. Dette API giver dig mulighed for at genudskrive etiketter for en eksisterende forsendelse ved at give forsendelsesdataene og angive labelformatet.
Endpoint og metode:
Anmodningen skal være en POST anmodning til følgende endpoint:
- Produktion - https://www.shipmentserver.com
- Sandbox - https://demo.shipmentserver.com
Request Body (multipart/form-data):
Anmodningens indhold skal formateres som multipart/form-data med følgende nøgle-værdi par:
command: Skal altid sættes til"ReprintLabels". Dette fortæller API'et, hvilken handling der skal udføres.actor: Id'et på aktøren. Dette er dit brugernavn.key: Nøglen til aktøren. Dette er din adgangskode.data(JSON-streng): Denne felt indeholder de centrale forsendelsesoplysninger.options(JSON-streng): Denne felt giver dig mulighed for at angive yderligere muligheder, såsom etiketformatet.
Filen data.json indeholder id'et på den forsendelse, du ønsker at genudskrive.
-- filename: data.json
{
"ShpCSID":466635140
}
Filen options.json angiver etiketformatet, og viser, at etiketten skal genereres i ZPL-format til udskrivning på Zebra-printere. Bemærk, at i nogle tilfælde kan du kun anmode om etiketter i samme format, som forsendelsen blev oprettet med.
-- filename: options.json
{
"Labels": "ZPLGK"
}
Eksempel med curl.
curl -X POST "https://demo.shipmentserver.com" \
-F "command=ReprintLabels" \
-F "actor=YOUR_ACTOR_ID" \
-F "key=YOUR_ACTOR_KEY" \
-F "data={\"ShpCSID\": 0}" \
-F "options=\"{\"Labels\": \"ZPLGK\"}\""
Sådan importeres en cURL-anmodning i Postman
- Åbn Postman, vælg et arbejdsområde, og klik derefter på Import-knappen.
- Vælg fanen Raw Text og indsæt cURL-anmodningen.
- Klik på Continue, og derefter Import for at indlæse anmodningen i Postman.
- Opdater eventuelle pladsholdervariabler med dine faktiske værdier.
- Klik på Send for at udføre anmodningen.