Nafafy Public API
API by Nafafy · rest
Programmatic access to publish stories, manage products and variants, fulfil orders, run bookings and read analytics on Nafafy. - REST — Authorization: Bearer nf_live_… (or nf_test_…) with a key of kind REST API minted at https://nafafy.com/dashboard/developer. Each Series F operation names the scope it needs (x-required-scope); x:write implies x:read. customers:pii and refunds:write are standalone and never implied. - MCP — https://nafafy.com/api/mcp (JSON-RPC 2.0 over HTTP) needs a key of kind MCP; a REST key is refused there, and an MCP key is refused on REST (wrong_kind). Errors use the envelope components.schemas.V1Error; branch on error.code. Series F operations list every code they can answer in x-error-codes and their limit in x-rate-limit.
Endpoint: https://nafafy.com/
Verification: observed. Source: crawl.
Capabilities (43)
- MCP JSON-RPC 2.0 endpoint — bearer key of kind MCP (a REST key is refused).
- List your bookable services
- Create a bookable service
- Get one of your services
- Change a service
- Open slots on a date
- List bookings on your services
- Get one booking
- Confirm cancel complete or mark a no-show
- Catalog filtered by the caller's tier (auth-gated).
- List leads for the caller's host.
- Append a lead to one of your lead forms (scope leads:write). Stamped…
- Report what a lead turned out to be worth (scope leads:write): won + value …
- List your shop's orders
- Get one order
- Confirm or cancel a cash-on-delivery order
- List an order's refunds
- Issue a refund
- Move an order through fulfilment
- Add or correct tracking on a shipping order
- List products owned by the caller's host (scope products:read).
- Create a product or upsert by (drawer_host_id external_id) (scope…
- Fetch one product (scope products:read). Includes its active `variants`.
- Update any subset of product fields (scope products:write).
- Soft delete (is_active=false); ?hard=true removes the row unless it has orders…