Chilkat Online Tools

DataFlex / ShipEngine Walkthrough / List your labels

Back to Collection Items

Use ChilkatAx-9.5.0-win32.pkg

Procedure Test
    Handle hoHttp
    Boolean iSuccess
    Variant vQueryParams
    Handle hoQueryParams
    Variant vResp
    Handle hoResp
    Variant vSbResponseBody
    Handle hoSbResponseBody
    Handle hoJResp
    Integer iRespStatusCode
    String sLabel_id
    String sStatus
    String sShipment_id
    String sShip_date
    String sCreated_at
    String sV_Currency
    String sAmount
    String sInsurance_costCurrency
    Integer iInsurance_costAmount
    String sTracking_number
    Boolean iIs_return_label
    String sRma_number
    Boolean iIs_international
    String sBatch_id
    String sCarrier_id
    String sService_code
    String sPackage_code
    Boolean iVoided
    String sVoided_at
    String sLabel_format
    String sLabel_layout
    Boolean iTrackable
    String sCarrier_code
    String sTracking_status
    String sV_Pdf
    String sPng
    String sZpl
    String sLabel_downloadHref
    String sForm_download
    String sInsurance_claim
    Integer j
    Integer iCount_j
    Integer iValue
    String sUnit
    String sDimensionsUnit
    Integer iLength
    Integer iWidth
    Integer iHeight
    String sInsured_valueCurrency
    Integer iInsured_valueAmount
    String sReference1
    String sReference2
    String sReference3
    String sExternal_package_id
    Integer iTotal
    Integer iPage
    Integer iPages
    String sHref
    String sLastHref
    Integer i
    Integer iCount_i
    String sTemp1
    Boolean bTemp1

    // This example assumes the Chilkat API to have been previously unlocked.
    // See Global Unlock Sample for sample code.

    Get Create (RefClass(cComChilkatHttp)) To hoHttp
    If (Not(IsComObjectCreated(hoHttp))) Begin
        Send CreateComObject of hoHttp
    End

    Get Create (RefClass(cComChilkatJsonObject)) To hoQueryParams
    If (Not(IsComObjectCreated(hoQueryParams))) Begin
        Send CreateComObject of hoQueryParams
    End
    Get ComUpdateInt Of hoQueryParams "page" 1 To iSuccess
    Get ComUpdateInt Of hoQueryParams "page_size" 10 To iSuccess
    Get ComUpdateString Of hoQueryParams "sort_by" "created_at" To iSuccess
    Get ComUpdateString Of hoQueryParams "sort_dir" "desc" To iSuccess

    Send ComSetRequestHeader To hoHttp "API-Key" "{{API_KEY}}"

    Get pvComObject of hoQueryParams to vQueryParams
    Get ComQuickRequestParams Of hoHttp "GET" "https://api.shipengine.com/v1/labels" vQueryParams To vResp
    If (IsComObject(vResp)) Begin
        Get Create (RefClass(cComChilkatHttpResponse)) To hoResp
        Set pvComObject Of hoResp To vResp
    End
    Get ComLastMethodSuccess Of hoHttp To bTemp1
    If (bTemp1 = False) Begin
        Get ComLastErrorText Of hoHttp To sTemp1
        Showln sTemp1
        Procedure_Return
    End

    Get Create (RefClass(cComChilkatStringBuilder)) To hoSbResponseBody
    If (Not(IsComObjectCreated(hoSbResponseBody))) Begin
        Send CreateComObject of hoSbResponseBody
    End
    Get pvComObject of hoSbResponseBody to vSbResponseBody
    Get ComGetBodySb Of hoResp vSbResponseBody To iSuccess

    Get Create (RefClass(cComChilkatJsonObject)) To hoJResp
    If (Not(IsComObjectCreated(hoJResp))) Begin
        Send CreateComObject of hoJResp
    End
    Get pvComObject of hoSbResponseBody to vSbResponseBody
    Get ComLoadSb Of hoJResp vSbResponseBody To iSuccess
    Set ComEmitCompact Of hoJResp To False

    Showln "Response Body:"
    Get ComEmit Of hoJResp To sTemp1
    Showln sTemp1

    Get ComStatusCode Of hoResp To iRespStatusCode
    Showln "Response Status Code = " iRespStatusCode
    If (iRespStatusCode >= 400) Begin
        Showln "Response Header:"
        Get ComHeader Of hoResp To sTemp1
        Showln sTemp1
        Showln "Failed."
        Send Destroy of hoResp
        Procedure_Return
    End

    Send Destroy of hoResp

    // Sample JSON response:
    // (Sample code for parsing the JSON response is shown below)

    // {
    //   "labels": [
    //     {
    //       "label_id": "se-1376213",
    //       "status": "voided",
    //       "shipment_id": "se-4140409",
    //       "ship_date": "2019-09-17T00:00:00Z",
    //       "created_at": "2019-09-17T21:24:38.293Z",
    //       "shipment_cost": {
    //         "currency": "usd",
    //         "amount": 98.14
    //       },
    //       "insurance_cost": {
    //         "currency": "usd",
    //         "amount": 0
    //       },
    //       "tracking_number": "9405511899564298842779",
    //       "is_return_label": false,
    //       "rma_number": null,
    //       "is_international": false,
    //       "batch_id": "",
    //       "carrier_id": "se-121861",
    //       "service_code": "usps_priority_mail",
    //       "package_code": "package",
    //       "voided": true,
    //       "voided_at": "2019-09-17T21:28:48.89Z",
    //       "label_format": "pdf",
    //       "label_layout": "4x6",
    //       "trackable": false,
    //       "carrier_code": "stamps_com",
    //       "tracking_status": "in_transit",
    //       "label_download": {
    //         "pdf": "https://api.shipengine.com/v1/downloads/10/y7wnsDz5f02H4IlaqNO0aw/label-1376213.pdf",
    //         "png": "https://api.shipengine.com/v1/downloads/10/y7wnsDz5f02H4IlaqNO0aw/label-1376213.png",
    //         "zpl": "https://api.shipengine.com/v1/downloads/10/y7wnsDz5f02H4IlaqNO0aw/label-1376213.zpl",
    //         "href": "https://api.shipengine.com/v1/downloads/10/y7wnsDz5f02H4IlaqNO0aw/label-1376213.pdf"
    //       },
    //       "form_download": null,
    //       "insurance_claim": null,
    //       "packages": [
    //         {
    //           "package_code": "package",
    //           "weight": {
    //             "value": 17,
    //             "unit": "pound"
    //           },
    //           "dimensions": {
    //             "unit": "inch",
    //             "length": 36,
    //             "width": 12,
    //             "height": 24
    //           },
    //           "insured_value": {
    //             "currency": "usd",
    //             "amount": 0
    //           },
    //           "tracking_number": "9405511899564298842779",
    //           "label_messages": {
    //             "reference1": null,
    //             "reference2": null,
    //             "reference3": null
    //           },
    //           "external_package_id": null
    //         }
    //       ]
    //     }
    //   ],
    //   "total": 1,
    //   "page": 1,
    //   "pages": 1,
    //   "links": {
    //     "first": {
    //       "href": "https://api.shipengine.com/v1/labels?label_status=voided&carrier_id=se-121861&service_code=usps_priority_mail&tracking_number=9405511899564298842779&sort_by=created_at&sort_dir=desc&page=1&page_size=10"
    //     },
    //     "last": {
    //       "href": "https://api.shipengine.com/v1/labels?label_status=voided&carrier_id=se-121861&service_code=usps_priority_mail&tracking_number=9405511899564298842779&sort_by=created_at&sort_dir=desc&page=1&page_size=10"
    //     },
    //     "prev": {},
    //     "next": {}
    //   }
    // }

    // Sample code for parsing the JSON response...
    // Use this online tool to generate parsing code from sample JSON: Generate JSON Parsing Code

    Get ComIntOf Of hoJResp "total" To iTotal
    Get ComIntOf Of hoJResp "page" To iPage
    Get ComIntOf Of hoJResp "pages" To iPages
    Get ComStringOf Of hoJResp "links.first.href" To sHref
    Get ComStringOf Of hoJResp "links.last.href" To sLastHref
    Move 0 To i
    Get ComSizeOfArray Of hoJResp "labels" To iCount_i
    While (i < iCount_i)
        Set ComI Of hoJResp To i
        Get ComStringOf Of hoJResp "labels[i].label_id" To sLabel_id
        Get ComStringOf Of hoJResp "labels[i].status" To sStatus
        Get ComStringOf Of hoJResp "labels[i].shipment_id" To sShipment_id
        Get ComStringOf Of hoJResp "labels[i].ship_date" To sShip_date
        Get ComStringOf Of hoJResp "labels[i].created_at" To sCreated_at
        Get ComStringOf Of hoJResp "labels[i].shipment_cost.currency" To sV_Currency
        Get ComStringOf Of hoJResp "labels[i].shipment_cost.amount" To sAmount
        Get ComStringOf Of hoJResp "labels[i].insurance_cost.currency" To sInsurance_costCurrency
        Get ComIntOf Of hoJResp "labels[i].insurance_cost.amount" To iInsurance_costAmount
        Get ComStringOf Of hoJResp "labels[i].tracking_number" To sTracking_number
        Get ComBoolOf Of hoJResp "labels[i].is_return_label" To iIs_return_label
        Get ComStringOf Of hoJResp "labels[i].rma_number" To sRma_number
        Get ComBoolOf Of hoJResp "labels[i].is_international" To iIs_international
        Get ComStringOf Of hoJResp "labels[i].batch_id" To sBatch_id
        Get ComStringOf Of hoJResp "labels[i].carrier_id" To sCarrier_id
        Get ComStringOf Of hoJResp "labels[i].service_code" To sService_code
        Get ComStringOf Of hoJResp "labels[i].package_code" To sPackage_code
        Get ComBoolOf Of hoJResp "labels[i].voided" To iVoided
        Get ComStringOf Of hoJResp "labels[i].voided_at" To sVoided_at
        Get ComStringOf Of hoJResp "labels[i].label_format" To sLabel_format
        Get ComStringOf Of hoJResp "labels[i].label_layout" To sLabel_layout
        Get ComBoolOf Of hoJResp "labels[i].trackable" To iTrackable
        Get ComStringOf Of hoJResp "labels[i].carrier_code" To sCarrier_code
        Get ComStringOf Of hoJResp "labels[i].tracking_status" To sTracking_status
        Get ComStringOf Of hoJResp "labels[i].label_download.pdf" To sV_Pdf
        Get ComStringOf Of hoJResp "labels[i].label_download.png" To sPng
        Get ComStringOf Of hoJResp "labels[i].label_download.zpl" To sZpl
        Get ComStringOf Of hoJResp "labels[i].label_download.href" To sLabel_downloadHref
        Get ComStringOf Of hoJResp "labels[i].form_download" To sForm_download
        Get ComStringOf Of hoJResp "labels[i].insurance_claim" To sInsurance_claim
        Move 0 To j
        Get ComSizeOfArray Of hoJResp "labels[i].packages" To iCount_j
        While (j < iCount_j)
            Set ComJ Of hoJResp To j
            Get ComStringOf Of hoJResp "labels[i].packages[j].package_code" To sPackage_code
            Get ComIntOf Of hoJResp "labels[i].packages[j].weight.value" To iValue
            Get ComStringOf Of hoJResp "labels[i].packages[j].weight.unit" To sUnit
            Get ComStringOf Of hoJResp "labels[i].packages[j].dimensions.unit" To sDimensionsUnit
            Get ComIntOf Of hoJResp "labels[i].packages[j].dimensions.length" To iLength
            Get ComIntOf Of hoJResp "labels[i].packages[j].dimensions.width" To iWidth
            Get ComIntOf Of hoJResp "labels[i].packages[j].dimensions.height" To iHeight
            Get ComStringOf Of hoJResp "labels[i].packages[j].insured_value.currency" To sInsured_valueCurrency
            Get ComIntOf Of hoJResp "labels[i].packages[j].insured_value.amount" To iInsured_valueAmount
            Get ComStringOf Of hoJResp "labels[i].packages[j].tracking_number" To sTracking_number
            Get ComStringOf Of hoJResp "labels[i].packages[j].label_messages.reference1" To sReference1
            Get ComStringOf Of hoJResp "labels[i].packages[j].label_messages.reference2" To sReference2
            Get ComStringOf Of hoJResp "labels[i].packages[j].label_messages.reference3" To sReference3
            Get ComStringOf Of hoJResp "labels[i].packages[j].external_package_id" To sExternal_package_id
            Move (j + 1) To j
        Loop

        Move (i + 1) To i
    Loop



