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์ ๊ฒฝ์ฐ ๋งํฌ ์ฐธ์กฐ ๋ถํ๋๋ฆฝ๋๋ค.
- request body์ ๊ฒฝ์ฐ slack์์ ์ ์ก๊ฐ๋ฅํ ๋ชจ๋ ์ผ์ด์ค๋ฅผ ์ ๊ณตํ๊ธฐ ์ํด slack์์ ์ ๊ณต๋๋
-
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