ਵਾਟਰ ਮੀਟਰ OCR API

ਵਾਟਰ ਮੀਟਰ OCR API. ਇਹ ਪੰਨਾ ਤੀਜੀ-ਧਿਰ ਦੇ ਏਕੀਕਰਣ ਲਈ ਵੈਬਸਾਈਟ ਬੈਕਐਂਡ ਦੁਆਰਾ ਪ੍ਰਗਟ ਕੀਤੇ ਜਨਤਕ HTTP API ਨੂੰ ਦਸਤਾਵੇਜ਼ ਦਿੰਦਾ ਹੈ।

ਇੱਕ ਅਸਲੀ ਅੱਪਲੋਡ ਨਾਲ ਸ਼ੁਰੂ ਕਰੋ

ਪਹਿਲਾਂ ਰਜਿਸਟਰ ਕਰੋ, ਵਰਕਸਪੇਸ ਵਿੱਚ ਆਪਣੀ ਵਾਟਰ ਮੀਟਰ ਫੋਟੋ ਅੱਪਲੋਡ ਕਰੋ, ਅਤੇ ਫਿਰ ਜਦੋਂ ਤੁਸੀਂ ਏਕੀਕ੍ਰਿਤ ਕਰਨ ਲਈ ਤਿਆਰ ਹੋਵੋ ਤਾਂ ਇੱਕ API ਕੁੰਜੀ ਬਣਾਓ।

ਰਜਿਸਟਰ ਕਰੋ ਅਤੇ ਇੱਕ ਫੋਟੋ ਅੱਪਲੋਡ ਕਰੋ ਇੱਕ API ਕੁੰਜੀ ਬਣਾਓ

ਅੰਤਮ ਬਿੰਦੂ ਖੋਜੋ

ਸੰਖੇਪ ਜਾਣਕਾਰੀ

ਸਾਰੇ ਬਾਹਰੀ ਏਕੀਕਰਣਾਂ ਲਈ ਵੈਬਸਾਈਟ ਬੈਕਐਂਡ ਦੀ ਵਰਤੋਂ ਕਰੋ।
ਤੀਜੀ-ਧਿਰ ਦੇ ਪ੍ਰੋਗਰਾਮਾਂ ਤੋਂ ਸਿੱਧੇ waterMeterAi ਨੂੰ ਕਾਲ ਨਾ ਕਰੋ।
ਓਪਨ API ਵੈੱਬ ਪੋਰਟਲ ਦੇ ਤੌਰ 'ਤੇ ਉਹੀ ਉਪਭੋਗਤਾਵਾਂ, ਕੋਟਾ, ਕੈਸ਼, ਕਾਰਜ, ਅਤੇ ਆਡਿਟ ਨਿਯਮਾਂ ਨੂੰ ਸਾਂਝਾ ਕਰਦਾ ਹੈ।
ਬੈਕਐਂਡ ਤੈਨਾਤੀ ਸੰਰਚਨਾ ਅਨੁਸਾਰ ਵੱਖ-ਵੱਖ ਡਾਊਨਸਟ੍ਰੀਮ AI ਸੇਵਾਵਾਂ ਚੁਣ ਸਕਦਾ ਹੈ।
ਕਾਰਜ ਜਵਾਬਾਂ ਵਿੱਚ ਹੁਣ ਆਮ result_summary ਵਸਤੂ ਸ਼ਾਮਲ ਹੈ, ਤਾਂ ਜੋ ਵੱਖ-ਵੱਖ ਸੇਵਾਵਾਂ ਵੱਖ-ਵੱਖ ਨਤੀਜੇ ਕਿਸਮਾਂ ਦਿਖਾ ਸਕਣ।

ਪ੍ਰਮਾਣਿਕਤਾ

ਵੈੱਬਸਾਈਟ 'ਤੇ ਸਾਈਨ ਇਨ ਕਰੋ ਅਤੇ API ਕੁੰਜੀਆਂ ਪੰਨੇ 'ਤੇ ਇੱਕ API ਕੁੰਜੀ ਬਣਾਓ।
ਪੂਰੀ API ਕੁੰਜੀ ਸਿਰਫ਼ ਇੱਕ ਵਾਰ ਦਿਖਾਈ ਜਾਂਦੀ ਹੈ ਜਦੋਂ ਇਹ ਬਣਾਈ ਜਾਂਦੀ ਹੈ।
ਹਰ ਬੇਨਤੀ 'ਤੇ Authorization ਸਿਰਲੇਖ ਵਿੱਚ ਕੁੰਜੀ ਭੇਜੋ।

