def register_user_view(request):
    from datetime import datetime
    from django.http import JsonResponse
    # 从request对象中获取参数
    username = request.GET['username']
    age = request.GET['age']
    birthday = request.GET['birthday']
    # 检查参数合法性
    if username is None or len(username) == 0:
        raise ValueError('用户名不能为空')
    try:
        age = int(age)
    except ValueError:
        raise ValueError('年龄不正确')
    try:
        birthday = datetime.strptime(birthday, '%Y-%m-%d').date()
    except ValueError:
        raise ValueError('生日不正确')
    # 注册方式略去
    return JsonResponse({'name': username, 'age': age, 'birthday': birthday})

def register_user_apizen(username: String, age: Integer, birthday: Date):
    # 注册方式略去
    return {'name': username, 'age': age, 'birthday': birthday}

INSTALLED_APPS = [
    'apizen',
    'django.contrib.admin',
   	..........
]
# 这里配置需要导入的methods.py文件
APIZEN_METHODS = ['demo.methods']

urlpatterns = [
    url('', admin.site.urls),
    # 加入apizen的url
    url(r'^api/router/', include('apizen.urls')),
]

def first_api():
    return '这是第一个Api例子'

from . import views
from apizen.methods import register_webapi
methods = {
    # 接口版本号
    '1.0':
        {
            'methods':
                {
                    # key为方法名，value为接口配置
                    # func指向接口的实现函数
                    'matrix.api.first-api': {'func': views.first_api}
                }
        }
}
register_webapi(methods)

def register_user(name, age, email=None):
    return {'name': name, 'age': age, 'email': email}

from app.apizen.schema import Integer, String, Float, Dict, DateTime

def register_user(name, age: Integer, birthday: DateTime, email=None):
    return {'name': name, 'age': age, 'birthday': birthday, 'email': email}

def date_list(date: List(Date)):
    return date

class Email(TypeBase):
	
    # 定义类型名称，用于在返回异常信息中显示
    typename = 'Email'

    @staticmethod
    def convert(*, value):
        try:
            # 对字符串格式进行验证
            if re.match('^[a-zA-Z0-9_-]+@[a-zA-Z0-9_-]+(\.[a-zA-Z0-9_-]+)+$', str(value), flags=0):
                return value
            else:
                raise ValueError
        # 出现异常时，统一抛出ValueError异常
        except TypeError:
            raise ValueError

def multi_types(id_list: (int, List(int))):
    return id_list

# 传入单个int
payload = {'id_list': 1}
# 传入int组成的list
payload = {'id_list': [2, 3, 4, 5]}
# 传入str组成的list
# 因为有List(int)这个配置，所以list内的str会尝试转换成int
payload = {'id_list': ['2', '3', '4', '5']}

def multi_types(id_list: (String, List)):
    return id_list

from functools import wraps

def test_decorator(func):
    # 需要在包装器函数上增加一个functools中内置的装饰器 wraps
    @wraps(func)
    def wrapper(*args, **kwargs):
        return func(*args, **kwargs)
    return wrapper

def get_request(request=ApiRequest):
    return request.GET.dict()

# 上传文件
def upload_files(file_name, request=ApiRequest):
    import os
    file_path = os.path.join('upload', file_name)
    # 通过request获取上传的文件
    file = request.FILES['attachment']
	
	# 存储到某个目录
    with open(file_path, 'wb+') as destination:
        for chunk in file.chunks():
            destination.write(chunk)

methods = {
    # 接口版本号
    '1.0':
        {
            # 版本下对应的方法
            'methods':
                {
                    # 第一个API
                    'matrix.api.first-api': {'func': views.first_api}
                }
        },
    }

# 这个接口只支持GET方法，POST请求时会引发405异常
'matrix.api.first-api': {'func': views.first_api, 'http': ['GET']}
# 接口已停用，调用时会获取接口停用的异常
'matrix.api.first-api2': {'func': views.first_api, 'enable': False}

methods = {
    '1.0':
        {	
            # 停用接口
            'enable': False,
            'methods':
                {...}
        }
}

methods = {
    '1.0':
        {
            'inheritance': None,
            'methods':
                { ... }
        },
    '1.1':
        {
            # 继承 1.0
            'inheritance': '1.0',
            'methods':
                { .... }
        },
}

# API 系统层面异常信息
class ApiSysExceptions:
    # code 1000 为保留编码，代表执行成功，异常信息以1001开始
    # 服务不可用
    missing_system_error = ApiException(err_code=1001, http_code=403, err_msg='服务不可用', err_type=Exception)
    # 限制时间内调用失败次数
    app_call_limited = ApiException(err_code=1002, http_code=403, err_msg='限制时间内调用失败次数', err_type=Exception)
    # 请求被禁止
    forbidden_request = ApiException(err_code=1003, http_code=403, err_msg='请求被禁止', err_type=Exception)
    # 缺少版本参数
    missing_version = ApiException(err_code=1004, http_code=400, err_msg='缺少版本参数', err_type=KeyError)
    # 不支持的版本号
    unsupported_version = ApiException(err_code=1005, http_code=400, err_msg='不支持的版本号', err_type=ValueError)

# API 子系统（业务）层级执行结果，以2000开始
class ApiSubExceptions:
    empty_result = ApiException(err_code=2000, http_code=200, err_msg='查询结果为空', err_type=Exception)
    unknown_error = ApiException(err_code=2001, http_code=500, err_msg='未知异常', err_type=Exception)
    other_error = ApiException(err_code=2002, http_code=500, err_msg='其它异常', err_type=Exception)
    user_not_exits = ApiException(err_code=2003, http_code=404, err_msg='用户不存在', err_type=Exception)
    wrong_password = ApiException(err_code=2004, http_code=400, err_msg='用户名或密码错误', err_type=Exception)
    email_registered = ApiException(err_code=2005, http_code=400, err_msg='邮箱已注册', err_type=Exception)

from apizen.exceptions import ApiSysExceptions
def raise_error():
	raise ApiSysExceptions.forbidden_request

from apizen.exceptions import ApiSysExceptions
def custom_error(msg):
	raise ApiSysExceptions.forbidden_request('自定义异常文字')