Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

History

1 Commit

Repository files navigation

Dolivroo Python SDK

Official Python SDK for the Dolivroo Delivery API.

Installation

pip install dolivroo

Quick Start

fromdolivrooimportDolivrooclient=Dolivroo('your-api-key')
# Create a parcelparcel=client.parcels.create('yalidine', {
'customer': {
'first_name': 'Mohamed',
'last_name': 'Ali',
'phone': '0555000000'
},
'destination': {
'wilaya': 'Alger',
'commune': 'Bab El Oued'
},
'package': {
'products': 'T-Shirt x2'
},
'payment': {
'amount': 2500
}
})
print(f"Tracking ID: {parcel['tracking_id']}")

API Reference

Parcels

# Createclient.parcels.create('yalidine', order_data)
# Get detailsclient.parcels.get('TRACKING123', 'yalidine')
# List allclient.parcels.list('yalidine', page=1, per_page=25)
# Updateclient.parcels.update('TRACKING123', 'yalidine', updates)
# Cancelclient.parcels.cancel('TRACKING123', 'yalidine')
# Get labelclient.parcels.get_label('TRACKING123', 'yalidine')
# Trackclient.parcels.track('TRACKING123', 'yalidine')

Rates

# Get ratesclient.rates.get('yalidine', 'Alger', 'Oran')
# Compare all providersclient.rates.compare('Alger', 'Oran')

Wilayas

# List allclient.wilayas.list()
# List for providerclient.wilayas.list('yalidine')

Bulk Operations

# Create multiple parcelsclient.bulk.create_parcels('yalidine', [order1, order2, order3])

Error Handling

fromdolivrooimportDolivroo, AuthenticationError, ValidationError, RateLimitErrortry:
client.parcels.create('yalidine', order)
exceptAuthenticationError:
print('Invalid API key')
exceptValidationErrorase:
print(f'Validation errors: {e.errors}')
exceptRateLimitErrorase:
print(f'Rate limited, retry after: {e.retry_after}')

Configuration

client=Dolivroo(
api_key='your-api-key',
base_url='https://custom-api.com/api/v1/unified', # Optionaltimeout=60, # Optional, in secondsverify_ssl=True# Optional
)

License

MIT

Releases

Packages

Contributors

Languages