API 개요
ZeroTalk API를 사용하여 메시지 전송, 연락처 관리 등의 기능을 서버에서 직접 호출할 수 있습니다.
Base URL
https://api.zeroworks.ai/v1
인증
모든 API 요청에는 Authorization 헤더에 Bearer 토큰이 필요합니다.
curl -X GET https://api.zeroworks.ai/v1/channels \
-H "Authorization: Bearer YOUR_API_TOKEN"
API 토큰은 대시보드 → 설정 → API에서 발급할 수 있습니다.
응답 형식
모든 응답은 JSON 형식입니다.
{
"data": { ... },
"meta": {
"page": 1,
"limit": 20,
"total": 100
}
}
에러 응답
{
"error": {
"code": "UNAUTHORIZED",
"message": "Invalid or expired token"
}
}
| HTTP 상태 | 설명 |
|---|---|
| 200 | 성공 |
| 400 | 잘못된 요청 |
| 401 | 인증 실패 |
| 403 | 권한 없음 |
| 404 | 리소스 없음 |
| 429 | 요청 한도 초과 |
| 500 | 서버 에러 |