Python ile REST-API Servisi Oluşturma
Tags: python, flask, api
Published: 2021-08-12 08:26:17

# REST API Nedir ?  
  
REST  (**R**epresentational **S**tate **T**ransfer)  Temsili Durum Aktarımı anlamına gelir. 

Bir istemci bir sunucudan kaynaklar hakkında bilgi almak için bir istekte bulunduğunda, sunucu kaynağın mevcut durumunu istemci makineye geri aktarır.



![representational-state-transfer-diagram](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/k1evd4zhnf0822vxgohz.png)



Yukarıdaki şekilde de görebileceğiniz gibi , istemci bir veri tabanı sunucusundan veri talep edebileceğiniz PC'nizdir ve tüm iletişim REST API'leri üzerinden yapılır.

Bunun için de birkaç farklı yöntem vardır :

- **GET** - İstemci tarafından sunucudan veri seçmek veya almak için kullanılır.

- **POST** - İstemci tarafından sunucuya veri göndermek veya yazmak için kullanılır.

- **PUT** - İstemci tarafından sunucudaki mevcut verileri güncellemek için kullanılır.

- **DELETE** - İstemci tarafından sunucudaki mevcut verileri silmek için kullanılır.

  

# REST API Nasıl Oluşturulur ?

API'ler Java, C#, Python vb. gibi istediğiniz herhangi bir programlama dili kullanılarak oluşturulabilir.

 Bu uygulamada, bir API oluşturmak için Python'u kullanacağız ve bunun için Flask olarak bilinen bir kütüphaneden yararlanacağız. Flask, bizim için bir sunucu oluşturmak için ağır kaldırmanın çoğunu yapan popüler bir hafif web uygulaması geliştirme çerçevesidir ve geliştiriciler olarak yalnızca API'leri oluşturmak için iş mantığına odaklanmamız gerekir.



# Kurulum

Şimdi, Rest-API'yi oluşturmak için kullanacağımız flask, flask_restful ve veri işlemede kullanacağımız pandas paketlerini python3-pip ile kuralım.

```
$ sudo apt install python3-pip
```

```
$ pip3 install flask
```

```
$ pip3 install flask_restful
```

```
$ pip3 install pandas
```

# Kod
Kodun tamamına [buradan](https://github.com/abugraokkali/Rest-API) ulaşabilirsiniz.
- Gerekli paketlerin import edilmesi.
```python
from flask import Flask
from flask_restful import Api, Resource, reqparse
import pandas as pd
```
- Api nesnesinin oluşturulması.
```python
app = Flask(__name__)
api = Api(app)
```
- GET çağırıldığında users.csv okunması, dict formatına çevrilmesi ve döndürülmesi.
```python
class Users(Resource):
    def get(self):
        data = pd.read_csv('users.csv')
        data = data.to_dict('records')
        return {'data' : data}, 200
```
- POST çağırıldığında girdilerin parse edilmesi ve users.csv'ye bir satır eklenmesi.
```python
    def post(self):
        parser = reqparse.RequestParser()
        parser.add_argument('name', required=True)
        parser.add_argument('age', required=True)
        parser.add_argument('city', required=True)
        args = parser.parse_args()

        data = pd.read_csv('users.csv')

        new_data = pd.DataFrame({
            'name'      : [args['name']],
            'age'       : [args['age']],
            'city'      : [args['city']]
        })

        data = data.append(new_data, ignore_index = True)
        data.to_csv('users.csv', index=False)
        return {'data' : new_data.to_dict('records')}, 201
```

- Çoğu zaman bir API'de kaynağınızın birden çok URL'si olacaktır. Api nesnesindeki add_resource() fonksiyonu ile birden çok URL iletebilirsiniz. Her biri bir Resource'a yönlendirilecektir.
```python
api.add_resource(Users, '/users')
```


# Çalıştırma 

```
$ python3 flask_app.py 

Serving Flask app 'flask_app' (lazy loading)

Environment: production
WARNING: This is a development server. Do not use it in a production deployment.
Use a production WSGI server instead.

Debug mode: off

Running on http://127.0.0.1:5000/ (Press CTRL+C to quit)
```
# Testler
Testler için bir VSCode eklentisi olan Thunder Client kullanılmıştır.

```GET http://127.0.0.1:5000/users```
![GET](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/qtd021cvv7nybf27qmby.png)
```POST http://127.0.0.1:5000/users?name=Bugra&age=29&city=Istanbul```
![POST](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/aikrp3i508nvv1a79dur.png)
```GET http://127.0.0.1:5000/users```
![GET2](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/rqd9id7b5l8ooqo82wmf.png)
```GET http://127.0.0.1:5000/Tom```
![GET3](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/xpm5ksl5wwph7tn946b2.png)