Aracılığıyla paylaş

Web Hooks - Test

  • Başvuru
Hizmet:
Azure AI Services
API Sürümü:
v3.2-preview.2

Kayıtlı her olay türü için kayıtlı URL'ye bir istek gönderir.
Yük, web kancasını çağıran son varlıktan oluşturulur. Kayıtlı olay türlerinin hiçbiri için varlık yoksa POST 204 ile yanıt verir. Test isteği yapılabiliyorsa 200 ile yanıt verir. İstek, ilgili kayıtlı olay türüne sahip bir X-MicrosoftSpeechServices-Event üst bilgisi içerir. Web kancası bir gizli diziyle kaydedildiyse, yükün SHA256 karması ve gizli diziyi HMAC anahtarı olarak içeren bir X-MicrosoftSpeechServices-Signature üst bilgisi içerir. Karma base64 kodludur.

POST {endpoint}/speechtotext/v3.2-preview.2/webhooks/{id}:test

URI Parametreleri

Name İçinde Gerekli Tür Description
endpoint
 path True

string

Desteklenen Bilişsel Hizmetler uç noktaları (protokol ve konak adı, örneğin: https://westus.api.cognitive.microsoft.com).
id
 path True

string

uuid

Ping için web kancasının tanımlayıcısı.

Yanıtlar

Name Tür Description
202 Accepted

Kayıtlı web kancasına son varlığı içeren bir test isteği gönderilir.

Üst Bilgiler

Retry-After: integer
204 No Content

Herhangi bir olay türü için varlık bulunamadığından kayıtlı web kancasına test isteği gönderilmez.
Other Status Codes

Error

Bir hata oluşmuştur.

Güvenlik

Ocp-Apim-Subscription-Key

Bilişsel hizmetler hesap anahtarınızı burada sağlayın.

Tür: apiKey
İçinde: header

Authorization

Bu bölgenin STS tarafından döndürülen JWT'den bir erişim belirteci sağlayın. STS URL'sine aşağıdaki sorgu dizesini ekleyerek yönetim kapsamını belirteci eklediğinizden emin olun: ?scope=speechservicesmanagement

Tür: apiKey
İçinde: header

Örnekler

Test a web hook

Örnek isteği

POST {endpoint}/speechtotext/v3.2-preview.2/webhooks/2e856efe-ef53-465a-a632-6a084c1d349d:test

Örnek yanıt

Durum kodu:
202
Durum kodu:
204

Tanımlar

Name Description
DetailedErrorCode

DetailedErrorCode
Error

Hata
ErrorCode

ErrorCode
InnerError

InnerError

DetailedErrorCode

DetailedErrorCode

Name Tür Description
DataImportFailed

string

Veri içeri aktarılamadı.
DeleteNotAllowed

string

Silmeye izin verilmiyor.
DeployNotAllowed

string

Dağıtıma izin verilmiyor.
DeployingFailedModel

string

Başarısız modeli dağıtma.
EmptyRequest

string

Boş İstek.
EndpointCannotBeDefault

string

Uç nokta varsayılan olamaz.
EndpointNotUpdatable

string

Uç nokta güncelleştirilebilir değil.
EndpointWithoutLogging

string

Günlüğe kaydetmeden uç nokta.
ExceededNumberOfRecordingsUris

string

Kayıt sayısı uris aşıldı.
FailedDataset

string

Başarısız veri kümesi.
Forbidden

string

Yasak.
InUseViolation

string

Kullanım ihlali.
InaccessibleCustomerStorage

string

Erişilemez müşteri depolama alanı.
InvalidAdaptationMapping

string

Geçersiz uyarlama eşlemesi.
InvalidBaseModel

string

Geçersiz temel model.
InvalidCallbackUri

string

Geçersiz geri çağırma uri'si.
InvalidCollection

string

Geçersiz koleksiyon.
InvalidDataset

string

Geçersiz veri kümesi.
InvalidDocument

string

Geçersiz Belge.
InvalidDocumentBatch

string

Geçersiz Belge Toplu İşlemi.
InvalidLocale

string

Geçersiz yerel ayar.
InvalidLogDate

string

Geçersiz günlük tarihi.
InvalidLogEndTime

string

Geçersiz günlük bitiş saati.
InvalidLogId

string

Geçersiz günlük kimliği.
InvalidLogStartTime

string

Geçersiz günlük başlangıç zamanı.
InvalidModel

string

Geçersiz model.
InvalidModelUri

string

Geçersiz model uri'si.
InvalidParameter

string

Geçersiz parametre.
InvalidParameterValue

string

Geçersiz parametre değeri.
InvalidPayload

string

Geçersiz yük.
InvalidPermissions

string

Geçersiz izinler.
InvalidPrerequisite

string

Geçersiz önkoşul.
InvalidProductId

string

Geçersiz ürün kimliği.
InvalidProject

string

Geçersiz proje.
InvalidProjectKind

string

Geçersiz proje türü.
InvalidRecordingsUri

string

Geçersiz kayıt uri'si.
InvalidRequestBodyFormat

string

Geçersiz istek gövdesi biçimi.
InvalidSasValidityDuration

string

Geçersiz sas geçerlilik süresi.
InvalidSkipTokenForLogs

string

Günlükler için geçersiz atlama belirteci.
InvalidSourceAzureResourceId

string

Geçersiz kaynak Azure kaynak kimliği.
InvalidSubscription

string

Geçersiz abonelik.
InvalidTest

string

Geçersiz test.
InvalidTimeToLive

string

Geçersiz yaşam süresi.
InvalidTopForLogs

string

Günlükler için geçersiz üst.
InvalidTranscription

string

Geçersiz transkripsiyon.
InvalidWebHookEventKind

string

Geçersiz web kancası olay türü.
MissingInputRecords

string

Eksik Giriş Kayıtları.
ModelCopyOperationExists

string

Model kopyalama işlemi var.
ModelDeploymentNotCompleteState

string

Model dağıtımı tamamlanamadı durumu.
ModelDeprecated

string

Model kullanım dışı bırakıldı.
ModelExists

string

Model var.
ModelMismatch

string

Model uyuşmazlığı.
ModelNotDeployable

string

Model dağıtılamaz.
ModelVersionIncorrect

string

Model Sürümü Yanlış.
NoUtf8WithBom

string

Ürün reçetesi ile utf8 yok.
OnlyOneOfUrlsOrContainerOrDataset

string

Url'lerden, kapsayıcıdan veya veri kümesinden yalnızca biri.
ProjectGenderMismatch

string

Proje cinsiyet uyuşmazlığı.
QuotaViolation

string

Kota ihlali.
SingleDefaultEndpoint

string

Tek varsayılan uç nokta.
SkuLimitsExist

string

Sku sınırları vardır.
SubscriptionNotFound

string

Abonelik bulunamadı.
UnexpectedError

string

Beklenmeyen hata.
UnsupportedClassBasedAdaptation

string

Desteklenmeyen sınıf tabanlı uyarlama.
UnsupportedDelta

string

Desteklenmeyen delta.
UnsupportedDynamicConfiguration

string

Desteklenmeyen dinamik yapılandırma.
UnsupportedFilter

string

Desteklenmeyen filtre.
UnsupportedLanguageCode

string

Desteklenmeyen dil kodu.
UnsupportedOrderBy

string

Desteklenmeyen sipariş ölçütü.
UnsupportedPagination

string

Desteklenmeyen sayfalandırma.
UnsupportedTimeRange

string

Desteklenmeyen zaman aralığı.

Error

Hata

Name Tür Description
code

ErrorCode

ErrorCode
Üst düzey hata kodları.
details

Error[]

Hata ve/veya beklenen ilkelerle ilgili ek destekleyici ayrıntılar.
innerError

InnerError

InnerError
adresinde https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8owbulunan Bilişsel Hizmetler API Yönergelerine uygun yeni İç Hata biçimi. Bu, ErrorCode, ileti ve isteğe bağlı özellik hedefi, ayrıntılar (anahtar değer çifti), iç hata (iç içe olabilir) özelliklerini içerir.
message

string

Üst düzey hata iletisi.
target

string

Hatanın kaynağı. Örneğin, geçersiz belge olması durumunda "belgeler" veya "belge kimliği" olabilir.

ErrorCode

ErrorCode

Name Tür Description
Conflict

string

Çakışma hata kodunu temsil ediyor.
Forbidden

string

Yasak hata kodunu temsil etme.
InternalCommunicationFailed

string

İç iletişim başarısız hata kodunu temsil ediyor.
InternalServerError

string

İç sunucu hata kodunu temsil ediyor.
InvalidArgument

string

Geçersiz bağımsız değişken hata kodunu temsil ediyor.
InvalidRequest

string

Geçersiz istek hata kodunu temsil ediyor.
NotAllowed

string

İzin verilmeyen hata kodunu temsil etme.
NotFound

string

Bulunamadı hata kodunu temsil ediyor.
PipelineError

string

İşlem hattı hata kodunu temsil eder.
ServiceUnavailable

string

Hizmet kullanılamıyor hata kodunu temsil etme.
TooManyRequests

string

Çok fazla istek hata kodunu temsil eder.
Unauthorized

string

Yetkisiz hata kodunu temsil etme.
UnprocessableEntity

string

İşlenemeyen varlık hata kodunu temsil eder.
UnsupportedMediaType

string

Desteklenmeyen medya türü hata kodunu temsil eder.

InnerError

InnerError

Name Tür Description
code

DetailedErrorCode

DetailedErrorCode
Ayrıntılı hata kodu sabit listesi.
details

object

Hata ve/veya beklenen ilkelerle ilgili ek destekleyici ayrıntılar.
innerError

InnerError

InnerError
adresinde https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8owbulunan Bilişsel Hizmetler API Yönergelerine uygun yeni İç Hata biçimi. Bu, ErrorCode, ileti ve isteğe bağlı özellik hedefi, ayrıntılar (anahtar değer çifti), iç hata (iç içe olabilir) özelliklerini içerir.
message

string

Üst düzey hata iletisi.
target

string

Hatanın kaynağı. Örneğin, geçersiz belge olması durumunda "belgeler" veya "belge kimliği" olabilir.