Authorization: Bearer wm_xxxxxxxxxxxxxxxxx

API Key Permissions and Limits

Each API key can have independent scopes, an IPv4/IPv6/CIDR allowlist, a total requests-per-minute limit, and a task submissions-per-minute limit.
A valid key without the required scope or outside its source IP allowlist returns 403.
Every valid-key request consumes the total request limit, including requests rejected by scope, IP, or submission policy.
Batch requests consume one total request unit and one submission unit per uploaded file.
Rate-limited responses return 429 with Retry-After and both X-RateLimit-* and X-SubmissionLimit-* headers.
Task creation also has a per-key concurrency limit and returns X-ConcurrencyLimit-* headers; a concurrency rejection uses 429.
For batch concurrency, only files that pass image validation reserve slots, and success headers report the actual active slots after task binding.

Retry-After: 30
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 59
X-RateLimit-Reset: 1785902400
X-SubmissionLimit-Limit: 10
X-SubmissionLimit-Remaining: 9
X-ConcurrencyLimit-Limit: 3
X-ConcurrencyLimit-Active: 1
X-ConcurrencyLimit-Remaining: 2

ਅਪਲੋਡ ਨਿਯਮ

ਅਧਿਕਤਮ ਫ਼ਾਈਲ ਆਕਾਰ: ਪ੍ਰਤੀ ਚਿੱਤਰ 20MB।
ਸਮਰਥਿਤ ਫਾਰਮੈਟ: JPEG, PNG, WEBP।
ਬੈਕਐਂਡ ਅਸਲ ਫਾਈਲ ਸਮੱਗਰੀ ਨੂੰ ਪ੍ਰਮਾਣਿਤ ਕਰਦਾ ਹੈ, ਨਾ ਕਿ ਸਿਰਫ ਫਾਈਲ ਐਕਸਟੈਂਸ਼ਨ।

ਅੱਪਲੋਡ ਆਕਾਰ ਲਾਗੂ

ਬੈਚ ਅੱਪਲੋਡ 20MB ਪ੍ਰਤੀ-ਚਿੱਤਰ ਸੀਮਾ ਅਤੇ 20MB ਕੁੱਲ ਫ਼ਾਈਲ-ਸਮੱਗਰੀ ਸੀਮਾ ਦੇ ਨਾਲ, ਮੂਲ ਰੂਪ ਵਿੱਚ 8 ਚਿੱਤਰਾਂ ਤੱਕ ਸਵੀਕਾਰ ਕਰਦੇ ਹਨ।
ਇੱਕ ਫਾਈਲ ਜਾਂ ਬੈਚ ਜੋ ਆਪਣੀ ਸੀਮਾ ਤੋਂ ਵੱਧ ਜਾਂਦਾ ਹੈ, ਚਿੱਤਰ ਪ੍ਰਮਾਣਿਕਤਾ ਜਾਂ ਕਾਰਜ ਬਣਾਉਣ ਤੋਂ ਪਹਿਲਾਂ 413 ਵਾਪਸ ਕਰਦਾ ਹੈ; ਕੋਈ ਅੰਸ਼ਕ ਬੈਚ ਨਹੀਂ ਬਣਾਇਆ ਗਿਆ ਹੈ।
ਬੈਕਐਂਡ ਅਸਲ ਪ੍ਰਾਪਤ ਕੀਤੀ ਬਾਈਟ ਗਿਣਤੀ ਨੂੰ ਲਾਗੂ ਕਰਦਾ ਹੈ ਭਾਵੇਂ Content-Length ਗੁੰਮ ਹੋਵੇ ਜਾਂ ਟੁਕੜੇ ਟ੍ਰਾਂਸਫਰ ਦੀ ਵਰਤੋਂ ਕੀਤੀ ਜਾਂਦੀ ਹੋਵੇ।

