Going live
Use this checklist before you switch from a test key to a live key. Live analyses use real credits and return real results.
Organizations only
The Grihafy API is available to organizations only. Individual accounts cannot create API keys. To get an organization account, contact us. We create the organization and add credits; you then create your own API keys.
Before you switch
Access and credits
- Your organization has credits. Call
GET /v1/creditswith the live key and check thatavailableis above zero. See Credits. - The live key is stored in your server configuration, not in code or browser bundles. See Authentication.
- You monitor
availableandexpiringSoon. There is no low-balance alert yet.
Submitting
- You send an
Idempotency-Keyand keep it while you retry. See Idempotency. - You send a real
northAngleif you know it, and you chose areviewModeon purpose. See Review flows. - You handle
402,429and503by waiting and retrying, and you handle422 image_unreadableby asking for another image. See Errors.
Results and notifications
- Your webhook endpoint uses HTTPS, verifies the signature, ignores duplicate event IDs, and ignores unknown event types. See Webhooks.
- Your code handles every final status:
completed,failedandexpired. See Analyses. - Your code answers
review_requiredanalyses, or you only use modes that cannot pause. - You log the
requestIdof failed calls so we can help quickly.
What differs from the sandbox
- Results are real and different for each floor plan.
- Each analysis uses one credit while it runs. The credit is returned if it fails or expires.
- Analyses can end as
failedand review steps can expire after about 7 days. - Processing is not instant. No response-time guarantee is published yet, so wait for webhooks or poll patiently.
- Reports can be requested in Hindi or Arabic; translation finishes after the English report.
Try one live analysis first
Submit one real floor plan with the live key, check the credit balance before and after, and confirm your webhook receives the analysis.completed event with livemode: true.