API Documentation - slack-integrated-bot/slack-integration-bot GitHub Wiki

All header

  • ํ•ด๋‹น ์–ดํ”Œ๋ฆฌ์ผ€์ด์…˜์˜ ๋ชจ๋“  ์š”์ฒญ์€ ์ธ์ฆํ‚ค๊ฐ’์ด ํ•„์ˆ˜์ ์œผ๋กœ ํ•„์š”ํ•ฉ๋‹ˆ๋‹ค.
  • ๋”ฐ๋ผ์„œ ํŒ€๋งˆ๋‹ค ์ œ๊ณต๋˜๋Š” ํ‚ค๊ฐ’์„ ํ•ญ์ƒ ํฌํ•จํ•˜์—ฌ์•ผ ์ธ์ฆ์ด ํ†ต๊ณผ๋ฉ๋‹ˆ๋‹ค.
  • ํ—ค๋”์— ์•„๋ž˜์˜ ์š”์ฒญ์„ ํ•ญ์ƒ ๋ณด๋‚ด์–ด์•ผํ•ฉ๋‹ˆ๋‹ค.
Authorization: woowateams-secret-key

error case

  • header์— ํ‚ค๊ฐ’์ด ์กด์žฌํ•˜์ง€ ์•Š๋Š” ๊ฒฝ์šฐ
HTTP/1.1 401 Unauthorized
  • header์˜ ํ‚ค๊ฐ’์ด ์ œ๊ณต๋œ ํ‚ค๊ฐ€ ์•„๋‹Œ ๊ฒฝ์šฐ
HTTP/1.1 401 Unauthorized

์ฑ„๋„ ๋ฉ”์‹œ์ง€ ์ „๋‹ฌ

POST /api/send

  • request body

    • request body์˜ ๊ฒฝ์šฐ slack์—์„œ ์ „์†ก๊ฐ€๋Šฅํ•œ ๋ชจ๋“  ์ผ€์ด์Šค๋ฅผ ์ œ๊ณตํ•˜๊ธฐ ์œ„ํ•ด slack์—์„œ ์ œ๊ณต๋˜๋Š” SlackPostMessageRequest ์˜ json format์„ ๊ทธ๋Œ€๋กœ ๋”ฐ๋ผ๊ฐ€๊ณ  ์žˆ์Šต๋‹ˆ๋‹ค.
    • json format์˜ ๊ฒฝ์šฐ ๋งํฌ ์ฐธ์กฐ ๋ถ€ํƒ๋“œ๋ฆฝ๋‹ˆ๋‹ค.
  • response body

HTTP/1.1 200 OK

error case

  • ์ฑ„๋„์ด ์กด์žฌํ•˜์ง€ ์•Š๋Š” ๊ฒฝ์šฐ
HTTP/1.1 404 not found
  • ์„œ๋ฒ„์™€ ์Šฌ๋ž™์˜ ์—ฐ๊ฒฐ์ด ์›ํ• ํ•˜์ง€ ์•Š๋Š” ๊ฒฝ์šฐ
HTTP/1.1 500 internal server error

workspace ๋‚ด ๋ชจ๋“  ์œ ์ € ์ •๋ณด ์กฐํšŒ

GET /api/users

  • request body
none
  • response body
HTTP/1.1 200 OK
{
  "members": [
    {
      "id": "USLACKBOT",
      "profile": {
        "email": null
      }
    },
    {
      "id": "U03U987DB0W",
      "profile": {
        "email": "[email protected]"
      }
    },
    {
      "id": "U03V5H72L1W",
      "profile": {
        "email": "[email protected]"
      }
    }
  ]
}

workspace์— ์ถ”๊ฐ€๋˜์–ด์žˆ๋Š” bot๋“ค๋„ ๋ชจ๋‘ ํฌํ•จ์ด ๋˜๋ฉฐ, bot๋“ค์€ email์ด null๋กœ ํ‘œ๊ธฐ๋  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

error case

  • ์„œ๋ฒ„์™€ ์Šฌ๋ž™์˜ ์—ฐ๊ฒฐ์ด ์›ํ• ํ•˜์ง€ ์•Š๋Š” ๊ฒฝ์šฐ
HTTP/1.1 500 internal server error