ਟਾਸਕ ਸਟੇਟਸ

queued: ਸਵੀਕਾਰ ਕੀਤਾ ਗਿਆ ਹੈ ਅਤੇ AI ਪ੍ਰੋਸੈਸਿੰਗ ਦੀ ਉਡੀਕ ਕਰ ਰਿਹਾ ਹੈ।
running: ਇਸ ਵੇਲੇ ਪ੍ਰਕਿਰਿਆ ਜਾਰੀ ਹੈ, ਜਾਂ ਡਿਸਪੈਚਰ ਨੂੰ ਸੌਂਪਣ ਤੋਂ ਬਾਅਦ ਅੰਤਿਮ ਨਤੀਜੇ ਦੀ ਸਥਿਤੀ ਨਿਯਮਤ ਤੌਰ 'ਤੇ ਜਾਂਚੀ ਜਾ ਰਹੀ ਹੈ।
batch_waiting_ai: ਬੈਚ ਵਿੱਚ ਹਰ ਆਈਟਮ AI ਸੇਵਾ ਦੇ ਔਨਲਾਈਨ ਵਾਪਸ ਆਉਣ ਦੀ ਉਡੀਕ ਕਰ ਰਹੀ ਹੈ।
batch_running: ਬੈਚ ਪਹਿਲਾਂ ਹੀ ਡਿਸਪੈਚਰ ਨੂੰ ਸੌਂਪਿਆ ਗਿਆ ਹੈ ਅਤੇ ਅਜੇ ਵੀ ਪ੍ਰਕਿਰਿਆ ਕਰ ਰਿਹਾ ਹੈ।
done: ਸਫਲਤਾਪੂਰਵਕ ਸਮਾਪਤ ਹੋਇਆ।
failed: ਪ੍ਰੋਸੈਸਿੰਗ ਅਸਫਲ।
waiting_ai: AI ਸੇਵਾ ਵਾਪਸ ਔਨਲਾਈਨ ਆਉਣ ਤੱਕ ਕਤਾਰ ਵਿੱਚ ਰਹਿੰਦਾ ਹੈ, ਫਿਰ ਆਪਣੇ ਆਪ ਮੁੜ ਸ਼ੁਰੂ ਹੁੰਦਾ ਹੈ।

ਨਤੀਜੇ ਸਰੋਤ

fresh: ਇੱਕ ਨਵੇਂ AI ਰਨ ਦੁਆਰਾ ਤਿਆਰ ਕੀਤਾ ਗਿਆ।
cached_exact: ਮੌਜੂਦਾ AI ਸੰਸਕਰਣ ਕੈਸ਼ ਨਾਲ ਮੇਲ ਖਾਂਦਾ ਹੈ।
cached_stale: AI ਔਫਲਾਈਨ, ਤਾਜ਼ਾ ਕੈਸ਼ ਨਤੀਜਾ ਵਾਪਸ ਆਇਆ।
pending: ਅਜੇ ਕੋਈ ਅੰਤਮ ਨਤੀਜਾ ਨਹੀਂ ਹੈ।
failed: ਕਾਰਜ ਅਸਫਲ ਰਿਹਾ।
ਜਦੋਂ ਕੋਈ ਕੰਮ ਅਜੇ ਪੂਰਾ ਨਹੀਂ ਹੋਇਆ ਹੈ, ਤਾਂ ਨਵੀਨਤਮ ਮੁੜ ਕੋਸ਼ਿਸ਼ ਜਾਂ ਉਡੀਕ ਕਾਰਨ ਲਈ error_message ਦੀ ਜਾਂਚ ਕਰੋ।

ਕੋਟਾ ਅਤੇ ਬਿਲਿੰਗ

