Report an Issue¶

POST /api/v1/libraries/{slug}/report

Report a problem with an approved library. Reports are reviewed by moderators.

Auth required: Yes (Bearer token)

Content type: multipart/form-data

Path parameters¶

Parameter	Type	Description
`slug`	string	URL slug of the library to report

Fields¶

Field	Type	Required	Description
`reason`	string	Yes	Issue category (see values below)
`details`	string	No	Free-text description of the issue (max 2000 chars)
`photo`	file	No	Photo showing the issue (JPEG/PNG, max 5 MB)

Reason values¶

Value	Description
`damaged`	The library is physically damaged
`missing`	The library is no longer at this location
`incorrect_info`	Listed information (address, name, etc.) is wrong
`inappropriate`	Inappropriate content found in the library
`other`	Other issue not covered above

Examples¶

curlPython

curl -X POST https://bookcorners.org/api/v1/libraries/berlin-friedrichstr-12-corner-books/report \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..." \
  -F "reason=damaged" \
  -F "details=The door hinge is broken and books are getting wet." \
  -F "photo=@issue.jpg"

import requests

resp = requests.post(
    "https://bookcorners.org/api/v1/libraries/berlin-friedrichstr-12-corner-books/report",
    headers={"Authorization": f"Bearer {access_token}"},
    data={
        "reason": "damaged",
        "details": "The door hinge is broken and books are getting wet.",
    },
    files={"photo": open("issue.jpg", "rb")},
)
print(resp.json())

Report without a photo¶