Find out what people think of the app you built with AI.

<body>
  <h1>Resultado da busca</h1>
  ...
  <div data-tbbc-rating data-section="search"></div>

  <script src="https://tbbc.app/rating-widget/rating.js" data-site="SUA_CHAVE" data-app="meu-app" async></script>
</body>

'use client' // Next.js App Router. Remove it elsewhere.
import { useEffect, useRef } from 'react'

const SRC = 'https://tbbc.app/rating-widget/rating.js'

export function TbbcRating({ section, site = 'SUA_CHAVE', app = 'meu-app' }) {
  const ref = useRef(null)

  useEffect(() => {
    const mount = () => window.TBBCRating && window.TBBCRating.mount(ref.current)
    if (window.TBBCRating) return mount()
    let script = document.querySelector(`script[src="${SRC}"]`)
    if (!script) {
      script = document.createElement('script')
      script.src = SRC
      script.async = true
      script.dataset.site = site
      script.dataset.app = app
      document.head.appendChild(script)
    }
    script.addEventListener('load', mount)
    return () => script.removeEventListener('load', mount)
  }, [site, app])

  return <div ref={ref} data-tbbc-rating data-section={section} />
}

<script setup>
import { onMounted, ref } from 'vue'
const props = defineProps({ section: String, site: { type: String, default: 'SUA_CHAVE' }, app: { type: String, default: 'meu-app' } })
const el = ref(null)
const SRC = 'https://tbbc.app/rating-widget/rating.js'

onMounted(() => {
  const mount = () => window.TBBCRating && window.TBBCRating.mount(el.value)
  if (window.TBBCRating) return mount()
  let script = document.querySelector(`script[src="${SRC}"]`)
  if (!script) {
    script = document.createElement('script')
    script.src = SRC
    script.async = true
    script.dataset.site = props.site
    script.dataset.app = props.app
    document.head.appendChild(script)
  }
  script.addEventListener('load', mount)
})
</script>

<template>
  <div ref="el" data-tbbc-rating :data-section="section"></div>
</template>

const TBBC = 'https://tbbc.app/api/rating'
const SITE = 'SUA_CHAVE'

async function post(url, body) {
  const res = await fetch(url, {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify(body),
  })
  const data = await res.json().catch(() => ({}))
  return { status: res.status, ...data }
}

// 1. The vote: keep the id if you will ask for a comment
export async function vote(value, section) {
  const r = await post(TBBC, { site: SITE, vote: value, section, app: 'meu-app' })
  if (r.status === 201) return r.id
  throw new Error(r.error || `HTTP ${r.status}`) // 400: fix the code; 500: try again
}

// 2. The comment (optional, can repeat, within 24 h).
//    When retrying, send the SAME nonce: the server ignores the repeat.
export async function comment(id, { comment, name, contact, nonce = Date.now().toString(36) + Math.random().toString(36).slice(2) }) {
  const r = await post(`${TBBC}/${id}`, { comment, name, contact, nonce })
  if (r.status === 200) return true
  if (r.error === 'contact_is_invalid') return 'ask them to check the contact'
  throw new Error(r.error || `HTTP ${r.status}`)
}

import Foundation

enum TbbcRating {
    static let base = URL(string: "https://tbbc.app/api/rating")!
    static let site = "SUA_CHAVE"

    struct Reply: Decodable { let ok: Bool?; let id: String?; let error: String? }

    private static func post(_ url: URL, _ body: [String: Any]) async throws -> (Int, Reply) {
        var request = URLRequest(url: url)
        request.httpMethod = "POST"
        request.setValue("application/json", forHTTPHeaderField: "Content-Type")
        request.httpBody = try JSONSerialization.data(withJSONObject: body)
        let (data, response) = try await URLSession.shared.data(for: request)
        let status = (response as? HTTPURLResponse)?.statusCode ?? 0
        return (status, (try? JSONDecoder().decode(Reply.self, from: data)) ?? Reply(ok: nil, id: nil, error: nil))
    }