ਜੇਕਰ ਤੁਹਾਡੇ ਏਕੀਕਰਣ ਨੂੰ ਕੋਟਾ ਫੇਲ੍ਹ ਹੋਣ ਤੋਂ ਬਚਣ ਦੀ ਲੋੜ ਹੈ ਤਾਂ ਵੱਡੇ ਵਰਕਲੋਡ ਨੂੰ ਸਪੁਰਦ ਕਰਨ ਤੋਂ ਪਹਿਲਾਂ `GET /api/open/quota` ਦੀ ਵਰਤੋਂ ਕਰੋ।
ਸਿਰਫ਼ `fresh` AI ਚੱਲਦਾ ਹੈ ਖਪਤ ਕੋਟਾ।
`cached_exact`, `cached_stale`, `pending`, ਅਤੇ `failed` ਨਤੀਜੇ ਕੋਟੇ ਦੀ ਵਰਤੋਂ ਨਹੀਂ ਕਰਦੇ ਹਨ।
ਮੁਫਤ ਖਾਤੇ ਪਹਿਲਾਂ ਰੋਜ਼ਾਨਾ ਕੋਟੇ ਦੀ ਵਰਤੋਂ ਕਰਦੇ ਹਨ। ਭੁਗਤਾਨ ਕੀਤੇ ਖਾਤੇ ਬੈਕਐਂਡ ਨੀਤੀ ਦੇ ਅਨੁਸਾਰ ਕਿਰਿਆਸ਼ੀਲ ਸਮੇਂ-ਸਮੇਂ ਦੇ ਕੋਟਾ ਪੈਕੇਜਾਂ ਦੀ ਵਰਤੋਂ ਕਰਦੇ ਹਨ, ਫਿਰ ਅਸਥਾਈ ਜਾਂ ਸਥਿਰ ਕੋਟਾ।
ਜਦੋਂ ਕੋਟਾ ਖਤਮ ਹੋ ਜਾਂਦਾ ਹੈ, ਤਾਂ ਟਾਸਕ ਸਬਮਿਸ਼ਨ `429` ਵਾਪਸ ਕਰਦਾ ਹੈ ਅਤੇ ਨਵਾਂ ਕੰਮ ਬਣਾਉਣ ਦੀ ਬਜਾਏ ਇੱਕ ਗਲਤੀ ਸੁਨੇਹਾ ਸ਼ਾਮਲ ਕਰਦਾ ਹੈ।

ਕੈਸ਼ ਅਤੇ ਨਤੀਜੇ ਦੀ ਤਾਜ਼ਗੀ

ਬੈਕਐਂਡ ਚਿੱਤਰ ਹੈਸ਼ ਅਤੇ AI ਸੰਸਕਰਣ ਅਨੁਸਾਰ ਸਫਲ ਨਤੀਜੇ ਕੈਸ਼ ਕਰਦਾ ਹੈ; ਇਸ ਵਿੱਚ ਡਾਊਨਸਟ੍ਰੀਮ ਸੇਵਾ ਦਾ namespace ਵੀ ਸ਼ਾਮਲ ਹੈ।
`cached_exact` ਦਾ ਮਤਲਬ ਹੈ ਕਿ ਮੌਜੂਦਾ AI ਸੰਸਕਰਣ ਲਈ ਇੱਕੋ ਚਿੱਤਰ ਦਾ ਪਹਿਲਾਂ ਹੀ ਸਫਲ ਨਤੀਜਾ ਹੈ, ਇਸਲਈ ਕਿਸੇ ਨਵੇਂ AI ਨੂੰ ਚਲਾਉਣ ਦੀ ਲੋੜ ਨਹੀਂ ਸੀ।
`cached_stale` ਦਾ ਮਤਲਬ ਹੈ AI ਸੇਵਾ ਔਫਲਾਈਨ ਹੈ ਅਤੇ ਬੈਕਐਂਡ ਨੇ ਤਾਜ਼ਾ ਉਪਲਬਧ ਇਤਿਹਾਸਕ ਨਤੀਜਾ ਵਾਪਸ ਕੀਤਾ ਹੈ।
ਜਦੋਂ `is_latest_ai_version` ਦਾ ਮੁੱਲ false ਹੋਵੇ, ਨਤੀਜੇ ਨੂੰ ਵਰਤੋਂਯੋਗ ਪਰ ਸਮੀਖਿਆਯੋਗ ਇਤਿਹਾਸਕ ਡੇਟਾ ਵਜੋਂ ਸੰਭਾਲੋ।
ਹਰ `done` ਟਾਸਕ ਖਪਤ ਕੋਟਾ ਨਾ ਮੰਨੋ; ਚੈੱਕ ਕਰੋ `result_source`।