End_Procedure

Curl Command

curl -G -d "page=1"
	-d "page_size=10"
	-d "sort_by=created_at"
	-d "sort_dir=desc"
	-H "API-Key: {{API_KEY}}"
https://api.shipengine.com/v1/labels

Postman Collection Item JSON

{
  "name": "List your labels",
  "event": [
    {
      "listen": "test",
      "script": {
        "exec": [
          "let response = pm.response.json();",
          "",
          "if (response.labels.length > 0) {",
          "    const template = `",
          "        <link rel=\"stylesheet\" href=\"https://cdnjs.cloudflare.com/ajax/libs/meyer-reset/2.0/reset.min.css\">",
          "        <link rel=\"stylesheet\" href=\"https://stackpath.bootstrapcdn.com/bootstrap/4.3.1/css/bootstrap.min.css\">",
          "        ",
          "        <h1>Labels</h1>",
          "        <p class=\"lead\">",
          "            <span class=\"badge badge-success\">{{total}} labels</span> matched your search criteria <small>({{pages}} pages of results)</small>",
          "        </p>",
          "        ",
          "        <table class=\"table table-hover\">",
          "            <thead class=\"thead-dark\">",
          "                <tr>",
          "                    <th>Label ID</th>",
          "                    <th>Carrier</th>",
          "                    <th>Service</th>",
          "                    <th>Cost</th>",
          "                    <th>Status</th>",
          "                    <th>Tracking Number</th>",
          "                </tr>",
          "            </thead>",
          "            <tbody>",
          "                {{#each labels}}",
          "                    <tr>",
          "                        <td>{{label_id}}</td>",
          "                        <td>",
          "                            <img alt=\"{{carrier_id}}\" style=\"height: 30px\"",
          "                            src=\"https://www.shipengine.com/docs/img/logos/carriers/{{carrier_code}}.svg\">",
          "                        </td>",
          "                        <td>",
          "                            <samp>{{service_code}}</samp>",
          "                        </td>",
          "                        <td>{{shipment_cost.amount}} {{shipment_cost.currency}}</td>",
          "                        <td>{{status}}</td>",
          "                        <td>{{tracking_number}}</td>",
          "                    </tr>",
          "                {{/each}}",
          "            </tbody>",
          "        </table>",
          "    `;",
          "    ",
          "    pm.visualizer.set(template, response);",
          "}"
        ],
        "type": "text/javascript"
      }
    }
  ],
  "request": {
    "method": "GET",
    "header": [
    ],
    "url": {
      "raw": "https://api.shipengine.com/v1/labels?page=1&page_size=10&sort_by=created_at&sort_dir=desc",
      "protocol": "https",
      "host": [
        "api",
        "shipengine",
        "com"
      ],
      "path": [
        "v1",
        "labels"
      ],
      "query": [
        {
          "key": "label_status",
          "value": "voided",
          "disabled": true
        },
        {
          "key": "carrier_id",
          "value": "{{stamps_com}}",
          "disabled": true
        },
        {
          "key": "service_code",
          "value": "usps_priority_mail",
          "disabled": true
        },
        {
          "key": "tracking_number",
          "value": "{{tracking_number}}",
          "disabled": true
        },
        {
          "key": "page",
          "value": "1"
        },
        {
          "key": "page_size",
          "value": "10"
        },
        {
          "key": "sort_by",
          "value": "created_at"
        },
        {
          "key": "sort_dir",
          "value": "desc"
        }
      ]
    },
    "description": "This request shows how to list labels that match certain criteria, such as the carrier, service, date, warehouse, status, etc."
  },
  "response": [
    {
      "name": "List your labels",
      "originalRequest": {
        "method": "GET",
        "header": [
        ],
        "url": {
          "raw": "https://api.shipengine.com/v1/labels?label_status=voided&carrier_id={{stamps_com}}&service_code=usps_priority_mail&tracking_number={{tracking_number}}&page=1&page_size=10&sort_by=created_at&sort_dir=desc",
          "protocol": "https",
          "host": [
            "api",
            "shipengine",
            "com"
          ],
          "path": [
            "v1",
            "labels"
          ],
          "query": [
            {
              "key": "label_status",
              "value": "voided"
            },
            {
              "key": "carrier_id",
              "value": "{{stamps_com}}"
            },
            {
              "key": "service_code",
              "value": "usps_priority_mail"
            },
            {
              "key": "tracking_number",
              "value": "{{tracking_number}}"
            },
            {
              "key": "page",
              "value": "1"
            },
            {
              "key": "page_size",
              "value": "10"
            },
            {
              "key": "sort_by",
              "value": "created_at"
            },
            {
              "key": "sort_dir",
              "value": "desc"
            }
          ]
        }
      },
      "status": "OK",
      "code": 200,
      "_postman_previewlanguage": "json",
      "header": [
        {
          "key": "Date",
          "value": "Tue, 17 Sep 2019 21:33:29 GMT"
        },
        {
          "key": "Content-Type",
          "value": "application/json; charset=utf-8"
        },
        {
          "key": "Content-Length",
          "value": "2699"
        },
        {
          "key": "Connection",
          "value": "keep-alive"
        },
        {
          "key": "Access-Control-Allow-Origin",
          "value": "https://www.shipengine.com"
        },
        {
          "key": "Vary",
          "value": "Origin"
        },
        {
          "key": "x-shipengine-requestid",
          "value": "b3354fc0-d6c2-4711-861f-03730ee4ad2e"
        }
      ],
      "cookie": [
      ],
      "body": "{\n    \"labels\": [\n        {\n            \"label_id\": \"se-1376213\",\n            \"status\": \"voided\",\n            \"shipment_id\": \"se-4140409\",\n            \"ship_date\": \"2019-09-17T00:00:00Z\",\n            \"created_at\": \"2019-09-17T21:24:38.293Z\",\n            \"shipment_cost\": {\n                \"currency\": \"usd\",\n                \"amount\": 98.14\n            },\n            \"insurance_cost\": {\n                \"currency\": \"usd\",\n                \"amount\": 0\n            },\n            \"tracking_number\": \"9405511899564298842779\",\n            \"is_return_label\": false,\n            \"rma_number\": null,\n            \"is_international\": false,\n            \"batch_id\": \"\",\n            \"carrier_id\": \"se-121861\",\n            \"service_code\": \"usps_priority_mail\",\n            \"package_code\": \"package\",\n            \"voided\": true,\n            \"voided_at\": \"2019-09-17T21:28:48.89Z\",\n            \"label_format\": \"pdf\",\n            \"label_layout\": \"4x6\",\n            \"trackable\": false,\n            \"carrier_code\": \"stamps_com\",\n            \"tracking_status\": \"in_transit\",\n            \"label_download\": {\n                \"pdf\": \"https://api.shipengine.com/v1/downloads/10/y7wnsDz5f02H4IlaqNO0aw/label-1376213.pdf\",\n                \"png\": \"https://api.shipengine.com/v1/downloads/10/y7wnsDz5f02H4IlaqNO0aw/label-1376213.png\",\n                \"zpl\": \"https://api.shipengine.com/v1/downloads/10/y7wnsDz5f02H4IlaqNO0aw/label-1376213.zpl\",\n                \"href\": \"https://api.shipengine.com/v1/downloads/10/y7wnsDz5f02H4IlaqNO0aw/label-1376213.pdf\"\n            },\n            \"form_download\": null,\n            \"insurance_claim\": null,\n            \"packages\": [\n                {\n                    \"package_code\": \"package\",\n                    \"weight\": {\n                        \"value\": 17,\n                        \"unit\": \"pound\"\n                    },\n                    \"dimensions\": {\n                        \"unit\": \"inch\",\n                        \"length\": 36,\n                        \"width\": 12,\n                        \"height\": 24\n                    },\n                    \"insured_value\": {\n                        \"currency\": \"usd\",\n                        \"amount\": 0\n                    },\n                    \"tracking_number\": \"9405511899564298842779\",\n                    \"label_messages\": {\n                        \"reference1\": null,\n                        \"reference2\": null,\n                        \"reference3\": null\n                    },\n                    \"external_package_id\": null\n                }\n            ]\n        }\n    ],\n    \"total\": 1,\n    \"page\": 1,\n    \"pages\": 1,\n    \"links\": {\n        \"first\": {\n            \"href\": \"https://api.shipengine.com/v1/labels?label_status=voided&carrier_id=se-121861&service_code=usps_priority_mail&tracking_number=9405511899564298842779&sort_by=created_at&sort_dir=desc&page=1&page_size=10\"\n        },\n        \"last\": {\n            \"href\": \"https://api.shipengine.com/v1/labels?label_status=voided&carrier_id=se-121861&service_code=usps_priority_mail&tracking_number=9405511899564298842779&sort_by=created_at&sort_dir=desc&page=1&page_size=10\"\n        },\n        \"prev\": {},\n        \"next\": {}\n    }\n}"
    }
  ]
}