푸시 알림 이미지 첨부
알림에 그림을 붙이는 방법은 두 가지입니다. 어느 쪽을 고르느냐로 요금제도, 보관 기간도 달라집니다.
두 가지 방법
이미 공개된 주소에 그림이 있다면 링크 방식이 낫습니다. 요금제 제한이 없고, 저희가 아무것도 보관하지 않으므로 만료도 없습니다. 파일밖에 없을 때만 올려서 보내십시오.
① 링크로 보내기
image에 http(s) 주소를 주면 끝입니다. 모든 요금제에서 쓸 수 있고 장수 제한이 없습니다. 대신 그 주소가 계속 열려 있어야 합니다 — 닿지 않는 주소는 수신자 화면에서 빈 자리로 남습니다.
# 모든 요금제, 장수 제한 없음. 저희는 아무것도 보관하지 않는다.
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"}'② 올려서 보내기
파일을 저희에게 올리고 받은 주소를 그대로 image에 넣습니다. JPEG만, 한 장 2MB까지, 7일 뒤 자동으로 지워집니다. 동시에 보관할 수 있는 장수는 요금제마다 다릅니다.
# JPEG만, 한 장 2MB까지, 7일 뒤 자동 삭제
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입니다. 앞은 만료를 기다리면 다시 올릴 수 있고, 뒤는 요금제를 올려야 합니다. 어느 쪽이든 링크 방식은 그대로 쓸 수 있으니, 실패하면 링크로 물러서게 짜 두십시오.
보관 기간이 지나면
7일이 지난 그림은 지워지고, 그 자리에는 「보관 기간이 지났습니다」라는 안내가 뜹니다. 카드가 깨진 그림으로 남지 않습니다. 오래 남아야 하는 그림이라면 링크 방식으로 보내십시오.
icon과 헷갈리지 마십시오
icon은 발신자 아바타(왼쪽 동그라미)이고 image는 내용 그림(오른쪽·카드)입니다. 아바타를 따로 주지 않으면 콘솔에서 설정한 애플리케이션 아바타가 쓰입니다.