Task completion webhooks

Send signed task completion events to your HTTPS endpoint with automatic retries.
This API key is inactive. Existing records remain available, but new, enabled, test, and secret-rotation operations are blocked.

X-WaterMeter-Webhook-Id: whev_new_event
X-WaterMeter-Webhook-Replay-Of: whev_original_event
replay_of_event_id: whev_original_event
blocked endpoint management: HTTP 409
canceled delivery status: canceled

GET`/api/open/quota`

ਮੌਜੂਦਾ ਕੋਟਾ ਅਤੇ ਬਾਕੀ ਵਰਤੋਂ ਪੜ੍ਹੋ।

ਉਦਾਹਰਨ ਲਈ ਬੇਨਤੀ ਕਰੋ

curl -X GET "https://watermeterai.com/api/open/quota" \
  -H "Authorization: Bearer wm_xxxxxxxxxxxxxxxxx"

ਜਵਾਬ ਉਦਾਹਰਨ

{
  "ok": true,
  "email": "[email protected]",
  "quota": {
    "account_type": "free",
    "daily_limit": 20,
    "used": 3,
    "remaining": 17,
    "day_tag": "2026-06-01",
    "is_unlimited": false,
    "monthly_remaining": 0,
    "monthly_bonus_remaining": 0,
    "fixed_remaining": 0,
    "nearest_expire_at": null,
    "quota_summary_text": "Free daily quota: 3/20 used today. Remaining: 17."
  }
}

GET`/api/open/ai-status`

ਟਾਸਕ ਸਬਮਿਸ਼ਨ ਅਤੇ ਕੈਸ਼-ਨਤੀਜਾ ਫਾਲਬੈਕ ਲਈ ਜਨਤਕ ਸੇਵਾ ਸਥਿਤੀ ਪੜ੍ਹੋ।

ਉਦਾਹਰਨ ਲਈ ਬੇਨਤੀ ਕਰੋ

curl -X GET "https://watermeterai.com/api/open/ai-status" \
  -H "Authorization: Bearer wm_xxxxxxxxxxxxxxxxx"

ਜਵਾਬ ਉਦਾਹਰਨ

{
  "ok": true,
  "is_online": true,
  "busy": false,
  "active_jobs": 0,
  "public_status": "online",
  "public_status_label": "online",
  "public_status_reason": "ready",
  "accepts_new_tasks": true,
  "can_return_cached_result": true,
  "queue_state": "idle",
  "queue_count": 0,
  "current_ai_version": "water_v2:wm-ai-v2-2026-06-01",
  "last_checked_at": "2026-06-01T06:15:30Z"
}

POST`/api/open/tasks`

ਇੱਕ ਚਿੱਤਰ ਅੱਪਲੋਡ ਕਰੋ ਅਤੇ ਇੱਕ ਸਿੰਗਲ ਟਾਸਕ ਬਣਾਓ।

ਉਦਾਹਰਨ ਲਈ ਬੇਨਤੀ ਕਰੋ

curl -X POST "https://watermeterai.com/api/open/tasks" \
  -H "Authorization: Bearer wm_xxxxxxxxxxxxxxxxx" \
  -F "file=@D:\data\meter_001.jpg"

ਜਵਾਬ ਉਦਾਹਰਨ

{
  "ok": true,
  "task_id": "8e6c4d1f8f8348c0bc53e2e39d2dc111",
  "status": "queued",
  "result_source": "pending",
  "visibility": "private",
  "ai_online": true,
  "is_latest_ai_version": false,
  "final_reading": "-",
  "result_summary": {
    "resultKind": "unknown",
    "primaryLabel": "Result",
    "primaryValue": "-",
    "secondaryLabel": "Detail",
    "secondaryValue": "-",
    "summaryText": "No result is available yet."
  },
  "error_message": "",
  "created_at": "2026-06-01T06:16:10Z"
}

GET`/api/open/tasks/{task_id}`

ਇੱਕ ਕੰਮ ਦੀ ਸਥਿਤੀ ਅਤੇ ਅੰਤਮ ਰੀਡਿੰਗ ਪੜ੍ਹੋ।

ਉਦਾਹਰਨ ਲਈ ਬੇਨਤੀ ਕਰੋ

