Lewati ke konten utama

Endpoint Institusi

Referensi lengkap untuk endpoint manajemen institusi dan organisasi.

URL Dasar​

https://api.govalid.org/api/v1/institution/

Pengaturan Institusi​

Dapatkan Pengaturan​

GET /api/v1/institution/settings/

Respons​

{
  "id": "inst-001",
  "name": "Acme Corporation",
  "type": "business",
  "departments_count": 5,
  "staff_count": 50,
  "settings": {
    "default_security_level": "verified",
    "require_approval": true,
    "quota_enabled": true
  }
}

Update Pengaturan​

PATCH /api/v1/institution/settings/

Departemen​

Daftar Departemen​

GET /api/v1/institution/departments/

Respons​

{
  "count": 5,
  "results": [
    {
      "id": "dept-001",
      "name": "Quality Assurance",
      "staff_count": 10,
      "quota": {
        "qr_codes_per_month": 500,
        "used": 250
      },
      "created_at": "2025-01-01T00:00:00Z"
    }
  ]
}

Buat Departemen​

POST /api/v1/institution/departments/

Body Request​

{
  "name": "Quality Assurance",
  "description": "Kualitas dan verifikasi produk",
  "quota": {
    "qr_codes_per_month": 500
  }
}

Update Departemen​

PATCH /api/v1/institution/departments/{id}/

Hapus Departemen​

DELETE /api/v1/institution/departments/{id}/

Peran​

Daftar Peran​

GET /api/v1/institution/roles/

Respons​

{
  "count": 4,
  "results": [
    {
      "id": "role-001",
      "name": "Admin",
      "permissions": ["create_qr", "manage_staff", "view_analytics", "manage_billing"],
      "staff_count": 3
    },
    {
      "id": "role-002",
      "name": "Operator",
      "permissions": ["create_qr", "view_analytics"],
      "staff_count": 20
    }
  ]
}

Buat Peran​

POST /api/v1/institution/roles/

Body Request​

{
  "name": "Verifier",
  "permissions": ["create_qr", "verify_qr"]
}

Pola Penomoran​

Daftar Pola​

GET /api/v1/institution/patterns/

Buat Pola​

POST /api/v1/institution/patterns/

Body Request​

{
  "name": "Pola Sertifikat",
  "pattern": "CERT-{YYYY}-{SEQ}",
  "prefix": "CERT",
  "sequence_length": 4
}

Tipe Dokumen​

Daftar Tipe Dokumen​

GET /api/v1/institution/document-types/

Buat Tipe Dokumen​

POST /api/v1/institution/document-types/

Body Request​

{
  "name": "Sertifikat",
  "description": "Dokumen sertifikasi produk",
  "numbering_pattern": "pattern-001",
  "required_fields": ["product_name", "batch", "issue_date"]
}

Pengaturan Kuota​

Dapatkan Pengaturan Kuota​

GET /api/v1/institution/quota/

Update Kuota​

PATCH /api/v1/institution/quota/

Body Request​

{
  "department_id": "dept-001",
  "qr_codes_per_month": 1000
}

Manajemen Staf​

Daftar Anggota Staf​

GET /api/v1/institution/staff/

Undang Anggota Staf​

POST /api/v1/institution/staff/invite/

Body Request​

{
  "email": "[email protected]",
  "role_id": "role-002",
  "department_id": "dept-001"
}

Setujui/Tolak Verifikasi Staf​

POST /api/v1/institution/staff/{id}/approve/
POST /api/v1/institution/staff/{id}/reject/

Terkait​