curl https://api.bottari.ai/v1/users/me \
-H "Authorization: Bearer $BOTTARI_TOKEN" \
-H "Bottari-Version: 2026-03-11"
{
"object": "user",
"id": "22222222-2222-4222-8222-222222222222",
"name": "주문 동기화",
"avatar_url": null,
"type": "bot",
"bot": {
"owner": {
"type": "workspace",
"workspace": true
},
"workspace_name": "예시 팀",
"workspace_id": "exampleTeam1",
"workspace_limits": {
"max_file_upload_size_in_bytes": 0
}
},
"request_id": "33333333-3333-4333-8333-333333333333"
}
{
"object": "error",
"status": 401,
"code": "unauthorized",
"message": "API token is invalid.",
"request_id": "33333333-3333-4333-8333-333333333333",
"additional_data": {
"reason": "token_invalid"
}
}
사용자
내 연동 읽기
토큰의 연동 봇을 읽습니다. 권한과 상관없이 응답합니다.
GET
/
v1
/
users
/
me
curl https://api.bottari.ai/v1/users/me \
-H "Authorization: Bearer $BOTTARI_TOKEN" \
-H "Bottari-Version: 2026-03-11"
{
"object": "user",
"id": "22222222-2222-4222-8222-222222222222",
"name": "주문 동기화",
"avatar_url": null,
"type": "bot",
"bot": {
"owner": {
"type": "workspace",
"workspace": true
},
"workspace_name": "예시 팀",
"workspace_id": "exampleTeam1",
"workspace_limits": {
"max_file_upload_size_in_bytes": 0
}
},
"request_id": "33333333-3333-4333-8333-333333333333"
}
{
"object": "error",
"status": 401,
"code": "unauthorized",
"message": "API token is invalid.",
"request_id": "33333333-3333-4333-8333-333333333333",
"additional_data": {
"reason": "token_invalid"
}
}
토큰을 확인할 때 사용합니다.
id는 이 연동이 쓴 행의 created_by와 last_edited_by에 들어가는 봇 ID입니다.
string
필수
Bearer <토큰> 형식입니다. 토큰 자세히 알아보기 →string
선택 항목입니다.
2026-03-11만 받습니다. 빼면 현재 버전을 사용하고, 다른 값을 보내면 400을 반환합니다.string
연동 봇의 ID입니다.
string
연동 이름입니다.
string
항상
bot입니다.string
팀 ID입니다.
string
팀 이름입니다.
number
파일 업로드가 없어 항상 0입니다.
오류
| 상태 | code | 원인 |
|---|---|---|
| 400 | validation_error | Bottari-Version이 다릅니다. |
| 401 | unauthorized | 토큰이 없거나 틀렸습니다. |
| 429 | rate_limited | 호출 횟수를 넘겼습니다. |
curl https://api.bottari.ai/v1/users/me \
-H "Authorization: Bearer $BOTTARI_TOKEN" \
-H "Bottari-Version: 2026-03-11"
{
"object": "user",
"id": "22222222-2222-4222-8222-222222222222",
"name": "주문 동기화",
"avatar_url": null,
"type": "bot",
"bot": {
"owner": {
"type": "workspace",
"workspace": true
},
"workspace_name": "예시 팀",
"workspace_id": "exampleTeam1",
"workspace_limits": {
"max_file_upload_size_in_bytes": 0
}
},
"request_id": "33333333-3333-4333-8333-333333333333"
}
{
"object": "error",
"status": 401,
"code": "unauthorized",
"message": "API token is invalid.",
"request_id": "33333333-3333-4333-8333-333333333333",
"additional_data": {
"reason": "token_invalid"
}
}