dynomes

Geliştirici

API ve cihaz haberleşmesi

REST ile panele bağlanın. Cihazlarınız TCP/IP üzerinden canlı veri göndersin.

0:002:18

Nasıl bağlanılır

Tüm istekler aşağıdaki köke gider. Oturum auth_token HttpOnly çereziyle taşınır. Sunucu tarafı veya CLI’de çerezi saklayın; tarayıcıda credentials: 'include' kullanın.

İlk istek: taban adres, login curl ve dönen çerez. Postman veya terminal çıktısı da olur. Doküman → Geliştirici · Nasıl bağlanılır · /docs/shots/dev-api-kok.png

  1. 1Kayıt veya giriş yapın; çerezi alın.
  2. 2GET /api/factories ile tesis kimliğini alın.
  3. 3Sonraki çağrılarda factoryId kullanın. Cihaz için IoT paket sözleşmesine bakın.
Taban adres
https://app.dynomes.com

Kimlik doğrulama

Önce POST /api/auth/login veya kayıt. Başarılı cevapta çerez yazılır. Yetkisiz çağrı 401 döner.

curl
curl -X POST https://app.dynomes.com/api/auth/login \
  -H "Content-Type: application/json" \
  -c cookies.txt \
  -d '{"email":"ornek@fabrika.com","password":"******"}'

curl https://app.dynomes.com/api/factories -b cookies.txt
İstek
{
  "email": "ornek@fabrika.com",
  "password": "******"
}
200
{
  "id": 1,
  "email": "ornek@fabrika.com",
  "first_name": "Ayşe",
  "last_name": "Kaya"
}

REST referansı

{factoryId} yol parametresi üye olduğunuz tesisin kimliğidir. Liste GET /api/factories ile alınır.

Kimlik

POST
/api/auth/register

Kayıt. E-posta ve şifre ile hesap açar. first_name, last_name isteğe bağlıdır.

POST
/api/auth/login

Giriş. Oturum çerezi (auth_token) yazar. HttpOnly, 7 gün geçerlidir.

GET
auth
/api/auth/me

Oturum. Aktif kullanıcıyı döner. auth

PATCH
auth
/api/auth/profile

Profil. Ad, e-posta veya şifre günceller. auth

POST
auth
/api/auth/logout

Çıkış. Çerezi siler. auth

GET
auth
/api/auth/permissions

Yetkiler. Fabrika bazlı rol ve izin listesi. auth

Fabrika

GET
auth
/api/factories

Fabrika listesi. Kullanıcının üye olduğu tesisler. auth

POST
auth
/api/factories

Fabrika oluştur. Yeni tesis kaydı. Oluşturan yönetici olur. auth

PATCH
auth
/api/factories/{id}

Fabrika güncelle. Ad ve tesis meta verisi. auth

GET
auth
/api/factory/{factoryId}/structure

Dijital ikiz. Kat, hat ve makine ağacı. auth

PUT
auth
/api/factory/{factoryId}/structure

Yapıyı kaydet. İkiz ağacını günceller. auth

GET
auth
/api/twin/structure

İkiz (oturum). Seçili tesis ikizini okur. auth

Üyeler ve roller

GET
auth
/api/factory/{factoryId}/members

Üyeler. Fabrika ekibi ve roller. auth

POST
auth
/api/factory/{factoryId}/members

Üye ekle. E-posta ile davet veya mevcut kullanıcı. auth

PATCH
auth
/api/factory/{factoryId}/members/{userId}/role

Rol ata. Üyenin rolünü değiştirir. auth

GET
auth
/api/factory/{factoryId}/roles

Roller. Fabrika rol tanımları. auth

POST
auth
/api/factory/{factoryId}/roles

Rol oluştur. Özel izin seti. auth

GET
auth
/api/factory/{factoryId}/my-role

Benim rolüm. Çağıranın bu tesisteki rolü. auth

Üretim tanımı

GET
auth
/api/factory/{factoryId}/products

Ürünler. Reçete ve revizyonlu ürün listesi. auth

POST
auth
/api/factory/{factoryId}/products

Ürün oluştur. Yeni ürün tanımı. auth

GET
auth
/api/factory/{factoryId}/products/{productId}

Ürün detay. BOM, ölçüm ve rota. auth

POST
auth
/api/factory/{factoryId}/products/{productId}/revisions

Revizyon. Yeni ürün revizyonu açar. auth

GET
auth
/api/factory/{factoryId}/machine-groups

Makine grupları. Planlama hücreleri. auth

GET
auth
/api/factory/{factoryId}/companies

Cari hesaplar. Müşteri ve tedarikçi. auth

GET
auth
/api/factory/{factoryId}/definitions/{entity}

Tanımlar. Depo, vardiya, ekipman gibi sözlükler. auth

IoT protokolü

Donanım ve sizin yazdığınız köprü aynı sözleşmeyi kullanır. Makine fabrikada kayıtlı olduktan sonra cihaz kimliğiyle paket basılır.

Örnek cycle JSON paketi veya cihazın panele düşen canlı veri kartı. Geliştirici → IoT protokolü · /docs/shots/dev-iot-paket.png

  • Cihazlar TCP/IP ile tesis ağına çıkar. Varsayılan port ve JSON çerçeve formatı cihaz kılavuzunda yer alır.
  • Her paket factory_id, machine_id, timestamp ve ölçüm alanlarını (adet, duruş_kodu, titreşim vb.) taşır.
  • Gateway kesintide yerel tampon tutar; hat gelince kuyruk boşaltılır. Çift kayıt sunucu tarafında idempotent anahtarla elenir.
  • Dyno Dial BLE kumpas ölçümünü aynı oturumda kalite kaydına yazar.
  • Paket tipi: cycle, downtime, measure, heartbeat. Bilinmeyen tip loglanır, iş emrini bozmaz.
cycle
{
  "factory_id": 12,
  "machine_id": "CNC-01",
  "ts": "2026-08-18T20:41:02+03:00",
  "type": "cycle",
  "payload": {
    "count": 1,
    "cycle_ms": 18420,
    "scrap": 0
  }
}

Hata kodları

400Eksik veya geçersiz gövde (e-posta, şifre, factoryId).
401Oturum yok veya şifre hatalı.
403Bu fabrikada bu işlem için rolünüz yok.
404Kayıt bulunamadı.
409E-posta zaten kayıtlı.

Sandbox ve IP allowlist

Entegrasyon anahtarı için yazın.