Skip to main content
Help us improve PyPI by participating in user testing. All experience levels needed!

UNKNOWN

Project description

# BasitApi [![Build Status](https://travis-ci.org/omerucel/basitapi.png)](https://travis-ci.org/omerucel/basitapi)

RESTful API oluşturmanızda size yardımcı olan basit bir kütüphane. Django'nun
sınıf temelli View yapısı üzerine kurulu. Bir RESTful API'de olması gereken
bazı temel özellikleri sunar ve başka da bir işe karışmaz.

Sunduğu bazı temel özellikler:

* *Bağlantıdaki method parametresi ile HTTP_METHOD başlığının ezilmesi.*

Bazı istemciler sadece bazı metodları göndermekle kısıtlandırılabilirler. Bu
türlü bir durumda API'nin doğru çalışabilmesi için bağlantı içinde *method*
isimli parametreyi kullanabilirsiniz. Bu parametre ile HTTP_METHOD ezilir ve
gönderdiğiniz method parametresindeki değere göre işlemler yürütülür.

* *Her zaman 200 HTTP kodu ile dönüş.*

Bazı istemciler sadece bazı hata kodlarına yanıt verebilirler. BasitApi bu tür durumlar için
*suppress_response_codes* parametresine destek vermekte. Bu parametre değeri
1 olarak gönderildiğinde durumu ne olursa olsun tüm yanıtlar 200 kodu ile
gönderilmekte.

* *Yanıt formatı.*

Hem *Accept* başlık bilgisine hem de bağlantı dosya son ekine göre yanıt
formatı ayarlanabilmekte.


## Kurulum

PyPi üzerinden kurulum için aşağıdaki komutu kullanabilirsiniz:

```
$ pip install basitapi
```

Github üzerinden kurulum için aşağıdaki komutu kullanabilirsiniz:

```
$ pip install -e git://github.com/omerucel/basitapi.git#egg=basitapi
```

## Kullanım

### settings.py

```python
INSTALLED_APPS=(
...
'basitapi'
)
```

### urls.py

Bağlantı dosya son ekine göre yanıt formatını ayarlamak istemiyorsanız
bağlantılarınızı *format_suffix_patterns* ile tekrar formatlamanıza gerek yok!

```python
from basitapi.urlpatterns import format_suffix_patterns
from appname.views import ViewName

urlpatterns = patterns(
url(r'^foo', ViewName.as_view()),
...
)

urlpatterns = format_suffix_patterns(urlpatterns)
```

### views.py

```python

from basitapi.exception import ApiException
from basitapi.response import ApiResponse
from basitapi.views import ApiView

class ViewName(ApiView):
def get(self, request):
return ApiResponse({
'result' : 'data'
})

def post(self, request):
raise ApiException('Bir hata olustu', status=403, application_code=1111)
```

Project details


Release history Release notifications

This version
History Node

0.1.2

History Node

0.1.1

History Node

0.1

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
basitapi-0.1.2.tar.gz (15.3 kB) Copy SHA256 hash SHA256 Source None Apr 25, 2013

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page