curl -X GET "https://watermeterai.com/api/open/tasks/task_a" \
  -H "Authorization: Bearer wm_xxxxxxxxxxxxxxxxx"

ਜਵਾਬ ਉਦਾਹਰਨ

{
  "ok": true,
  "task_id": "8e6c4d1f8f8348c0bc53e2e39d2dc111",
  "status": "done",
  "result_source": "fresh",
  "ai_online": true,
  "is_latest_ai_version": true,
  "final_reading": "123.45",
  "meter_type": "pointer",
  "success": "yes",
  "result_summary": {
    "resultKind": "water_meter",
    "primaryLabel": "Final Reading",
    "primaryValue": "123.45",
    "secondaryLabel": "Meter Type",
    "secondaryValue": "pointer",
    "summaryText": "Water meter recognition finished."
  },
  "error_message": "",
  "created_at": "2026-06-01T06:16:10Z"
}

GET`/api/open/tasks`

ਮੌਜੂਦਾ API ਕੁੰਜੀ ਉਪਭੋਗਤਾ ਦੀ ਮਲਕੀਅਤ ਵਾਲੇ ਹਾਲੀਆ ਕਾਰਜ ਪੜ੍ਹੋ।

ਉਦਾਹਰਨ ਲਈ ਬੇਨਤੀ ਕਰੋ

curl -X GET "https://watermeterai.com/api/open/tasks?limit=20" \
  -H "Authorization: Bearer wm_xxxxxxxxxxxxxxxxx"

ਜਵਾਬ ਉਦਾਹਰਨ

{
  "ok": true,
  "items": [
    {
      "task_id": "8e6c4d1f8f8348c0bc53e2e39d2dc111",
      "status": "done",
      "result_source": "cached_exact",
      "final_reading": "123.45",
      "meter_type": "pointer",
      "success": "yes",
      "result_summary": {},
      "ai_online": true,
      "is_latest_ai_version": true,
      "created_at": "2026-06-01T06:16:10Z",
      "error_message": ""
    }
  ]
}

POST`/api/open/batches`

ਇੱਕ ਬੇਨਤੀ ਵਿੱਚ ਕਈ ਚਿੱਤਰ ਅੱਪਲੋਡ ਕਰੋ।

ਉਦਾਹਰਨ ਲਈ ਬੇਨਤੀ ਕਰੋ

curl -X POST "https://watermeterai.com/api/open/batches" \
  -H "Authorization: Bearer wm_xxxxxxxxxxxxxxxxx" \
  -F "files=@D:\data\meter_001.jpg" \
  -F "files=@D:\data\meter_002.jpg"

ਜਵਾਬ ਉਦਾਹਰਨ

{
  "ok": true,
  "batch_id": "5a14f4e5f6d34fdabce00e62c0dd0001",
  "status": "batch_running",
  "total_count": 2,
  "done_count": 0,
  "failed_count": 0,
  "pending_count": 2,
  "items": [
    {
      "index": 0,
      "file_name": "meter_001.jpg",
      "task_id": "task_a",
      "status": "queued",
      "result_source": "pending",
      "final_reading": "-",
      "failure_kind": "",
      "error_message": ""
    },
    {
      "index": 1,
      "file_name": "meter_002.jpg",
      "task_id": "task_b",
      "status": "queued",
      "result_source": "pending",
      "final_reading": "-",
      "failure_kind": "",
      "error_message": ""
    }
  ]
}

GET`/api/open/batches/{batch_id}`

ਬੈਚ ਪ੍ਰਗਤੀ ਅਤੇ ਪ੍ਰਤੀ-ਫਾਈਲ ਟਾਸਕ ਸਟੇਟਸ ਪੜ੍ਹੋ।

ਉਦਾਹਰਨ ਲਈ ਬੇਨਤੀ ਕਰੋ

curl -X GET "https://watermeterai.com/api/open/batches/5a14f4e5f6d34fdabce00e62c0dd0001" \
  -H "Authorization: Bearer wm_xxxxxxxxxxxxxxxxx"

ਜਵਾਬ ਉਦਾਹਰਨ

