Sefera Developers
v1.2 OpenAPI

Resources

AI Integration

Canonical machine-readable resources for coding agents.

Server-to-server

If you are an AI coding agent integrating Sefera Partner API:

  1. Read: /openapi.yaml
  2. Read: /llms-full.txt
  3. Use: https://api.sefera.com.tr
  4. Store Partner API token only in server-side secret/env storage.
  5. Never generate frontend code containing the token.
  6. Never send companyId.
  7. Use GET /v1/programs to discover program IDs.
  8. Use GET /v1/programs/{programId} for detail.
  9. Handle: 401, 403, 404, 429, 500.
  10. Respect Retry-After on 429.
  11. Preserve X-Request-Id for debugging.
  12. Do not depend on undocumented fields.
  13. Be tolerant of new optional fields being added within V1.