From 3746cbe8aac4b82f763f1a65f3195a194b6b3af2 Mon Sep 17 00:00:00 2001 From: Martin Renvoize Date: Thu, 6 Jan 2022 12:59:42 +0000 Subject: [PATCH] Bug 29810: Add summary of x-koha-embed header to api spec Signed-off-by: Martin Renvoize Signed-off-by: Tomas Cohen Arazi Signed-off-by: Jonathan Druart --- api/v1/swagger/swagger.yaml | 17 ++++++++++++++++- 1 file changed, 16 insertions(+), 1 deletion(-) diff --git a/api/v1/swagger/swagger.yaml b/api/v1/swagger/swagger.yaml index 1118cd129ce..42deb9ccfbb 100644 --- a/api/v1/swagger/swagger.yaml +++ b/api/v1/swagger/swagger.yaml @@ -449,6 +449,9 @@ info: "OR" query: `{ "field1": "value2", "field2": "value2" }` will filter the response to only those results with both field1 containing value2 AND field2 containing value2 for example. + Additionally, if you are requesting related data be embedded into the response one can query + on the related data using dot notation in the field names. + ### Examples The following request would return any patron with firstname "Henry" and lastname "Acevedo"; @@ -459,12 +462,24 @@ info: `curl -u koha:koha --request GET "http://127.0.0.1:8081/api/v1/patrons/" --data-raw "{ "surname": { "-like": "Ace%" }"` - The following request would return any patron whilse lastname is "Acevedo" OR "Bernardo" + The following request would return any patron whose lastname is "Acevedo" OR "Bernardo" `curl -u koha:koha --request GET "http://127.0.0.1:8081/api/v1/patrons/" --data-raw "{ "surname": [ "Acevedo", "Bernardo" ] }"` + The following request embeds the related patron extended attributes data and filters on it. + + `curl -u koha:koha =--request GET 'http://127.0.0.1:8081/api/v1/patrons/' --header 'x-koha-embed: extended_attributes' --data-raw '{ "extended_attributes.code": "internet", "extended_attributes.attribute": "1" }'` + ## Special headers + ### x-koha-embed + + This optional header allows the api consumer to request additional related data + to be returned in the api response. It also allows for cross referencing in the + queries as described above. It accepts a comma delimited list of relation names. + + Relations may on occasion also support dot delimited nesting to allow traversal. + ### x-koha-library This optional header should be passed to give your api request a library -- 2.25.1