Geliştirici
API ve cihaz haberleşmesi
REST ile panele bağlanın. Cihazlarınız TCP/IP üzerinden canlı veri göndersin. Taban adres uygulama köküdür.
Başlarken
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.
https://app.dynomes.comKimlik 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 -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{
"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
/api/auth/registerKayıt. E-posta ve şifre ile hesap açar. first_name, last_name isteğe bağlıdır.
/api/auth/loginGiriş. Oturum çerezi (auth_token) yazar. HttpOnly, 7 gün geçerlidir.
/api/auth/meOturum. Aktif kullanıcıyı döner. auth
/api/auth/profileProfil. Ad, e-posta veya şifre günceller. auth
/api/auth/logoutÇıkış. Çerezi siler. auth
/api/auth/permissionsYetkiler. Fabrika bazlı rol ve izin listesi. auth
Fabrika
/api/factoriesFabrika listesi. Kullanıcının üye olduğu tesisler. auth
/api/factoriesFabrika oluştur. Yeni tesis kaydı. Oluşturan yönetici olur. auth
/api/factories/{id}Fabrika güncelle. Ad ve tesis meta verisi. auth
/api/factory/{factoryId}/structureDijital ikiz. Kat, hat ve makine ağacı. auth
/api/factory/{factoryId}/structureYapıyı kaydet. İkiz ağacını günceller. auth
/api/twin/structureİkiz (oturum). Seçili tesis ikizini okur. auth
Üyeler ve roller
/api/factory/{factoryId}/membersÜyeler. Fabrika ekibi ve roller. auth
/api/factory/{factoryId}/membersÜye ekle. E-posta ile davet veya mevcut kullanıcı. auth
/api/factory/{factoryId}/members/{userId}/roleRol ata. Üyenin rolünü değiştirir. auth
/api/factory/{factoryId}/rolesRoller. Fabrika rol tanımları. auth
/api/factory/{factoryId}/rolesRol oluştur. Özel izin seti. auth
/api/factory/{factoryId}/my-roleBenim rolüm. Çağıranın bu tesisteki rolü. auth
Üretim tanımı
/api/factory/{factoryId}/productsÜrünler. Reçete ve revizyonlu ürün listesi. auth
/api/factory/{factoryId}/productsÜrün oluştur. Yeni ürün tanımı. auth
/api/factory/{factoryId}/products/{productId}Ürün detay. BOM, ölçüm ve rota. auth
/api/factory/{factoryId}/products/{productId}/revisionsRevizyon. Yeni ürün revizyonu açar. auth
/api/factory/{factoryId}/machine-groupsMakine grupları. Planlama hücreleri. auth
/api/factory/{factoryId}/companiesCari hesaplar. Müşteri ve tedarikçi. 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.
- 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.
{
"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
}
}