Metadata-Version: 2.1
Name: freenet-funk-api
Version: 0.1.4
Summary: Reverse engineered API of Freenet FUNK
Home-page: https://github.com/lagmoellertim/freenet-funk-api
Author: Tim-Luca Lagmöller
Author-email: hello@lagmoellertim.de
License: MIT License
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Description-Content-Type: text/markdown
Requires-Dist: boto3 (==1.9.145)
Requires-Dist: botocore (==1.12.145)
Requires-Dist: certifi (==2019.3.9)
Requires-Dist: chardet (==3.0.4)
Requires-Dist: docutils (==0.14)
Requires-Dist: ecdsa (==0.13.2)
Requires-Dist: envs (==1.3)
Requires-Dist: future (==0.17.1)
Requires-Dist: idna (==2.8)
Requires-Dist: jmespath (==0.9.4)
Requires-Dist: pycryptodome (==3.3.1)
Requires-Dist: python-dateutil (==2.8.0)
Requires-Dist: python-jose-cryptodome (==1.3.2)
Requires-Dist: requests (==2.21.0)
Requires-Dist: s3transfer (==0.2.0)
Requires-Dist: six (==1.12.0)
Requires-Dist: urllib3 (==1.24.3)
Requires-Dist: warrant (==0.6.1)

# Freenet FUNK API

## Introduction

Freenet FUNK is cellphone tariff that offers **unlimited** (or 1 GB of) 4G data. The tariff is can be started, stopped and paused **daily**.

To make the most out of this flexibility, I reverse engineered the **API**   to give anyone the ability to develop amazing apps on their own!

## Prerequisites

- Python >=3.2
- pip

## Installation

```sh
git clone https://github.com/lagmoellertim/freenet-funk-api.git

cd freenet-funk-api

python3 setup.py install
```

## Build

```sh
git clone https://github.com/lagmoellertim/freenet-funk-api.git

cd freenet-funk-api

python3 setup.py sdist bdist_wheel
```

## Usage

### Initialize the API

```python3
from funkapi import FunkAPI
api = FunkAPI("*username*", "*password*")
```

### Get a Token (not really necessary to do that manually but I left the option)

```python3
token = api.getToken()
```

### Initialize the API with a predefined Token

```python3
from funkapi import FunkAPI
api = FunkAPI("", "", token="*token*")
```

### Check the validity of a Token (also not really necessary to do manually)

```python3
isValid = api.testToken("*token*")
```

### Get Dashboard Data (includes every piece of data FUNK stores of you)

```python3
data = api.getData()
```

### Get Personal Information (email, name, birthday, …)

```python3
personalInfo = api.getPersonalInfo()
```

### Get a List of your ordered Products

```python3
products = api.getOrderedProducts()
```

### Get the currently active Tariff

```python3
currentTariff = api.getCurrentTariff()
```

### Order the 1GB Tariff

```python3
status = api.order1GBTariff()
```

### Order the unlimited Tariff

```python3
status = api.orderUnlimitedTariff()
```

### Start a Break

```python3
status = api.startPause()
```

### Stop the latest Product (includes stopping a break)

```python3
status = api.stopLatestTariff()
```

## Contributing

If you are missing a feature or have new idea, go for it! That is what open-source is for!

## Author

**Tim-Luca Lagmöller** ([@lagmoellertim](https://github.com/lagmoellertim))

## Donate

You can also contribute by [buying me a coffee](http://donate.lagmoellertim.de).

## License

[MIT License](https://github.com/lagmoellertim/cryption/blob/master/LICENSE)

Copyright © 2019-present, [Tim-Luca Lagmöller](https://en.lagmoellertim.de)

## Have fun :tada:


