Endpoint Komunitas

Referensi lengkap untuk endpoint NexCommunity.

URL Dasar

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

Feed Komunitas

Dapatkan Feed

GET /api/v1/community/feed/

Parameter Query

Parameter	Tipe	Deskripsi
page	integer	Nomor halaman
page_size	integer	Hasil per halaman
filter	string	Filter berdasarkan tipe (recent, trending, friends)

Respons

{
  "count": 50,
  "results": [
    {
      "id": "post-001",
      "type": "qr_shared",
      "user": {
        "id": 123,
        "username": "johndoe",
        "avatar": "https://api.govalid.org/media/avatars/123.jpg"
      },
      "qr_code": {
        "id": "abc123",
        "title": "Sertifikat Produk",
        "trust_score": 85
      },
      "created_at": "2025-01-29T12:00:00Z"
    }
  ]
}

Trust Vote

Cast Vote

POST /api/v1/community/vote/

Body Request

{
  "qr_id": "abc123",
  "vote": "trust"
}

Nilai vote: trust, distrust, neutral

Respons

{
  "success": true,
  "qr_trust_score": 85,
  "total_votes": 150
}

Komentar

Tambah Komentar

POST /api/v1/community/comments/

Body Request

{
  "qr_id": "abc123",
  "content": "Sertifikat ini terlihat sah!"
}

Daftar Komentar

GET /api/v1/community/comments/?qr_id=abc123

Teman

Daftar Teman

GET /api/v1/community/friends/

Kirim Permintaan Teman

POST /api/v1/community/friends/request/

Body Request

{
  "user_id": 456
}

Terima/Tolak Permintaan Teman

POST /api/v1/community/friends/{id}/accept/
POST /api/v1/community/friends/{id}/reject/

Badge

Daftar Badge

GET /api/v1/community/badges/

Respons

{
  "badges": [
    {
      "id": "early-adopter",
      "name": "Early Adopter",
      "description": "Bergabung saat beta",
      "icon": "https://api.govalid.org/media/badges/early-adopter.png",
      "earned": true,
      "earned_at": "2024-06-01T00:00:00Z"
    },
    {
      "id": "active-scanner",
      "name": "Active Scanner",
      "description": "100+ scan",
      "icon": "https://api.govalid.org/media/badges/active-scanner.png",
      "earned": false,
      "progress": 75
    }
  ]
}

Pencarian

Cari Komunitas

GET /api/v1/community/search/?q=query

Parameter Query

Parameter	Tipe	Deskripsi
q	string	Query pencarian
type	string	Filter berdasarkan tipe (users, qr_codes, hubs)

Gambar Pendamping

Upload Gambar Pendamping

POST /api/v1/community/companion-images/

Body Request (multipart/form-data)

Field	Tipe	Deskripsi
qr_id	string	ID QR code
image	file	File gambar
caption	string	Caption opsional

Terkait

• Panduan NexCommunity - Panduan pengguna
• Endpoint QR - Manajemen QR code
• Autentikasi - Autentikasi API