Partner API

Tüm rotalar /partner/v1/organisations/{partnerId}/listings altındadır ve ciqra auth login ile alınan bir partner token’ı (Authorization: Bearer ciqra_pt_...) ister. Yoldaki kuruluş her çağrıda kullanıcınıza göre denetlenir.

Yöntem ve yol	Ne yapar
GET /listings	Kuruluşunuzun gönderimleri, en yeni önce.
GET /listings/{id}	Durumu, notu, inceleyicisi ve manifestiyle bir gönderim.
PUT /listings	(key, version) taslağını oluşturur ya da düzenlenebilir olanın manifestini değiştirir. Gövde: { "manifest": { ... } }.
POST /listings/{id}/submit	Taslağı incelemeye verir.
POST /listings/{id}/reopen	Reddedilmiş gönderimi yeniden taslak yapar.

Yazmak için Owner, Admin ya da Developer rolü gerekir; okumak her üyeye açıktır.

Hatalar

Bir hata { "error": "<kod>", "message": "...", "findings": [...] } biçimindedir.

Durum	error	Ne zaman
422	invalid_manifest	Manifestte hata var. findings hepsini { field, message, isError } olarak sıralar.
409	key_taken	Bu anahtarı başka bir kuruluş zaten kullanıyor.
409	version_locked	O sürüm zaten gönderildi: yeni bir sürüm yayınlayın.
409	invalid_transition	Durum bu geçişe izin vermiyor.
409	conflict	Yeni bir sürümün iki kaydı yarıştı: tekrar deneyin.
404	not_found	Kuruluşunuzda böyle bir gönderim yok.
403	forbidden	Üye değilsiniz ya da rolünüz bunu yapamaz.
400	validation_failed	Hatalı biçimli istek.

İnceleyen tarafın kararları (take, approve, reject, list, suspend, delist) için: ret, askıya alma ya da listeden çıkarma gerekçesiz gelirse note_required, kararla adı belli bir inceleyen ilişkilendirilmemişse reviewer_required döner. Bu rotalar sizin değil CIQRA’nındır; bir durum değişikliği sürpriz olmasın diye listelenmiştir.