Attachments

# 1. Create the attachment, and keep its id and upload_url.
IDEMPOTENCY_KEY=$(uuidgen) # Store it with your record of the file: reuse it to retry.
CREATED=$(curl -sS https://api.isnap.ai/v1/attachments \
  -H "Authorization: Bearer $ISNAP_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -d '{"filename":"receipt.pdf","content_type":"application/pdf","size_bytes":48213}')
ATTACHMENT_ID=$(echo "$CREATED" | jq -r '.data.id')
UPLOAD_URL=$(echo "$CREATED" | jq -r '.data.upload_url')

# 2. Upload the file to upload_url, with the required_headers of the response.
#    This request goes to the upload URL: do not send your API key with it.
curl -sS -X PUT "$UPLOAD_URL" \
  -H "content-type: application/pdf" \
  -H "content-length: 48213" \
  --data-binary @receipt.pdf

# 3. Read the attachment, and repeat until its status is ready.
curl -sS "https://api.isnap.ai/v1/attachments/$ATTACHMENT_ID" \
  -H "Authorization: Bearer $ISNAP_API_KEY"

# 4. Send it. One key per call: generate a new one for the message.
IDEMPOTENCY_KEY=$(uuidgen) # Store it with your record of the message: reuse it to retry.
curl -sS https://api.isnap.ai/v1/messages \
  -H "Authorization: Bearer $ISNAP_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -d '{
    "line_id": "line_8Xk2mQ4vTn7Bw9Rz3Lc6Yp1Hd",
    "to": "+14155550123",
    "body": "Your receipt is attached.",
    "attachments": ["'"$ATTACHMENT_ID"'"]
  }'

import { randomUUID } from 'node:crypto'
import { readFile } from 'node:fs/promises'
import { GoneError, ISnapClient } from '@isnap/sdk'

const client = new ISnapClient({ apiKey: process.env.ISNAP_API_KEY ?? '', maxRetries: 2 })

const bytes = new Uint8Array(await readFile('receipt.pdf'))

// 1. Create the attachment. Until the file is uploaded, and before upload_expires_at, a retry with
//    the same key returns the same attachment.
const attachmentKey = randomUUID() // Store it with your record of the file: reuse it to retry.
const created = await client.attachments.create(
  { filename: 'receipt.pdf', content_type: 'application/pdf', size_bytes: bytes.byteLength },
  { idempotencyKey: attachmentKey }
)

// 2. Upload with one PUT and the headers that iSnap returned. No API key goes to this URL.
const upload = await fetch(created.upload_url, {
  method: 'PUT',
  headers: created.required_headers,
  body: bytes
})
if (!upload.ok) throw new Error(`The upload was refused with HTTP ${upload.status}`)

// 3. Wait until the attachment is ready: iSnap checks for the file every 30 seconds.
let status = created.status
try {
  for (let poll = 0; poll < 30 && status !== 'ready' && status !== 'failed'; poll++) {
    await new Promise(resolve => setTimeout(resolve, 10_000))
    status = (await client.attachments.get(created.id)).status
  }
} catch (err) {
  if (err instanceof GoneError && err.code === 'attachment_expired') {
    throw new Error(`Attachment ${created.id} expired: create it again`)
  }
  throw err
}
if (status !== 'ready') {
  // failed: create the attachment again. Still waiting: keep the id and read it again later.
  throw new Error(`Attachment ${created.id} is ${status}`)
}

// 4. Send it, one attachment per message.
const idempotencyKey = randomUUID() // Store it with your record of the message: reuse it to retry.
const message = await client.messages.send(
  {
    line_id: 'line_8Xk2mQ4vTn7Bw9Rz3Lc6Yp1Hd',
    to: '+14155550123',
    body: 'Your receipt is attached.',
    attachments: [created.id]
  },
  { idempotencyKey }
)
console.log(message.id, message.status)

import os
import time
import uuid

import requests

API = "https://api.isnap.ai"
HEADERS = {"Authorization": f"Bearer {os.environ['ISNAP_API_KEY']}"}

with open("receipt.pdf", "rb") as file:
    data = file.read()

# 1. Create the attachment. Until the file is uploaded, and before upload_expires_at, a retry with
#    the same key returns the same attachment.
attachment_key = str(uuid.uuid4())  # Store it with your record of the file: reuse it to retry.
response = requests.post(
    f"{API}/v1/attachments",
    headers={**HEADERS, "Idempotency-Key": attachment_key},
    json={"filename": "receipt.pdf", "content_type": "application/pdf", "size_bytes": len(data)},
    timeout=30,
)
response.raise_for_status()
created = response.json()["data"]

# 2. Upload with one PUT and the headers that iSnap returned. No API key goes to this URL.
upload = requests.put(created["upload_url"], headers=created["required_headers"], data=data, timeout=300)
upload.raise_for_status()

# 3. Wait until the attachment is ready: iSnap checks for the file every 30 seconds.
status = created["status"]
for _ in range(30):
    if status in ("ready", "failed"):
        break
    time.sleep(10)
    current = requests.get(f"{API}/v1/attachments/{created['id']}", headers=HEADERS, timeout=30)
    if current.status_code == 410:
        # attachment_expired: create the attachment again.
        raise SystemExit(f"Attachment {created['id']} expired")
    current.raise_for_status()
    status = current.json()["data"]["status"]
if status != "ready":
    # failed: create the attachment again. Still waiting: keep the id and read it again later.
    raise SystemExit(f"Attachment {created['id']} is {status}")

# 4. Send it, one attachment per message.
idempotency_key = str(uuid.uuid4())  # Store it with your record of the message: reuse it to retry.
response = requests.post(
    f"{API}/v1/messages",
    headers={**HEADERS, "Idempotency-Key": idempotency_key},
    json={
        "line_id": "line_8Xk2mQ4vTn7Bw9Rz3Lc6Yp1Hd",
        "to": "+14155550123",
        "body": "Your receipt is attached.",
        "attachments": [created["id"]],
    },
    timeout=30,
)
response.raise_for_status()
message = response.json()["data"]
print(message["id"], message["status"])