ApivomApivom
Demo Alın

Autodesk APS Webhooks Bağlayıcısı

Autodesk Platform Services'in Webhooks API'si — Data Management, Model Derivative, Autodesk Construction Cloud ve Tandem olaylarına geri çağırma kaydedin, sistem ve olay bazında hook'ları listeleyip yönetin, Autodesk'in yükleri imzaladığı gizli jetonu ayarlayın — olay güdümlü APS entegrasyonları için Apivom Atlas'ta 12 altyapı rotası olarak kayıtlı.

Neler yapabilirsiniz

  • Hook'lar: tek bir olay veya bir sistemin tüm olayları için oluşturun; uygulamaya, sisteme veya olaya göre listeleyin; okuyun, güncelleyin (durum, filtre, geri çağırma) ve silin
  • APS Webhooks'un kapsadığı sistemler: data (Data Management dosya ve klasör olayları), derivative (çeviri tamamlandı), adsk.c4r (Revit Cloud Worksharing), autodesk.construction (ACC) ve Tandem
  • Gizli jeton: teslimatlardaki x-adsk-signature başlığı için uygulama bazlı sırrı oluşturun, döndürün ve silin
  • developer.api.autodesk.com üzerinde 12 rota (5 salt okunur), yapay zekâ entegrasyon rehberinde (llms.txt) belgeli

Kullanım senaryoları

  • Yeni dosya sürümlerine tepki verin — Bir proje klasöründe dm.version.added kaydedin; sisteminiz yeni bir çizim revizyonunu zamanlayıcıyla klasör taramak yerine düştüğü anda alsın.
  • Çeviriyi işlemeye zincirleyin — extraction.finished olayına abone olun; Model Derivative işi tamamlandı dediği anda özellik çıkarımını veya görüntüleyici önbelleklemesini başlatın.

APS Webhooks bir ürün özelliğinden çok altyapıdır: Data Management veya Model Derivative'i yoklamak yerine uygulama bir hook kaydeder — bir sistem ve olay için geri çağırma URL'si, isteğe bağlı olarak klasör gibi bir kapsam ve JSONPath filtresiyle — ve olay her gerçekleştiğinde Autodesk bir yük gönderir: eklenen veya değiştirilen dosya sürümü, yeniden adlandırılan klasör, tamamlanan çeviri, bir ACC veya Tandem değişikliği. API hook'ları olay ya da tüm sistem bazında oluşturur; uygulama, sistem veya olay için listeler; okur, günceller ve siler; her teslimatın doğrulanabilir bir x-adsk-signature taşıması için uygulamanın gizli jetonunu yönetir. Hook'lar onları oluşturan jetona aittir: iki taraflı hook'lar uygulama genelinde, üç taraflı hook'lar kullanıcıyı izler. Apivom Atlas 12 rotanın tamamını, 5'i salt okunur, APS kimlik bilgisi sözleşmesi ve yapay zekâ entegrasyon rehberiyle (llms.txt) kataloglar ve her çağrıyı kiracı bazında kaydeder; geri çağırmaların kendisi Atlas üzerinden değil, kaydettiğiniz URL'ye gider. Bugün hiçbir Apivom ürün akışı APS kullanmaz; bu bağlayıcı gelecekteki bir ACC veya Data Management entegrasyonu olay güdümlü olabilsin diye vardır ve bir ürün akışı müşteri bazında kapsamlanır.

Kimlik doğrulama

Autodesk Platform Services uygulamanız (aps.autodesk.com'dan istemci kimliği + sırrı) ve bu API'nin gerektirdiği kapsamlar. Çağıran OAuth2 v2 jetonunu alır — uygulama verisi için iki taraflı, kullanıcı hub'ları için üç taraflı — ve Bearer olarak gönderir; Apivom Atlas iletir, kaydeder, saklamaz.

Sık sorulan sorular

Bu bağlayıcıyı bugün açabilir miyim?

Bağlayıcı Apivom Atlas'ta kayıtlıdır — tüm rotalar kataloglanmış, kimlik bilgisi sözleşmesi yayımlanmış ve yapay zekâ entegrasyon rehberi (llms.txt) yayındadır — ve kimlik bilginiz Apivom Iris'te saklanabilir. Bir ürün akışına bağlanması (senkronizasyon, otomasyon, bildirim) müşteri bazında yapılır: kullanım senaryonuzu iletin, kapsamı birlikte belirleyelim.

Bir webhook teslimatının gerçekten Autodesk'ten geldiğini nasıl doğrularım?

tokens rotasıyla bir gizli jeton oluşturun; Autodesk bundan sonra her yükü imzalar ve imzayı x-adsk-signature başlığında gönderir. Olaya güvenmeden önce sırrınızla ham gövde üzerinde HMAC'i yeniden hesaplayıp karşılaştırın.

Olay yükleri Apivom Atlas'tan geçer mi?

Hayır. Atlas yalnızca yönetim çağrılarına aracılık eder — hook'ları ve sırrı oluşturma, listeleme, güncelleme ve silme. Autodesk olayları doğrudan kaydettiğiniz geri çağırma URL'sine teslim eder; bu URL HTTPS üzerinden herkese açık erişilebilir olmalıdır.

Apivom bu bağlayıcı için API çağrısı başına ücret alır mı?

Hayır. Bağlayıcılar Apivom kiracınızın parçasıdır ve Atlas portalında ölçümlenmez. Bağladığınız hesapta sağlayıcının kendi fiyatlandırması, kotaları ve hız sınırları geçerli olmaya devam eder — Apivom çağrılarını bu sınırların içinde kalacak şekilde hızlandırır ve her çağrıyı kiracınızın entegrasyon günlüğünde gösterir.

Kimlik bilgilerim nerede saklanır, trafiği kim görür?

Apivom Atlas durumsuz bir geçittir: sağlayıcı kimlik bilgilerini veya jetonları asla saklamaz. Bağlanan Apivom ürünü kimlik bilgisini kiracı veritabanınızda şifreli tutar; her istek ve yanıt yalnızca kiracınızda kaydedilir — verileriniz kiracılar arasında asla paylaşılmaz.

Diğer Atlas entegrasyonları

AI entegrasyon rehberi (llms.txt)

Makine tarafından okunabilir markdown — AI asistanınıza entegrasyon talimatı olarak verin.