Getting Started

Use this path to go from access request to first successful Partner API call with the public contract and the correct security posture.

---

1. Request approved access

Contact info@nowtoprint.com with:

• company name and website
• integration use case
• expected volume or rollout stage
• whether you need webhooks, XJDF, or partner-specific onboarding

---

2. Create a sandbox key

After approval, generate a sandbox credential in the partner portal Developer area.

Environment	Prefix	Base URL
Sandbox	ntp_test_*	https://api.nowtoprint.com/api/v1
Production	ntp_live_*	https://api.nowtoprint.com/api/v1

Use sandbox first. Production credentials should only be enabled after validation and rollout approval.

---

3. Import the contract

Start from the published OpenAPI file:

• /docs/api/openapi.yaml

Import that URL into Postman, Bruno, or Insomnia before writing production code. It keeps payloads, examples, and expected responses aligned with the public contract.

---

4. Send a first request

Use an estimate request to validate auth, payload shape, and environment wiring:

curl -X POST https://api.nowtoprint.com/api/v1/estimate \
  -H "Authorization: Bearer ntp_test_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "category": "flyer",
    "quantity": 1000
  }'

Once that succeeds, continue into RFQ creation and quote handling.

---

5. Prepare for production

Before live traffic:

• rotate away any shared onboarding keys
• store the production key in managed secrets
• implement webhook verification
• log request IDs and honor Retry-After
• test idempotent retry handling on write operations

---

Next steps