{
  "ok": true,
  "batch_id": "5a14f4e5f6d34fdabce00e62c0dd0001",
  "status": "batch_done",
  "total_count": 2,
  "done_count": 2,
  "failed_count": 0,
  "pending_count": 0,
  "items": [
    {
      "index": 0,
      "file_name": "meter_001.jpg",
      "task_id": "task_a",
      "status": "done",
      "result_source": "fresh",
      "final_reading": "123.45",
      "failure_kind": "",
      "error_message": ""
    },
    {
      "index": 1,
      "file_name": "meter_002.jpg",
      "task_id": "task_b",
      "status": "done",
      "result_source": "cached_exact",
      "final_reading": "456.78",
      "failure_kind": "",
      "error_message": ""
    }
  ]
}

ਸਿਫ਼ਾਰਿਸ਼ ਕੀਤੀ ਪ੍ਰਵਾਹ

ਵੱਡੇ ਵਰਕਲੋਡ ਭੇਜਣ ਤੋਂ ਪਹਿਲਾਂ `GET /api/open/ai-status` ਦੀ ਜਾਂਚ ਕਰੋ।
ਸਬਮਿਸ਼ਨ ਤੋਂ ਤੁਰੰਤ ਬਾਅਦ ਆਪਣੇ ਸਿਸਟਮ ਵਿੱਚ `task_id` ਜਾਂ `batch_id` ਸਟੋਰ ਕਰੋ।
`queued`, `running`, `waiting_ai`, `batch_waiting_ai`, ਅਤੇ `batch_running` ਨੂੰ ਗੈਰ-ਅੰਤਿਮ ਸਥਿਤੀਆਂ ਮੰਨੋ ਅਤੇ ਸਥਿਤੀ ਜਾਂਚਦੇ ਰਹੋ।
ਜਦੋਂ ਬੈਕਐਂਡ ਤੱਕ ਨੈੱਟਵਰਕ ਵਿੱਚ ਜ਼ਿਆਦਾ ਦੇਰੀ ਹੋਵੇ ਅਤੇ ਤੈਨਾਤ ਸੇਵਾ ਬੈਚ ਮੋਡ ਦਾ ਸਮਰਥਨ ਕਰੇ, ਤਾਂ ਬੈਚ ਬੇਨਤੀਆਂ ਵਰਤੋ।
ਬੈਚ ਬੇਨਤੀਆਂ ਵਰਤਮਾਨ ਵਿੱਚ `webBackend -> dispatchCenter -> waterMeterAi` ਰਾਹੀਂ ਵਹਿ ਰਹੀਆਂ ਹਨ।
`batch_waiting_ai` ਦਾ ਮਤਲਬ ਹੈ ਕਿ ਹਰ ਆਈਟਮ ਅਜੇ ਵੀ AI ਸੇਵਾ ਦੀ ਉਡੀਕ ਕਰ ਰਹੀ ਹੈ, ਅਜੇ ਸਰਗਰਮੀ ਨਾਲ ਨਹੀਂ ਚੱਲ ਰਹੀ।
ਜਦੋਂ ਤੈਨਾਤ ਸੇਵਾ `CAD` ਹੋਵੇ, ਤਾਂ ਫਿਲਹਾਲ `POST /api/open/tasks` ਵਰਤੋ ਅਤੇ ਬੈਚ ਅੱਪਲੋਡ ਨੂੰ ਅਣਉਪਲਬਧ ਮੰਨੋ।

ਗਲਤੀ ਨੋਟਸ

400: ਅਵੈਧ ਬੇਨਤੀ, ਜਾਂ ਤੈਨਾਤ ਸੇਵਾ ਬੈਚ ਅੱਪਲੋਡ ਦਾ ਸਮਰਥਨ ਨਹੀਂ ਕਰਦੀ।
401: ਗੁੰਮ, ਅਵੈਧ, ਮਿਆਦ ਪੁੱਗ ਗਈ, ਜਾਂ ਅਯੋਗ API ਕੁੰਜੀ।
403: the user account is not active, the key lacks the required scope, or the source IP is outside the key allowlist.
404: ਟਾਸਕ ਜਾਂ ਬੈਚ ਨਹੀਂ ਮਿਲਿਆ, ਜਾਂ ਮੌਜੂਦਾ ਉਪਭੋਗਤਾ ਦੀ ਮਲਕੀਅਤ ਨਹੀਂ ਹੈ।
413: ਫਾਈਲ ਬਹੁਤ ਵੱਡੀ ਹੈ।
415: ਅਸਮਰਥਿਤ ਚਿੱਤਰ ਕਿਸਮ ਜਾਂ ਅਵੈਧ ਚਿੱਤਰ ਸਮੱਗਰੀ।
429: quota exhausted or the API key request, submission, or concurrency limit was exceeded.

