Ping 연동 — 가장 간단한 방법
Ping 엔드포인트는 GET 요청 한 번으로 Cronjob 상태를 보고하는 가장 간단한 연동 방식입니다.
SDK 설치나 HTTP 라이브러리 없이 curl · wget · Invoke-WebRequest 등 어떤 도구로도 호출할 수 있습니다.
GET 방식은 에러 메시지를 URL 쿼리(?msg=)로만 전달할 수 있습니다. 상세 로그가 필요하면 REST API (POST) 를 사용하세요.
엔드포인트
모든 경로에서 {token}은 대시보드에서 발급받은 API 토큰입니다.
| Method | Path | 설명 |
|---|---|---|
| GET | /api/v1/ping/{token} | 기본 ping — start + success를 한 번에 처리 |
| GET | /api/v1/ping/{token}/start | 실행 시작 (실행 시간 측정 시작) |
| GET | /api/v1/ping/{token}/success | 정상 완료 |
| GET | /api/v1/ping/{token}/fail | 실패 (?msg= 로 짧은 메시지 전달 가능) |
프로덕션 호스트: https://api.cronbark.com
사용 예
가장 짧은 형태
# 스크립트가 끝날 때 성공 보고
*/10 * * * * /scripts/backup.sh && curl -s https://api.cronbark.com/api/v1/ping/abc123시작 + 결과 모두 보고
#!/bin/bash
HOST="https://api.cronbark.com/api/v1/ping/abc123"
curl -s "$HOST/start"
./my_script.sh
if [ $? -eq 0 ]; then
curl -s "$HOST/success"
else
curl -s "$HOST/fail?msg=backup+script+failed"
fi실패 메시지 포함
# URL 인코딩 필수 — 공백은 +, 특수문자는 %XX로
curl -s "https://api.cronbark.com/api/v1/ping/abc123/fail?msg=DB+connection+refused"⚠️
msg 파라미터는 URL 길이 한계(보통 2000자)에 제약됩니다. 긴 스택트레이스는 REST API POST를 사용해 body로 전송하세요.
언어별 예제
curl -s https://api.cronbark.com/api/v1/ping/{token}/start
curl -s https://api.cronbark.com/api/v1/ping/{token}/success응답 형식
모든 ping 엔드포인트는 JSON을 반환합니다:
{
"status": "ok",
"message": "실행이 시작되었습니다.",
"execution_id": "550e8400-e29b-41d4-a716-446655440000"
}HTTP 상태 코드:
200— 정상 접수401— 토큰이 유효하지 않음404— 토큰이 삭제된 Cronjob에 연결됨
다음 단계
- REST API (POST) — 에러 로그까지 전송
- 상태 판정 로직 — 어떤 경우에 지연/타임아웃으로 판정되는지