API Referansı

İşletmeler

İşletme, hesabınızın en üst seviyedeki kaydıdır. Restoranlar bir işletmeye bağlanır.

Taban URL

taban url

https://api.v1.fastsiparis.com

GET/web-api/v1/businesses

Tüm İşletmeleri Getir

Hesabınıza bağlı tüm işletmeleri döndürür.

Header'lar

Ad	Değer
Authorization	Bearer POSENTEGRA_API_KEY

Kod Örneği

bash

curl --request GET \
  --url 'https://api.v1.fastsiparis.com/web-api/v1/businesses' \
  --header 'Authorization: Bearer POSENTEGRA_API_KEY'

Yanıtlar

POST/web-api/v1/businesses

İşletme Oluştur

Yeni bir işletme kaydı açar. Zorunlu tek alan `name`; adres, vergi dairesi, vergi numarası ve iletişim bilgileri isteğe bağlıdır.

Gövde Alanları

Ad	Tip	Zorunlu
name	string	Evet
description	string	Hayır
vatNumber	string	Hayır
taxOffice	string	Hayır
address	string	Hayır
city	string	Hayır
country	string	Hayır
zipCode	string	Hayır
phone	string	Hayır
email	string	Hayır

Header'lar

Ad	Değer
Authorization	Bearer POSENTEGRA_API_KEY
Content-Type	application/json

İstek Gövdesi

JSON

json

{
  "name": "posentegra",
  "email": "info@posentegra.com",
  "phone": "05555555555",
  "address": "Teknokent",
  "city": "Ankara",
  "country": "Türkiye",
  "taxOffice": "Ankara",
  "vatNumber": "1234567890",
  "zipCode": "06000",
  "description": "Ana Merkez"
}

Kod Örneği

bash

curl --request POST \
  --url 'https://api.v1.fastsiparis.com/web-api/v1/businesses' \
  --header 'Authorization: Bearer POSENTEGRA_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{  "name": "posentegra",  "email": "info@posentegra.com",  "phone": "05555555555",  "address": "Teknokent",  "city": "Ankara",  "country": "Türkiye",  "taxOffice": "Ankara",  "vatNumber": "1234567890",  "zipCode": "06000",  "description": "Ana Merkez"}'

Yanıtlar

GET/web-api/v1/businesses/{businessId}

İşletme Detayını Getir

Tek bir işletmenin tüm alanlarını döndürür.

Parametreler

Ad	Konum	Tip	Zorunlu	Seçenekler
businessId	path	string	Evet	—

Header'lar

Ad	Değer
Authorization	Bearer POSENTEGRA_API_KEY

Kod Örneği

bash

curl --request GET \
  --url 'https://api.v1.fastsiparis.com/web-api/v1/businesses/{businessId}' \
  --header 'Authorization: Bearer POSENTEGRA_API_KEY'

Yanıtlar

PUT/web-api/v1/businesses/{businessId}

İşletme Güncelle

İşletmenin ad, açıklama gibi alanlarını günceller.

Parametreler

Ad	Konum	Tip	Zorunlu	Seçenekler
businessId	path	string	Evet	—

Gövde Alanları

Ad	Tip	Zorunlu
name	string	Evet
description	string	Hayır
vatNumber	string	Hayır
taxOffice	string	Hayır
address	string	Hayır
city	string	Hayır
country	string	Hayır
zipCode	string	Hayır
phone	string	Hayır
email	string	Hayır

Header'lar

Ad	Değer
Authorization	Bearer POSENTEGRA_API_KEY
Content-Type	application/json

İstek Gövdesi

JSON

json

{
  "name": "posentegra",
  "description": "Güncellenmiş açıklama"
}

Kod Örneği

bash

curl --request PUT \
  --url 'https://api.v1.fastsiparis.com/web-api/v1/businesses/{businessId}' \
  --header 'Authorization: Bearer POSENTEGRA_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{  "name": "posentegra",  "description": "Güncellenmiş açıklama"}'

Yanıtlar

DELETE/web-api/v1/businesses/{businessId}

İşletme Sil

İşletmeyi ve bağlı kayıtları siler. Geri alınamaz.

Parametreler

Ad	Konum	Tip	Zorunlu	Seçenekler
businessId	path	string	Evet	—

Header'lar

Ad	Değer
Authorization	Bearer POSENTEGRA_API_KEY

Kod Örneği

bash

curl --request DELETE \
  --url 'https://api.v1.fastsiparis.com/web-api/v1/businesses/{businessId}' \
  --header 'Authorization: Bearer POSENTEGRA_API_KEY'

Yanıtlar

GET/web-api/v1/businesses/{businessId}/restaurantskoleksiyon

İşletme Restoranlarını Getir

Belirtilen işletmeye bağlı restoranları listeler.

Parametreler

Ad	Konum	Tip	Zorunlu	Seçenekler
businessId	path	string	Evet	—

Header'lar

Ad	Değer
Authorization	Bearer POSENTEGRA_API_KEY

Kod Örneği

bash

curl --request GET \
  --url 'https://api.v1.fastsiparis.com/web-api/v1/businesses/{businessId}/restaurants' \
  --header 'Authorization: Bearer POSENTEGRA_API_KEY'

Yanıtlar

200OK

JSON

json

{
  "success": true,
  "data": [
    {
      "id": "r_123",
      "name": "Serdivan Şubesi"
    }
  ]
}

Restoranlar