    /// Returns the rating id (keep it to send the comment).
    static func vote(_ value: Int, section: String) async throws -> String {
        let (status, reply) = try await post(base, ["site": site, "vote": value, "section": section, "app": "meu-app-ios"])
        guard status == 201, let id = reply.id else { throw URLError(.badServerResponse) }
        return id
    }

    /// Appends a comment to the vote. Retry with the SAME nonce: the server ignores repeats.
    /// Throws on errors; "contact_is_invalid" asks the person to fix it.
    static func comment(id: String, nonce: String = UUID().uuidString, comment: String?, name: String?, contact: String?) async throws -> Bool {
        var body: [String: Any] = ["comment": comment, "name": name, "contact": contact].compactMapValues { $0 }
        body["nonce"] = nonce
        let (status, reply) = try await post(base.appendingPathComponent(id), body)
        if status == 200 { return true }
        throw NSError(domain: "TbbcRating", code: status, userInfo: [NSLocalizedDescriptionKey: reply.error ?? "HTTP \(status)"])
    }
}

import org.json.JSONObject
import java.net.HttpURLConnection
import java.net.URL

object TbbcRating {
    private const val BASE = "https://tbbc.app/api/rating"
    private const val SITE = "SUA_CHAVE"

    private fun post(url: String, body: JSONObject): Pair<Int, JSONObject> {
        val conn = URL(url).openConnection() as HttpURLConnection
        conn.requestMethod = "POST"
        conn.setRequestProperty("Content-Type", "application/json")
        conn.connectTimeout = 10_000
        conn.readTimeout = 10_000
        conn.doOutput = true
        conn.outputStream.use { it.write(body.toString().toByteArray()) }
        val status = conn.responseCode
        val text = (if (status < 400) conn.inputStream else conn.errorStream)?.bufferedReader()?.readText().orEmpty()
        conn.disconnect()
        return status to (runCatching { JSONObject(text) }.getOrDefault(JSONObject()))
    }

    /** Returns the rating id (keep it to send the comment). */
    fun vote(value: Int, section: String): String {
        val (status, reply) = post(BASE, JSONObject().put("site", SITE).put("vote", value).put("section", section).put("app", "meu-app-android"))
        check(status == 201) { reply.optString("error", "HTTP $status") }
        return reply.getString("id")
    }

    /** Appends a comment to the vote. Retry with the SAME nonce: the server ignores repeats.
     *  Throws with the error code otherwise ("contact_is_invalid": ask to fix). */
    fun comment(id: String, comment: String?, name: String?, contact: String?, nonce: String = java.util.UUID.randomUUID().toString()): Boolean {
        val body = JSONObject().put("nonce", nonce)
        comment?.let { body.put("comment", it) }
        name?.let { body.put("name", it) }
        contact?.let { body.put("contact", it) }
        val (status, reply) = post("$BASE/$id", body)
        if (status == 200) return true
        error(reply.optString("error", "HTTP $status"))
    }
}

import uuid
import requests

TBBC = "https://tbbc.app/api/rating"
SITE = "SUA_CHAVE"

def vote(value, section):
    r = requests.post(TBBC, json={"site": SITE, "vote": value, "section": section, "app": "meu-sistema"}, timeout=10)
    if r.status_code == 201:
        return r.json()["id"]  # keep it if you will ask for a comment
    r.raise_for_status()       # 400: fix the code; 500: try again

def comment(rating_id, comment=None, name=None, contact=None, nonce=None):
    # When retrying, send the SAME nonce: the server ignores the repeat.
    body = {"comment": comment, "name": name, "contact": contact, "nonce": nonce or uuid.uuid4().hex}
    r = requests.post(f"{TBBC}/{rating_id}", json=body, timeout=10)
    if r.status_code == 200:
        return True
    if r.json().get("error") == "contact_is_invalid":
        return False  # ask them to check the contact
    r.raise_for_status()