Quick Start

Get your first API call running in 5 minutes

Prerequisites

Before you begin, make sure you have:

App Secret Key - Provided by Dükkango

Restaurant Secret Key - Unique per vendor/branch

HTTPS-enabled environment - All API calls require SSL

Don’t have your API credentials yet? Contact us at [e-mail]

Integration Workflow

1. Obtain API Credentials

   Get your app_secret_key and rest_secret_key from the Dükkango team.

2. Authenticate

   Call /auth/login to get your access token.

   curl -X POST https://www.xn--dkkango-n2a.com/api/integrations/auth/login \
     -H 'Content-Type: application/json' \
     -d '{
       "app_secret_key": "your-app-secret-key",
       "rest_secret_key": "your-restaurant-secret-key"
     }'
   

   Response:

   {
     "status": true,
     "data": {
       "access_token": "bcfb7a8a...",
       "expiration_date": "2026-01-15 23:59:59"
     }
   }
   
3. Store Your Access Token

   Save the access_token securely. It’s valid for 24 hours.

4. Make Your First API Call

   Get your restaurant list using the access token:

   curl -X GET https://www.xn--dkkango-n2a.com/api/integrations/restaurants/get \
     -H 'Access-Token: your-access-token'
   

   Response:

   {
     "status": true,
     "data": [
       {
         "id": "8f2b9ce2-04de-4712-842d-a39f64596fdf",
         "name": "Akat Şube"
       }
     ]
   }
   
5. Poll for Orders

   Start polling for active orders every 30+ seconds:

   curl -X GET https://www.xn--dkkango-n2a.com/api/integrations/orders/get-current \
     -H 'Access-Token: your-access-token'
   

What’s Next?

Authentication Guide

Learn about token management and security

Order Lifecycle

Understand the complete order flow

API Reference

Explore all available endpoints

Best Practices

Build a robust, production-ready integration

Common Integration Pattern

Here’s a typical integration workflow:

// 1. Authenticate
const { access_token } = await login(app_secret, rest_secret);

// 2. Start polling for orders
setInterval(async () => {
  const orders = await getOrders(access_token);
  
  for (const order of orders) {
    // 3. Acknowledge order
    await markOrderSuccess(order.payment_key, access_token);
    
    // 4. Process in your POS
    await processOrder(order);
    
    // 5. Update order status
    if (shouldAccept) {
      await acceptOrder(order.payment_key, 30, access_token);
    }
  }
}, 30000); // Every 30 seconds

Remember to respect rate limits! The /orders/get-current endpoint has a 30-second cooldown.