5분 만에 첫 알림 보내기

API_KEY=<발급받은 api_key>

# [정방향] 내 앱이 코드 표시 → 사용자가 EosNoti 앱에 입력
curl -s -X POST https://api.eosnoti.com/v1/pairing-codes \
  -H "Authorization: Bearer $API_KEY" -H "Content-Type: application/json" \
  -d '{"external_id":"user_8821"}'
# ← {"code":"AB7K9P","url":"https://www.eosnoti.com/s/AB7K9P","expires_at":"..."}
curl -s https://api.eosnoti.com/v1/pairing-codes/AB7K9P \
  -H "Authorization: Bearer $API_KEY"
# ← {"status":"pending|redeemed|expired","subscription_id":...}

# 같은 코드를 QR로도 낼 수 있다 — 6자리가 아니라 «url»을 QR로 그린다.
# 폰 기본 카메라로 찍어도 앱이 열리고, 앱이 없으면 설치 안내로 폴백한다.
# 입력이든 스캔이든 위 폴링 하나가 redeemed로 바뀐다(발급도 폴링도 그대로).

# [역방향] EosNoti 앱이 코드 표시 → 사용자가 내 앱에 입력 → redeem
curl -s -X POST https://api.eosnoti.com/v1/pairing-codes/X9Q3MR/redeem \
  -H "Authorization: Bearer $API_KEY" -H "Content-Type: application/json" \
  -d '{"external_id":"user_8821"}'
# ← {"subscription_id":"...","external_id":"user_8821"}

API_KEY=<발급받은 api_key>

# external_id를 담은 subscribe-link 발급
curl -s -X POST https://api.eosnoti.com/v1/subscribe-links \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"external_id":"user_8821","ttl":86400}'   # ttl 초, 0/생략=24h
#                                                 상한 30일(2592000) — 초과·음수는 400
# ← {"url":".../s/<code>","code":"<code>","expires_at":"..."}

# ① url을 문자·메신저로 그대로 전달 → 사용자가 폰에서 탭하면 EosNoti 앱이 열림
#    (앱 미설치면 설치 안내 웹페이지로 폴백)
# ② 또는 url을 QR로 표시 → 사용자가 EosNoti 앱 "코드 추가 → QR 스캔"으로 스캔
# 어느 쪽이든 앱이 기기 등록·구독·external_id 바인딩까지 자동 처리

# 구독 여부 조용히 확인 (발송·쿼터 소비 없음). 구독/미구독 모두 200 동일 스키마
curl -s "https://api.eosnoti.com/v1/subscriptions/lookup?external_id=user_8821" \
  -H "Authorization: Bearer $API_KEY"
# ← {"subscribed":true,"device_count":2,"push_enabled":true,"platforms":["ios","android"]}
#   미구독이면 {"subscribed":false,"device_count":0,"push_enabled":false,"platforms":[]}

API_KEY=<발급받은 api_key>

# 한 사람에게 (그 사람의 모든 기기 — iOS·Android — 로, notify)
# icon  = 알림 좌측 발신자 아바타 (생략 시 콘솔에서 설정한 애플리케이션(채널) 아바타)
# image = 콘텐츠 이미지 → 알림 우측 썸네일(iOS)·이미지 첨부(Android) + 인박스 카드
#         (둘 다 http(s) URL만, 메시지당 1장. body에 URL을 적어도 이미지로 안 보임)
#         파일을 직접 올리시려면 아래 5단계 ②를 보십시오
curl -X POST https://api.eosnoti.com/v1/messages \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"to":"ext:user_8821","kind":"notify",
       "title":"결제 완료","body":"주문 #2043이 접수됐습니다","priority":"high",
       "icon":"https://console.eosnoti.com/icon.png",
       "image":"https://example.com/receipt-2043.jpg"}'

# 구독자 전체에게 + 선택지 묻기 (ask)
curl -X POST https://api.eosnoti.com/v1/messages \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"to":"broadcast","kind":"ask",
       "body":"회의 참석하시겠습니다?","choices":["참석","불참"]}'

# ① 링크로 보내기 — 모든 요금제, 무제한. 저희는 아무것도 보관하지 않습니다.
curl -X POST https://api.eosnoti.com/v1/messages \
  -H "Authorization: Bearer $API_KEY" -H "Content-Type: application/json" \
  -d '{"to":"ext:user_8821","body":"주문이 접수됐습니다",
       "image":"https://example.com/receipt-2043.jpg"}'

# ② 올려서 보내기 — 유료 요금제. JPEG만, 한 장 2MB까지, 7일 뒤 자동 삭제.
#    동시 보관 장수는 요금제마다 다릅니다(Free는 0 — ①번 링크 방식만). 요금제 안내 참고.
URL=$(curl -s -X POST https://api.eosnoti.com/v1/images \
  -H "Authorization: Bearer $API_KEY" -H "Content-Type: image/jpeg" \
  --data-binary @photo.jpg | jq -r .url)
# ← {"url":"...","expires_at":"...","used":13,"quota":100}   quota=-1이면 무제한

curl -X POST https://api.eosnoti.com/v1/messages \
  -H "Authorization: Bearer $API_KEY" -H "Content-Type: application/json" \
  -d "{\"to\":\"ext:user_8821\",\"body\":\"주문이 접수됐습니다\",\"image\":\"$URL\"}"

# 보관 장수를 다 쓰면 409 image_quota_exceeded, 무료 요금제는 403 plan_required.
# 어느 쪽이든 ①번 링크 방식은 그대로 쓰실 수 있습니다.

API_KEY=<발급받은 api_key>
MSG=<message_id>

# 전달·읽음 수 + 응답 조회
curl -s https://api.eosnoti.com/v1/messages/$MSG \
  -H "Authorization: Bearer $API_KEY"
# ← {"deliveries":{...},"replies":[...],"replies_total":1}
#    replies는 미리보기 200건까지 — 전체는 아래 /replies를 커서로 훑습니다

# ask 응답 롱폴링 (최대 30초) + 페이징
curl -s "https://api.eosnoti.com/v1/messages/$MSG/replies?wait=30&limit=200" \
  -H "Authorization: Bearer $API_KEY"
# ← {"replies":[...],"next_cursor":"<있으면 더 있음>"}
#    limit 기본 200 · 최대 1000. next_cursor를 &cursor= 로 넘겨 이어서 받습니다
#    (커서를 주면 «그 뒤의 새 응답»만 기다리므로 롱폴링이 실제로 대기합니다)

# 연결 확인(조용히): GET /v1/subscriptions/lookup?external_id= (위 3단계 참고)
# 발송 겸용이면 이 응답의 queued_deliveries>0 로도 확인 가능
# (구독자 목록 조회는 콘솔 세션 전용 — 백엔드 api_key로는 401)