health

Health

Liveness/readiness probes.

2 نقاط النهاية

GET `/api/v1/health/live`

Liveness probe — process is up.

بدون مصادقةالصلاحيةعامة

مثال بأمر curl

curl

curl -X GET "https://your-institute.example/api/v1/health/live" \
  -H "Authorization: Bearer $INSTITFLOW_API_KEY"

الاستجابات

200The process is running.

الاسم	النوع	القيود
statusمطلوب	enum: "ok"	—

json

{
  "status": "ok"
}

400The request could not be read at all — unparseable body, unusable content type, oversized payload (`MALFORMED_REQUEST`). Never a schema failure: those are 422.

تُعيد مغلّف الخطأ المشترك `ErrorEnvelope` — `{ error: { code, message, requestId, details? } }`. جميع الرموز مذكورة في دليل الاصطلاحات.

401Missing, expired or invalid credentials (`UNAUTHORIZED`, `TOKEN_INVALID`, `SESSION_REVOKED`).

تُعيد مغلّف الخطأ المشترك `ErrorEnvelope` — `{ error: { code, message, requestId, details? } }`. جميع الرموز مذكورة في دليل الاصطلاحات.

403Authenticated, but not allowed (`FORBIDDEN`, `FEATURE_DISABLED`, `QUOTA_EXCEEDED`, …).

تُعيد مغلّف الخطأ المشترك `ErrorEnvelope` — `{ error: { code, message, requestId, details? } }`. جميع الرموز مذكورة في دليل الاصطلاحات.

404No such resource, or it is not visible to this tenant (`NOT_FOUND`).

تُعيد مغلّف الخطأ المشترك `ErrorEnvelope` — `{ error: { code, message, requestId, details? } }`. جميع الرموز مذكورة في دليل الاصطلاحات.

409Conflicts with current state (`CONFLICT`, `VERSION_CONFLICT`, `IDEMPOTENCY_KEY_REUSED`).

تُعيد مغلّف الخطأ المشترك `ErrorEnvelope` — `{ error: { code, message, requestId, details? } }`. جميع الرموز مذكورة في دليل الاصطلاحات.

422The request was read but its content is not acceptable: body/query/path/header failed schema validation (`VALIDATION_ERROR`, with `details.issues`), or a domain rule rejected a well-formed value (`VIDEO_URL_INVALID`, …).

تُعيد مغلّف الخطأ المشترك `ErrorEnvelope` — `{ error: { code, message, requestId, details? } }`. جميع الرموز مذكورة في دليل الاصطلاحات.

429Rate limit exceeded — see the `RateLimit-*` and `Retry-After` headers (`RATE_LIMITED`).

تُعيد مغلّف الخطأ المشترك `ErrorEnvelope` — `{ error: { code, message, requestId, details? } }`. جميع الرموز مذكورة في دليل الاصطلاحات.

500Unexpected server error (`INTERNAL_ERROR`). Never carries a stack trace or SQL.

تُعيد مغلّف الخطأ المشترك `ErrorEnvelope` — `{ error: { code, message, requestId, details? } }`. جميع الرموز مذكورة في دليل الاصطلاحات.

GET `/api/v1/health/ready`

Readiness probe — dependencies (Postgres, Redis) are reachable.

بدون مصادقةالصلاحيةعامة

مثال بأمر curl

curl

curl -X GET "https://your-institute.example/api/v1/health/ready" \
  -H "Authorization: Bearer $INSTITFLOW_API_KEY"

الاستجابات

200All dependencies are reachable.

الاسم	النوع	القيود
statusمطلوب	enum: "ok" \| "error"	—
checksمطلوب	object	—

json

{
  "status": "ok",
  "checks": {
    "postgres": {
      "status": "ok"
    },
    "redis": {
      "status": "ok"
    }
  }
}