Tässä artikkelissa kerrotaan, miten rakennetaan ReprintLabels-pyyntö ShipmentServer API:lle. Tämä API mahdollistaa olemassa olevan lähetyksen tarrojen uudelleen tulostamisen toimittamalla lähetyksen tiedot ja määrittämällä tarran formaatin.

Päätepiste ja menetelmä:

Pyyntö tulee tehdä POST pyyntönä seuraavaan päätepisteeseen:

• Tuotanto - https://www.shipmentserver.com
• Sandbox - https://demo.shipmentserver.com

Pyynnön runko (multipart/form-data):

Pyynnön runko tulee muotoilla multipart/form-data seuraavilla avain-arvopareilla:

• command: Aseta aina arvoksi "ReprintLabels". Tämä kertoo API:lle, mitä toimintoa suoritetaan.
• actor: Toimijan Id. Tämä on käyttäjätunnuksesi.
• key: Toimijan avain. Tämä on salasanasi.
• data (JSON-merkkijono): Tämä kenttä sisältää keskeiset lähetyksen tiedot.
• options (JSON-merkkijono): Tämä kenttä mahdollistaa lisäasetusten määrittämisen, kuten tarran formaatin.

data.json-tiedosto sisältää sen lähetyksen id:n, jonka tarroja haluat uudelleen tulostaa.

-- filename: data.json

{
    "ShpCSID":466635140
}

options.json-tiedostossa määritellään tarran formaatti, joka tässä tapauksessa on ZPL-muoto Zebra-tulostimille. Huomaa, että joissakin tapauksissa voit pyytää tarroja vain siinä formaatissa, jossa lähetys on alun perin luotu.

-- filename: options.json

{
    "Labels": "ZPLGK"
}

Esimerkki curl-komennolla. 

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\"}\""

Kuinka tuoda cURL-pyyntö Postmaniin

1. Avaa Postman, valitse työtila ja klikkaa sitten Import-painiketta.
2. Valitse Raw Text-välilehti ja liitä cURL-pyyntö.
3. Klikkaa Continue, sitten Import ladataksesi pyynnön Postmaniin.
4. Päivitä kaikki paikkamerkki-muuttujat omilla arvoillasi.
5. Klikkaa Send suorittaaksesi pyynnön.