curl -X POST https://relay-wishkit.reza-rzny.workers.dev/v1/feedback \
  -H "Content-Type: application/json" \
  -H "X-Project-Key: pk_live_YOUR_PUBLISHABLE_KEY" \
  -d '{
    "type": "bug",
    "title": "Login button does not work",
    "message": "Nothing happens when I tap the login button.",
    "test": true,
    "context": { "platform": "ios", "app_version": "4.2.0", "os": "iOS", "os_version": "26.0", "locale": "en-US" },
    "metadata": { "screen": "login" }
  }'

# 201 → { "success": true, "data": { "id": "fbk_…", "status": "new", "created_at": "…" } }

// Response envelope — always the same shape
{ "success": true,  "data": { } }
{ "success": false, "error": { "code": "PROJECT_QUOTA_EXCEEDED", "message": "…", "request_id": "…" } }

// Request fields (unknown fields are rejected)
type         "bug" | "feature_request" | "feedback" | "issue"   (default "feedback")
message      string, 1–5000 chars            (required)
title        string, ≤160 chars
user         { id?: string ≤128, name?: string ≤80, email?: string }
installation_id   "install_…" random, resettable
context      { platform, app_version, build, os, os_version, device, device_type, locale,
               language, timezone, sdk_version, browser, browser_version, viewport{width,height}, page_url }
metadata     ≤20 keys; key [A-Za-z0-9_.-]{1,40}; value string ≤200 | number | boolean; ≤4 KB total
test         boolean — marks the report as test data

// Step 1 — Xcode ▸ File ▸ Add Package Dependencies
// https://github.com/reza-rezaeian/RelaySDK.git (version 1.3.0+)
// Step 2 — Configure once at launch
import SwiftUI
import RelaySDK

@main
struct MyApp: App {
    init() {
        Relay.configure(
            projectKey: "pk_live_YOUR_PUBLISHABLE_KEY",
            baseURL: URL(string: "https://relay-wishkit.reza-rzny.workers.dev")!
        )
    }
    var body: some Scene { WindowGroup { ContentView() } }
}

// Step 3 — Show the complete customer center.
// Feedback opens first; Messages, Public Board and What's New appear at the top.
struct ContentView: View {
    @State private var showFeedback = false
    var body: some View {
        Button("Send feedback") { showFeedback = true }
            .sheet(isPresented: $showFeedback) { RelayFeedbackCenterView() }
    }
}

// Optional direct submission
Task { try await Relay.submit(type: .feedback, message: "Hello from SwiftUI") }

import RelaySDK

Relay.configure(projectKey: "pk_live_YOUR_PUBLISHABLE_KEY", baseURL: URL(string: "https://relay-wishkit.reza-rzny.workers.dev")!)

// Submit directly
Task {
    try await Relay.submit(type: .bug, title: "Login button does not work",
                                 message: "Nothing happens when I tap login.")
}

let board = try await Relay.board()
let changelog = try await Relay.changelog()
let messages = try await Relay.refreshAllThreads()
try await Relay.setVote(feedbackId: board.items[0].id, voted: true)

// Ready-made SwiftUI views:
// RelayFeedbackCenterView, RelayFeedbackView, RelayMyMessagesView,
// RelayBoardView and RelayChangelogView

// Dependency-free example using HttpURLConnection (run off the main thread).
import java.net.HttpURLConnection
import java.net.URL

fun sendFeedback(message: String) {
    val body = """{"type":"bug","message":"""$message""","context":{"platform":"android","sdk_version":"rest-1"}}"""
    val c = URL("https://relay-wishkit.reza-rzny.workers.dev/v1/feedback").openConnection() as HttpURLConnection
    c.requestMethod = "POST"
    c.setRequestProperty("Content-Type", "application/json")
    c.setRequestProperty("X-Project-Key", "pk_live_YOUR_PUBLISHABLE_KEY")
    c.doOutput = true
    c.outputStream.use { it.write(body.toByteArray(Charsets.UTF_8)) }
    check(c.responseCode == 201) { "Feedback failed: ${c.responseCode}" }
}

// pubspec.yaml → dependencies: http: ^1.2.0
import 'dart:convert';
import 'package:http/http.dart' as http;

Future<void> sendFeedback(String message) async {
  final res = await http.post(
    Uri.parse('https://relay-wishkit.reza-rzny.workers.dev/v1/feedback'),
    headers: {'Content-Type': 'application/json', 'X-Project-Key': 'pk_live_YOUR_PUBLISHABLE_KEY'},
    body: jsonEncode({'type': 'feedback', 'message': message, 'context': {'platform': 'flutter'}}),
  );
  if (res.statusCode != 201) throw Exception('Feedback failed: ${res.statusCode}');
}

# Server-side example. Reading feedback needs a SECRET key — keep it in an environment variable.
import os, requests

r = requests.post("https://relay-wishkit.reza-rzny.workers.dev/v1/feedback",
    headers={"X-Project-Key": "pk_live_YOUR_PUBLISHABLE_KEY"},
    json={"type": "bug", "message": "Something went wrong.", "context": {"platform": "backend"}},
    timeout=10)
r.raise_for_status()

# List reports (secret key, server only)
res = requests.get("https://relay-wishkit.reza-rzny.workers.dev/v1/projects/prj_YOUR_PROJECT_ID/feedback?status=new",
    headers={"Authorization": "Bearer " + os.environ["SUGKIT_SECRET_KEY"]}, timeout=10)

<?php
$ch = curl_init("https://relay-wishkit.reza-rzny.workers.dev/v1/feedback");
curl_setopt_array($ch, [
  CURLOPT_POST => true,
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => ["Content-Type: application/json", "X-Project-Key: pk_live_YOUR_PUBLISHABLE_KEY"],
  CURLOPT_POSTFIELDS => json_encode(["type" => "bug", "message" => "Something went wrong."]),
]);
$response = curl_exec($ch);
if (curl_getinfo($ch, CURLINFO_HTTP_CODE) !== 201) { error_log("Feedback failed"); }

using System.Net.Http.Json;

var http = new HttpClient { BaseAddress = new Uri("https://relay-wishkit.reza-rzny.workers.dev") };
http.DefaultRequestHeaders.Add("X-Project-Key", "pk_live_YOUR_PUBLISHABLE_KEY");

var res = await http.PostAsJsonAsync("/v1/feedback", new {
    type = "bug",
    message = "Something went wrong.",
    context = new { platform = "dotnet" }
});
res.EnsureSuccessStatusCode(); // 201 Created

HTTP/1.1 429 Too Many Requests
Retry-After: 42

{ "success": false, "error": { "code": "RATE_LIMITED", "message": "…" } }