잡아요
잡아요 › API 문서

API 문서

주소 하나에 값을 보내면 문의가 접수됩니다. 키를 만들고 복사해서 붙이면 끝이라, 홈페이지 제작 업체에 이 페이지 주소만 전달하셔도 됩니다.

1. 키 만들기

로그인 후 설정 → API 연동에서 키를 만듭니다. jb_ 로 시작하는 문자열이 나옵니다.

2. 문의 보내기

POST https://kryft.io/api/jabayo/v1/leads

curl -X POST https://kryft.io/api/jabayo/v1/leads \
  -H "X-API-Key: jb_여기에_발급받은_키" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "홍길동",
    "tel": "01012345678",
    "message": "32평 아파트 전체 리모델링 문의합니다",
    "예산": "4~6천만원",
    "희망시기": "10월"
  }'

필수tel 또는 email 중 하나뿐입니다. 나머지는 아무 이름으로나 넣으셔도 그대로 저장되어 상담카드에 표시됩니다. 한글 항목명도 됩니다.

3. 응답

{ "ok": true, "lead_id": 1234 }

접수되면 손님에게 확인 문자가, 사장님에게 알림 문자가 즉시 나갑니다.

4. 문의 목록 가져오기

curl https://kryft.io/api/jabayo/v1/leads \
  -H "X-API-Key: jb_여기에_발급받은_키"

HTML 폼에서 바로 쓰기

제작 업체 없이도 홈페이지에 이 코드를 넣으면 연결됩니다.

<script>
async function sendLead(form) {
  const r = await fetch('https://kryft.io/api/jabayo/v1/leads', {
    method: 'POST',
    headers: { 'X-API-Key': 'jb_여기에_키', 'Content-Type': 'application/json' },
    body: JSON.stringify({
      name: form.name.value, tel: form.tel.value, message: form.message.value
    })
  });
  const d = await r.json();
  alert(d.ok ? '문의가 접수되었습니다' : d.error);
}
</script>

키는 공개된 곳에 두지 마세요. 위 예제처럼 웹페이지에 직접 넣으면 누구나 볼 수 있습니다. 가능하면 서버를 거쳐 호출하시고, 어렵다면 키가 노출돼도 바로 새 키로 교체할 수 있게 만들어 두었습니다.

제한

  • API 는 기본 플랜부터 사용할 수 있습니다
  • 키 하나당 시간당 600건
  • 키는 계정당 5개까지
키 만들러 가기