glovo-wrapper

Unofficial glovo courier app API wrapper

Features

• Authorization using Glovo Courier app credentials
• Profile Informations
• Challenges
• Deliveries
• CheckIn method
• Raports
• Raport Details
• Booking & Unbooking slot system - NEW
• Calendar & Slots Info

Installation

Using NPM

  npm install glovo-wrapper

Usage

Authorization

import { oauth, isHttpError } from 'glovo-wrapper';

oauth.authenticate({
    grantType: "password",
    password: "<PASSWORD TO ACCOUNT>",
    termsAndConditionsChecked: false,
    userType: "courier",
    username: "<EMAIL TO ACCOUNT>"
}).then(data => {
    if (data === undefined) {
        console.log("No data found!");
        return;
    }
    if (isHttpError(data)) {
        console.log(`Error: ${JSON.stringify(data.error)}`);
        return;
    }

    // Save `accessToken` and execute other requests from `courier` module
    console.log(`Logged In with token: ${data.accessToken}`);
}).catch(console.error);

Get courier eg. profile data after authorization

import { courier, isHttpError } from 'glovo-wrapper';

const accessToken = // Get access token from authenticate() function (`oauth` module);

courier.getProfile(accessToken).then(profile => {
    if (isHttpError(profile)) {
        throw new Error(profile.error);
    }

    console.log(`Excellence Score: ${profile.header.excellenceScore}`);
}).catch(console.error);

Logout

import { oauth } from 'glovo-wrapper';

const accessToken = // Get access token from authenticate() function (`oauth` module);

oauth.logout(accessToken).then(success => console.log(`Success: ${success}`));

API Reference

Authorization

  OAuth authorize(authData: IAuthData)

| Parameter | Type | Possible Values | Description | | :-------- | :------- | :------ | :------------------ | | grantType | string | PASSWORD | Required. Authorization method | | password | string | | Required. User password | | termsAndConditionsChecked | boolean | True / False | Required. Are terms and conditions accepted| | userType | string | courier | Required. User account type| | username | string | | Required. User account email|

Return type: IToken | IError | undefined

IToken Interface

  OAuth interface IToken

| Parameter | Type | Possible Values | Description | | :-------- | :------- | :------ | :------------------ | | accessToken | string | Bearer Token | Generated user access bearer token | | expiresIn | number | Seconds | Number of seconds to token expire | | refreshToken | string | Refresh Token | Refresh token to renew accessToken after expire time | | scope | object or null | Unknown | Contains unknown data | | twoFactorToken | boolean | True / False | Determinate if user has 2FA |

IError Interface

  Http interface IError

| Parameter | Type | Possible Values | Description | | :-------- | :------- | :------ | :------------------ | | error | object | Error JSON structure | Contains error JSON structure, each error has probably own structure |

Full documentation