Проектирование RESTful API с помощью Python и Flask

Мы ранее писали по теме: habrahabr.ru/company/SECL_GROUP/blog/204510/ — Как мы делали API для социальной сети (REST API для WEB)

Делать переводы про клиенты к этому сервису, да и остальных интересных статей по python и flask из этого блога? Я не профессиональный переводчик и не профессиональный python-разработчик — переводы эти делаю для практики языка и для новичков, которые как и я не могут найти в рунете такого же качества информации. Поэтому мой слог может хромать, перевод напоминать гугл-транслейт (хотя максимальная единица автоматического перевода — фраза)), а места расстановки запятых и тире может заставить дергаться глаз филолога. Если кто-то поможет с вычиткой переводов перед публикацией, буду очень признателен.

Всегда удивляло, почему для создания ресурса используют POST, а для обновления — PUT, семантически логичнее использовать PUT для создания, PATCH — для обновления…

Пара замечаний по сути статьи:
— после django-rest-framework данный код выглядит как закат солнца вручную, в django-reset-framework можно при помощи десятка строк реализовать полноценный REST API, с pagination, документацией, api browser и поддержкой всех методов
— не рекомендуется в REST API передавать номер версии в url

В официальной документации есть еще более приятный пример реализации REST API:
flask.pocoo.org/docs/0.10/views/#method-views-for-apis

Окошко авторизации возникает совсем не потому, что код ответа 401, а из-за заголовка WWW-Authenticate в ответе. Вот здесь есть более подробный ответ. Если вам не нужно выводить это окно пользователю, просто разберитесь, откуда берется этот заголовок и не надо устраивать махинаций с кодами ответа, пожалуйста

Не стоит предлагать городить функциональщину на Python там, где ее не должно быть:

def get_task(task_id):
    for task in tasks:
        if t['id'] == tasks_id:
            return jsonify({'task': task})
    abort(404)

Функцию make_public_task можно написать проще:

def make_public_task(task):
    return dict(k, v for k, v in task.items() if k != 'id', 
                url=url_for('get_task', task_id=task['id'], _external=True))

Вместо if len(task) == 0 лучше писать просто if not task.

Команду return None в конце тела функции писать не нужно — это делается автоматически.

Проверку типов необходимо делать с помощью функции isinstance(obj, cls), конкретно в случае со строками используя isinstance(s, basestring) (актуально для Python 2).

Не стоит забывать про метод PATCH. Он предназначен для частичного изменения объекта. На мой взгляд, в большинстве своём он гораздо нужнее, чем PUT.

Спасибо за статью. Не жалею, что прочитал.

Я не очень понимаю как с REST API в python избежать проблемы одновременных обращений.:
Добавим time.sleep(1000), что бы просимулировать медленный ответ REST API и тут начинаются проблемы:

@app.route('/tasks/<int:task_id>', methods=['GET'])
def get_task(task_id):
    task = filter(lambda t: t['id'] == task_id, tasks)
    if len(task) == 0:
        abort(404)
    if task_id==2:
        print "sleeping..."
        time.sleep(1000)
    return jsonify({'task': task[0]})

я паралельно запросил curl -i localhost:8888/tasks/2 и curl -i localhost:8888/tasks/1, при этом нет ответа от этих двух запросов.
#python flask/example.py

 * Running on http://0.0.0.0:8888/
 * Restarting with reloader
127.0.0.1 - - [21/Jan/2015 14:06:47] "GET /tasks/3 HTTP/1.1" 404 -
127.0.0.1 - - [21/Jan/2015 14:06:51] "GET /tasks/1 HTTP/1.1" 200 -
sleeping...

Подскажите как решается эта проблема?

Маленькая ошибочка в коде метода GET нужно писать
task = list(filter(lambda t: t['id'] == task_id, tasks))