# Polatlı Cepte Partner API

> Polatlı Cepte yemek sipariş modülü için partner/entegrasyon REST API.

## Docs
- Developer portal: https://polatlicepte.com/developers
- Quickstart: https://polatlicepte.com/developers/getting-started
- AI integration prompt: https://polatlicepte.com/developers/ai
- Webhooks: https://polatlicepte.com/developers/webhooks
- API reference (Scalar): https://polatlicepte.com/developers/api-reference

## Machine-readable spec
- OpenAPI 3.1: https://polatlicepte.com/openapi.yaml
- AI prompt (download): https://polatlicepte.com/INTEGRATION_PROMPT.md

## Base URL
https://polatlicepte.com/api/partner/v1

## Auth
Bearer `pc_{env}_{key_id}_{secret}` + X-Request-Id + X-Idempotency-Key (mutations)

## Contact
entegrasyon@polatlicepte.com


## Endpoints
- GET /api/partner/v1/stores — Yetkili restoranları listele
- GET /api/partner/v1/stores/:store_id — Restoran detayı
- GET /api/partner/v1/stores/:store_id/menu — Restoran menüsünü getir
- GET /api/partner/v1/stores/:store_id/menu/mappings — Menü eşleştirmelerini listele
- PUT /api/partner/v1/stores/:store_id/menu/mappings — Menü eşleştirmelerini toplu güncelle
- GET /api/partner/v1/stores/:store_id/menu/mappings/status — Eşleştirme durumu (go-live hazırlık)
- PATCH /api/partner/v1/stores/:store_id/menu/items/:item_id/availability — Ürün stok durumunu güncelle
- GET /api/partner/v1/orders — Siparişleri listele
- GET /api/partner/v1/orders/:order_id — Sipariş detayı
- PATCH /api/partner/v1/orders/:order_id/status — Sipariş durumunu güncelle
- POST /api/partner/v1/orders/:order_id/cancel — Siparişi iptal et

## Webhook events
- order.created — yeni sipariş (kalemler dahil)
- order.updated — durum değişikliği
- order.cancelled — iptal/red

## Status mapping (partner → internal)
- accepted → confirmed
- picked_up → on_the_way
- Diğerleri birebir
- API yanıtları ve webhook payload'ları her zaman partner status kullanır

## Rate limit
120 requests/minute per partner

## Sandbox
Test key başvuru sonrası verilir. Production key ayrıdır; sandbox restoranlarıyla izole çalışır.