Skip to content

API Document

Jump to bottom
tomokon edited this page Mar 5, 2021 · 26 revisions

https://sotesote.tkにAPIサーバーをホストしています。 Docker使える人はローカルでコンテナ起動すればhttp://localhostにホストされます。

フォーマット

  • URL(/api/以下の相対パス、モックのエンドポイントは/mock/の相対パス)
  • Method
  • 説明
  • Request
  • Response

エンドポイント

貸出登録

  • /lending
  • POST
  • 貸す人が貸出情報の登録をする。
Authorization: Bearer <貸す人のアクセストークン>

{
  'content': string (貸したもの),
  'deadline': Datetime (期限)
}

{
  'lendingId': int (作成された貸出id)
}

借りた人登録

  • /lending/{貸出id<string>}
  • PUT
  • 貸出idで指定された貸出情報に、借りた人(アクセストークンから取得)を紐付ける.
Authorization: Bearer <貸す人のアクセストークン>

{
  'lendingId': int (貸出id),
  'content': string (借りたもの),
  'deadline': Datetime (期限),
  'ownerName': string (貸した人の名前)
}

貸したもの一覧取得

  • /owner/lending
  • GET
  • あるユーザの貸したものの一覧を取得する
Authorization: Bearer <貸す人のアクセストークン>

{
  'lendingList': [
                 {
                   'lendingId': int (貸出id),
                   'content': string (貸したもの),
                   'deadline': Datetime (期限),
                   'borrowerName': string (借りた人の名前)
                 },
                 ...
                 ]
}

借りたもの一覧取得

  • /borrower/lending
  • GET
  • あるユーザの借りたものの一覧を取得する
Authorization: Bearer <貸す人のアクセストークン>

{
  'lendingList': [
                 {
                   'lendingId': int (貸出id),
                   'content': string (貸したもの),
                   'deadline': Datetime (期限),
                   'ownerName': string (貸した人の名前)
                 },
                 ...
                 ]
}

返却報告

  • /lending/{貸出id}
  • DELETE
  • 貸出情報のステータスを返却済みにする。アクセストークンから取得したユーザと、貸出idで指定された貸出情報のownerIdのユーザが一致するか検証する。
Authorization: Bearer <貸す人のアクセストークン>

{
  'lendingId': int (貸出id),
  'borrowerName': string (借りた人の名前),
  'content': string (貸すもの),
  'deadline': Datetime (期限)
}

エンドポイント(bot)

  • /bot/~~~

Clone this wiki locally