Dokumentasi/API/API provider/GET /api/v1/providers/{slug}

Pahami detail provider publik yang aktif.

Endpoint ini dipakai saat aplikasi atau sistem eksternal perlu membaca satu provider yang sudah tayang tanpa membuka dashboard internal.

IkhtisarProviderPencarian & discoveryAI & MCPVIC & data publik

Auth dan validasi

  • Autentikasi: tidak perlu.
  • Path wajib: slug.
  • Jika slug tidak ditemukan atau provider belum tayang, endpoint mengembalikan BUSINESS_NOT_FOUND dengan status 404.
GET /api/v1/providers/acme-studio

Cakupan data

  • Hanya provider dengan submissionStatus=approved dan publishedAt terisi yang bisa dibaca.
  • Bentuk field tetap ringkas dan mengikuti proyeksi toBusinessSummary.
  • Endpoint ini tidak memuat data dashboard seperti catatan moderasi atau status internal lain.

Field respons yang penting

  • slug, companyName, tagline, city, dan country dipakai untuk identitas dasar provider.
  • capabilityTags memberi ringkasan layanan yang aktif pada permukaan publik.
  • trustLevel, confidenceScore, overallRating, dan totalReviews dipakai untuk evaluasi awal.
  • Field seperti avgHourlyRate, industryFocus, dan languagesSupported tetap berada di respons walau tidak selalu ditampilkan penuh di semua tampilan.

Respons sukses

{
  "data": {
    "id": "provider-1",
    "slug": "acme-studio",
    "companyName": "Acme Studio",
    "tagline": "Build web apps",
    "city": "Jakarta",
    "country": "ID",
    "trustLevel": 3,
    "confidenceScore": "0.800",
    "overallRating": "4.80",
    "totalReviews": 12,
    "capabilityTags": ["website", "seo"]
  }
}

Respons error

{
  "error": {
    "code": "BUSINESS_NOT_FOUND",
    "message": "Bisnis tidak ditemukan atau belum dipublikasikan.",
    "details": null
  }
}