Getting started

There are two journeys. Which one is yours?

• I am building my own product (an app, an agency panel, a SaaS): follow the Platform API, the first half of this page is yours.
• I want my own café's data (reports, integrations, automation): follow the Business API, the second half is yours.

Path 1: your own product on the Platform API

1. Sign up and get your key

Sign up at app.sadakio.com/gelistirici/kayit. No company required, no human approval to wait for. Signup provisions your first business too, so your first call is real rather than a rehearsal. Your pk_ key is shown once, store it somewhere safe.

2. List your businesses

curl https://api.sadakio.com/platform/v1/businesses \
  -H "Authorization: Bearer pk_YOUR_KEY"

The response holds the business created at signup, and its join_url is your guests' sign-up page.

3. Register a guest and give a stamp

curl -X POST https://api.sadakio.com/platform/v1/businesses/BIZ_ID/guests \
  -H "Authorization: Bearer pk_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"phone": "+905551112233", "name": "Elif"}'

curl -X POST https://api.sadakio.com/platform/v1/businesses/BIZ_ID/guests/GUEST_ID/adjust \
  -H "Authorization: Bearer pk_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: first-stamp-1" \
  -d '{"counter": "damga", "delta": 1}'

That is all. The guest is registered, the stamp is on, and resending the same request answers replayed: true with the same result, nothing is ever counted twice. Continue with the Platform API reference.

Path 2: your own data over the Business API

1. Get your key from the panel

Open Settings → API in your Sadakio account and create your sk_ key. The raw key is shown only once.

2. Fetch your guest list

curl https://api.sadakio.com/api/v1/guests \
  -H "Authorization: Bearer sk_YOUR_KEY"

Phones come back masked (KVKK) and the data belongs only to your business.

3. Get the retention summary

curl "https://api.sadakio.com/api/v1/stats/retention?period=month" \
  -H "Authorization: Bearer sk_YOUR_KEY"

Continue with the Business API reference.

Hand it to your assistant

Using Cursor, Claude or ChatGPT? Paste this prompt:

Build an integration on Sadakio.
Full documentation: https://sadakio.com/llms-full-en.txt
Platform contract: https://api.sadakio.com/platform/v1/openapi.yaml
Business contract: https://api.sadakio.com/api/v1/openapi.yaml
My key is ready. Build me [describe what you want].

This page as .md: /en/docs/baslangic.md