Allegro - gdzie jest moja paczka?

Introduction

Allegro is a popular Polish online shopping platform. As a programmer, you might be interested in its API for tracking and managing packages. One common question asked by users is "Gdzie jest moja paczka?" which means "Where is my package?" in Polish. In this article, we will explore how to use TypeScript to interact with Allegro's package tracking API and answer this important question.

Setting up the Environment

Before we begin, we need to ensure that our development environment is set up correctly. To interact with the Allegro API, we will use the axios library for making HTTP requests. We can install this library by running:

npm install axios

Next, we need to create a TypeScript file for our code. We can name this file allegro.ts.

Obtaining an Access Token

To interact with the Allegro API, we need to obtain an access token. This can be done by following these steps:

1. Go to https://apps.developer.allegro.pl/ and sign in with your Allegro account.

2. Create a new application by clicking the "Create New App" button.

3. Fill in the required fields (e.g., name, description, website) and click "Save Changes".

4. Click the "Generate Token" button to obtain your access token.

Make sure to keep your access token safe and do not share it with anyone.

Sending a Package Tracking Request

With our environment set up and access token obtained, we can now send a request to the Allegro API to track our package. Here is an example TypeScript code snippet:

import axios from 'axios';

// Replace `access_token` with your actual access token
const ACCESS_TOKEN = 'access_token';

// Replace `package_id` with the ID of your package
const PACKAGE_ID = 'package_id';

const ALLEGRO_API_URL = `https://api.allegro.pl/order/checkout-forms/packages/${PACKAGE_ID}/tracking`;

const headers = {
  Authorization: `Bearer ${ACCESS_TOKEN}`,
};

axios.get(ALLEGRO_API_URL, { headers })
  .then(response => {
    console.log(response.data);
  })
  .catch(error => {
    console.log(error.response.data);
  });

Here, we are making a GET request to the Allegro API's package tracking endpoint by using the axios library. We pass in our access token as an authorization header and the ID of our package in the URL. The API will return the current tracking information for our package, which we log to the console.

Conclusion

In this article, we learned how to use TypeScript to interact with the Allegro API and track our packages. With our environment set up and access token obtained, we were able to send a request to the API and retrieve the current package tracking information. Armed with this knowledge, we can now answer the important question: "Gdzie jest moja paczka?"