275f16060a
v1 and v2: - Use path convertor to consume entire document which MIGHT contain `/` - Drop string convertor, as it's the default - Dont merge slashes - avoid consuming something that's part of name v2: - `SI/BLAH/BLAH/submit` is not simple to parse without ambiguitity - `SI/BLAH/BLAH/method/submit` removes ambiguitity for 99.99% cases.
64 lines
1.7 KiB
Python
64 lines
1.7 KiB
Python
# Copyright (c) 2015, Frappe Technologies Pvt. Ltd. and Contributors
|
|
# License: MIT. See LICENSE
|
|
from werkzeug.exceptions import NotFound
|
|
from werkzeug.routing import Map, Submount
|
|
from werkzeug.wrappers import Request, Response
|
|
|
|
import frappe
|
|
import frappe.client
|
|
from frappe import _
|
|
from frappe.utils.response import build_response
|
|
|
|
|
|
def handle(request: Request):
|
|
"""
|
|
Entry point for `/api` methods.
|
|
|
|
APIs are versioned using second part of path.
|
|
v1 -> `/api/v1/*`
|
|
v2 -> `/api/v2/*`
|
|
|
|
Different versions have different specification but broadly following things are supported:
|
|
|
|
- `/api/method/{methodname}` will call a whitelisted method
|
|
- `/api/resource/{doctype}` will query a table
|
|
examples:
|
|
- `?fields=["name", "owner"]`
|
|
- `?filters=[["Task", "name", "like", "%005"]]`
|
|
- `?limit_start=0`
|
|
- `?limit_page_length=20`
|
|
- `/api/resource/{doctype}/{name}` will point to a resource
|
|
`GET` will return document
|
|
`POST` will insert
|
|
`PUT` will update
|
|
`DELETE` will delete
|
|
"""
|
|
|
|
try:
|
|
endpoint, arguments = API_URL_MAP.bind_to_environ(request.environ).match()
|
|
except NotFound: # Wrap 404 - backward compatiblity
|
|
raise frappe.DoesNotExistError
|
|
|
|
data = endpoint(**arguments)
|
|
if isinstance(data, Response):
|
|
return data
|
|
|
|
if data is not None:
|
|
frappe.response["data"] = data
|
|
return build_response("json")
|
|
|
|
|
|
# Merge all API version routing rules
|
|
from frappe.api.v1 import url_rules as v1_rules
|
|
from frappe.api.v2 import url_rules as v2_rules
|
|
|
|
API_URL_MAP = Map(
|
|
[
|
|
# V1 routes
|
|
Submount("/api", v1_rules),
|
|
Submount("/api/v1", v1_rules),
|
|
Submount("/api/v2", v2_rules),
|
|
],
|
|
strict_slashes=False, # Allows skipping trailing slashes
|
|
merge_slashes=False,
|
|
)
|