easydocforms

# Gemfile
gem "easydocforms"

require "easydocforms"

client = EasyDocForms::Client.new(ENV["EASYDOCFORMS_API_KEY"])
pong = client.ping
puts "org #{pong[:org_id]}, key #{pong[:key_name]}, scopes #{pong[:scopes].join(", ")}"

# 1. Import a blank PDF (async — returns immediately).
import = client.create_import(
  pdf_url: "https://example.com/new-patient-intake.pdf",
  filename: "new-patient-intake.pdf",
  blank_form_attestation: true # you attest the PDF is a blank template — no PHI
)

# 2. Wait for processing (typically 1–10 minutes). Imports never fail for
# quality reasons: the template is always created, and :review_required tells
# your staff what to double-check in the EasyDocForms editor.
import = client.wait_for_import(import[:import_id])
raise import[:error] if import[:status] == "failed"

# 3. Mint a hosted fill link and hand it to the patient. No EasyDocForms
# account needed on their side.
link = client.create_fill_link(
  template_id: import[:template_id],
  external_ref: "visit-8675309" # your correlation id — must not contain PHI
)
puts "send the patient to: #{link[:url]}"

# 4. When the patient submits (see webhooks below), fetch the results.
submission = client.get_submission(submission_id)
submission[:answers] # => { field_id => value, ... }

File.binwrite("completed.pdf", client.download_submission_pdf(submission_id))

# Or get a ~10-minute signed URL that needs no Authorization header — safe to
# hand to a browser or EMR without embedding your API key.
begin
  pdf_link = client.get_submission_pdf_link(submission_id)
rescue EasyDocForms::PDFPendingError
  # The frozen artifact isn't ready yet; use download_submission_pdf instead.
end

result = client.create_webhook(url: "https://your-app.example.com/webhooks/easydocforms")
result[:secret] # shown only once — store it now

event = EasyDocForms::Webhook.construct_event(
  payload: request.body.read,
  header:  request.headers[EasyDocForms::Webhook::HEADER],
  secret:  ENV["EASYDOCFORMS_WEBHOOK_SECRET"]
)

case event[:event]
when "submission.created"
  # PHI-minimized: no answers in the payload. Fetch them with your API key
  # via event[:data][:submission_id].
end