API Reference Overview - Dükkango Integration API

Base URL

https://www.xn--dkkango-n2a.com/api/integrations

Authentication

All endpoints (except /auth/login) require the Access-Token header:

Access-Token: your-access-token-here

Response Format

All API responses follow this standard format:

Success Response

{
  "status": true,
  "data": { /* response data */ }
}

Error Response

{
  "status": false,
  "error": "error_code",
  "message": "Detailed error message"
}

Endpoint Categories

Authentication

Restaurants

Manage restaurant status and information

Foods

Control menu items and availability

Orders

Receive and manage orders

Endpoint Summary

Restaurants

Method	Endpoint	Description
GET	`/restaurants/get`	List all accessible restaurants
GET	`/restaurants/status/get/{rest_id}`	Check restaurant status
PUT	`/restaurants/status/open/{rest_id}`	Open restaurant
PUT	`/restaurants/status/close/{rest_id}`	Close restaurant

Foods

Method	Endpoint	Description	Rate Limit
GET	`/foods/get-foods`	Get menu items with modifiers	30s
PUT	`/foods/status-active/{food_id}`	Activate menu item	-
PUT	`/foods/status-passive/{food_id}`	Deactivate menu item	-

Orders

Method	Endpoint	Description	Rate Limit
GET	`/orders/get-current`	Fetch active orders	30s
PUT	`/orders/success/{order_id}`	Acknowledge order	-
PUT	`/orders/accept/{order_id}`	Accept order	-
PUT	`/orders/ontheway/{order_id}`	Mark as out for delivery	-
PUT	`/orders/complete/{order_id}`	Complete order	-
PUT	`/orders/cancel/{order_id}`	Cancel order	-
GET	`/orders/variables`	Get payment/shipping methods	-
GET	`/orders/cancel-reasons`	Get cancellation reasons	-

Rate Limiting

Some endpoints are rate-limited to prevent excessive API calls.

Endpoint	Cooldown	Error Code
`/foods/get-foods`	30 seconds	429
`/orders/get-current`	30 seconds	429

Rate Limit Error:

{
  "status": false,
  "error": "çok fazla istek",
  "message": "Çok fazla istek. Lütfen 30 saniye bekleyin."
}

Implement exponential backoff when receiving 429 errors.

Common Error Codes

HTTP Status	Error Code	Description
400	eksik alan	Missing required field
401	yetkisiz erişim	Invalid or expired token
403	URL hatalı	Invalid resource ID or unauthorized
404	sipariş bulunamadı	Order not found
404	restoran bulunamadı	Restaurant not found
422	eksik alan	Malformed request body
429	çok fazla istek	Rate limit exceeded
500	Internal server error	Server error

Data Types

UUID Format

Restaurant IDs and order payment_key use UUID format:

8f2b9ce2-04de-4712-842d-a39f64596fdf

Datetime Format

All timestamps use the format:

2026-01-15 23:59:59

Currency

All prices are in the smallest currency unit (cents/kuruş):

{
  "price": 675  // ₺6.75
}

Start Building

Ready to integrate? Follow our quick start guide

​Base URL

​Authentication

​Response Format

​Success Response

​Error Response

​Endpoint Categories

Authentication

Restaurants

Foods

Orders

​Endpoint Summary

​Restaurants

​Foods

​Orders

​Rate Limiting

​Common Error Codes

​Data Types

​UUID Format

​Datetime Format

​Currency

Start Building

Base URL

Authentication

Response Format

Success Response

Error Response

Endpoint Categories

Endpoint Summary

Restaurants

Foods

Orders

Rate Limiting

Common Error Codes

Data Types

UUID Format

Datetime Format

Currency