🔌 API Overview

The Sayify.pro REST API gives you full programmatic access to your workspace — create feedback links, retrieve responses, manage webhooks, and automate your workflow.

🌐 Base URL

All API requests use:

https://sayify.pro/api/v1/

[!IMPORTANT]
All endpoint URLs must include a trailing slash. Django returns 301 Moved Permanently without it.

📨 Request Format

• Content-Type: application/json for POST / PATCH / PUT requests.
• Accept: application/json.
• Trailing slashes: Required on all endpoint URLs.

Example POST Request

curl -X POST https://sayify.pro/api/v1/links/ \
  -H "Authorization: Bearer sk_live_AbCdEfGhIjKlMnOpQrStUvWxYz0123456789xyz" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Product Feedback",
    "slug": "product-feedback"
  }'

const response = await fetch("https://sayify.pro/api/v1/links/", {
  method: "POST",
  headers: {
    "Authorization": "Bearer sk_live_AbCdEfGhIjKlMnOpQrStUvWxYz0123456789xyz",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    name: "Product Feedback",
    slug: "product-feedback"
  })
});

const link = await response.json();

import requests

response = requests.post(
    "https://sayify.pro/api/v1/links/",
    headers={
        "Authorization": "Bearer sk_live_AbCdEfGhIjKlMnOpQrStUvWxYz0123456789xyz",
        "Content-Type": "application/json"
    },
    json={
        "name": "Product Feedback",
        "slug": "product-feedback"
    }
)

link = response.json()

📤 Response Format

All responses return JSON. Successful operations use standard HTTP status codes:

Pagination

List endpoints return paginated results:

{
  "count": 42,
  "next": "https://sayify.pro/api/v1/links/?page=2",
  "previous": null,
  "results": [...]
}

Use page and page_size query parameters to control pagination.

🚦 Rate Limits

API requests are rate-limited per API key:

[!TIP]
When rate-limited (429), the response includes a Retry-After header indicating how many seconds to wait.

📚 API Reference Pages