400 ਬੈਚ ਅੱਪਲੋਡ ਉਪਲਬਧ ਨਹੀਂ ਹੈ

{
  "detail": "batch upload is not supported for business: cax"
}

401 ਗੁੰਮ ਜਾਂ ਅਵੈਧ API ਕੁੰਜੀ

{
  "ok": false,
  "error": "unauthorized",
  "message": "Missing or invalid API key."
}

413 ਫ਼ਾਈਲ ਬਹੁਤ ਵੱਡੀ ਹੈ

{
  "ok": false,
  "error": "file_too_large",
  "message": "Maximum file size is 20MB."
}

429 ਕੋਟਾ ਖਤਮ ਹੋ ਗਿਆ ਹੈ

{
  "ok": false,
  "error": "quota_exhausted",
  "message": "Quota exhausted.",
  "quota": {
    "remaining": 0,
    "quota_summary_text": "Free daily quota: 20/20 used today. Remaining: 0."
  }
}

ਵਰਕਫਲੋ ਦੀ ਜਾਂਚ ਕਰਨ ਲਈ ਤਿਆਰ ਹੋ?

ਪਹਿਲੀ ਫੋਟੋ ਲਈ ਵੈੱਬ ਵਰਕਸਪੇਸ ਦੀ ਵਰਤੋਂ ਕਰੋ, ਫਿਰ API ਕੁੰਜੀਆਂ 'ਤੇ ਜਾਓ ਜਦੋਂ ਨਤੀਜਾ ਫਾਰਮੈਟ ਤੁਹਾਡੇ ਸਿਸਟਮ ਨੂੰ ਫਿੱਟ ਕਰਦਾ ਹੈ।

ਰਜਿਸਟਰ ਕਰੋ ਅਤੇ ਇੱਕ ਫੋਟੋ ਅੱਪਲੋਡ ਕਰੋ ਇੱਕ API ਕੁੰਜੀ ਬਣਾਓ

ਵਾਟਰ ਮੀਟਰ OCR API

ਇੱਕ ਅਸਲੀ ਅੱਪਲੋਡ ਨਾਲ ਸ਼ੁਰੂ ਕਰੋ

ਸੰਖੇਪ ਜਾਣਕਾਰੀ

ਪ੍ਰਮਾਣਿਕਤਾ

API Key Permissions and Limits

ਅਪਲੋਡ ਨਿਯਮ

ਅੱਪਲੋਡ ਆਕਾਰ ਲਾਗੂ

ਟਾਸਕ ਸਟੇਟਸ

ਨਤੀਜੇ ਸਰੋਤ

ਕੋਟਾ ਅਤੇ ਬਿਲਿੰਗ

ਕੈਸ਼ ਅਤੇ ਨਤੀਜੇ ਦੀ ਤਾਜ਼ਗੀ

Task completion webhooks

GET/api/open/quota

GET/api/open/ai-status

POST/api/open/tasks

GET/api/open/tasks/{task_id}

GET/api/open/tasks

POST/api/open/batches

GET/api/open/batches/{batch_id}

ਸਿਫ਼ਾਰਿਸ਼ ਕੀਤੀ ਪ੍ਰਵਾਹ

ਗਲਤੀ ਨੋਟਸ

ਵਰਕਫਲੋ ਦੀ ਜਾਂਚ ਕਰਨ ਲਈ ਤਿਆਰ ਹੋ?

GET`/api/open/quota`

GET`/api/open/ai-status`

POST`/api/open/tasks`

GET`/api/open/tasks/{task_id}`

GET`/api/open/tasks`

POST`/api/open/batches`

GET`/api/open/batches/{batch_id}`