Ortak API
Kendi sistemlerinizden HTTPS üzerinden bir Morphic iş akışı çalıştırın.
Partner API, kendi yazılımınızdan bir Morphic iş akışını başlatır. Bir iş akışının giriş sözleşmesini okur, girdilerinizle bir çalıştırma başlatır, ardından çalıştırmayı — onu yoklayarak ya da bir webhook alarak — bitmiş varlıklarını geri verene kadar izlersiniz.
Erken erişim. v1 yayında. Alan adları ve sınırlar hâlâ değişebilir — bununla geliştirin ve uymayan noktaları bize bildirin.
Bir iş akışı nedir
Bir iş akışı, ekibinizin Morphic Studio'da oluşturduğu bir tarifdir: adlandırılmış girdiler alan ve bitmiş varlıklar üreten bir üretim adımları dizisi. Bu API, bunu sistemlerinizden başlatır ve çıktısını toplar. İş akışlarını oluşturmaz — bu, yaratıcı kararları veren kişilerin çalıştığı Studio'da kalır.
Bir entegrasyonun yapısı
sequenceDiagram
participant You as Sisteminiz
participant M as Morphic API
You->>M: GET iş akışı girdileri
M-->>You: toplanacak girdiler
You->>M: POST iş akışı çalıştırması
M-->>You: 202 + çalıştırma kimliği
loop until terminal
You->>M: GET iş akışı çalıştırması
M-->>You: durum, ardından varlıklar
endBaşlamadan önce ihtiyacınız olanlar
| Değer | Nereden gelir |
|---|---|
| API anahtarı | Morphic kuruluşunuzdaki bir yönetici bunu Studio'da oluşturur; anahtar yalnızca bir kez gösterilir |
| Temel URL | https://api.morphic.com/v1/partner — ayrıca Studio'daki API anahtarları sayfasında da gösterilir; bkz. Ortamlar test ortamı için |
org_id | Morphic kuruluşunuz — Studio'daki API anahtarları sayfasında bir Kopyala düğmesiyle gösterilir |
project_id | çalıştırmaların düştüğü tuval: onu Studio'da açın ve kimliği URL'sinden kopyalayın, …/editor/<project_id>/canvas (bir içindeki kimlik /projects/… URL'deki kimlik farklıdır) |
workflow_id | çalıştırmanız istenen iş akışı |
Dosya yükleme yoktur
Bize hiçbir zaman bayt yüklemezsiniz. Her dosya girdisi bir herkese açık bir HTTPS bağlantısı bizim çekip doğruladığımız bir URL ile dosya geçirme. Bu, görüntüler, video, ses ve belgeler için tek bir sözleşme sağlar ve CDN'nizin kendi içeriğinizin kaynağı olarak kalması anlamına gelir.
Sonrakini okuyun
Kimlik doğrulama
Anahtarlar, kapsamlar ve ortamlar
Kurallar
Kimlikler, zaman damgaları, hatalar, yeniden denemeler
Bir iş akışının girdilerini al
Buna göre toplanacak giriş sözleşmesi
URL ile dosya geçirme
Uyguladığımız bağlantı kuralları
Bir iş akışı çalıştırmasını başlat
Çalışmaya başlama
Bir workflow çalıştırmasını oku
Durumlar ve varlıklar
Webhooks
Sormak yerine bilgilendirilmek
Hatalar ve sınırlar
Her hata kodu ve her sınır