Web Hooks - Test

Service:

Azure AI Services

API-versie:

v3.2-preview.2

Verzendt een aanvraag voor elk geregistreerd gebeurtenistype naar de geregistreerde URL.
De nettolading wordt gegenereerd op basis van de laatste entiteit die de webhook zou hebben aangeroepen. Als er geen entiteit aanwezig is voor geen van de geregistreerde gebeurtenistypen, reageert post met 204. Als er een testaanvraag kan worden gedaan, reageert deze met 200. De aanvraag bevat een X-MicrosoftSpeechServices-Event-header met het respectieve geregistreerde gebeurtenistype. Als de webhook is geregistreerd bij een geheim, bevat deze een X-MicrosoftSpeechServices-Signature-header met een SHA256-hash van de nettolading met het geheim als HMAC-sleutel. De hash is base64 gecodeerd.

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

URI-parameters

Name	In	Vereist	Type	Description
endpoint	path	True	string	Ondersteunde Cognitive Services-eindpunten (protocol en hostnaam, bijvoorbeeld: https://westus.api.cognitive.microsoft.com).
id	path	True	string uuid	De id van de webhook om te pingen.

Antwoorden

Name	Type	Description
202 Accepted		Een testaanvraag met de laatste entiteit wordt verzonden naar de geregistreerde webhook. Kopteksten Retry-After: integer
204 No Content		Er is geen entiteit gevonden voor een gebeurtenistype, dus er wordt geen testaanvraag verzonden naar de geregistreerde webhook.
Other Status Codes	Error	Er is een fout opgetreden.

Beveiliging

Ocp-Apim-Subscription-Key

Geef hier de sleutel van uw Cognitive Services-account op.

Type: apiKey
In: header

Authorization

Geef een toegangstoken op van de JWT die wordt geretourneerd door de STS van deze regio. Zorg ervoor dat u het beheerbereik toevoegt aan het token door de volgende querytekenreeks toe te voegen aan de STS-URL: ?scope=speechservicesmanagement

Type: apiKey
In: header

Voorbeelden

Test a web hook

Voorbeeldaanvraag

HTTP

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

Voorbeeldrespons

Statuscode:

202

Statuscode:

204

Definities

Name	Description
DetailedErrorCode	DetailedErrorCode
Error	Fout
ErrorCode	ErrorCode
InnerError	InnerError

DetailedErrorCode

DetailedErrorCode

Name	Type	Description
DataImportFailed	string	Het importeren van gegevens is mislukt.
DeleteNotAllowed	string	Verwijderen is niet toegestaan.
DeployNotAllowed	string	Implementeren is niet toegestaan.
DeployingFailedModel	string	Het implementeren van een mislukt model.
EmptyRequest	string	Lege aanvraag.
EndpointCannotBeDefault	string	Eindpunt kan niet standaard zijn.
EndpointNotUpdatable	string	Eindpunt kan niet worden bijgewerkt.
EndpointWithoutLogging	string	Eindpunt zonder logboekregistratie.
ExceededNumberOfRecordingsUris	string	Het aantal opnamen is overschreden.
FailedDataset	string	Mislukte gegevensset.
Forbidden	string	Verboden.
InUseViolation	string	In gebruiksovertreding.
InaccessibleCustomerStorage	string	Niet-toegankelijke klantopslag.
InvalidAdaptationMapping	string	Ongeldige aanpassingstoewijzing.
InvalidBaseModel	string	Ongeldig basismodel.
InvalidCallbackUri	string	Ongeldige callback-URI.
InvalidCollection	string	Ongeldige verzameling.
InvalidDataset	string	Ongeldige gegevensset.
InvalidDocument	string	Ongeldig document.
InvalidDocumentBatch	string	Ongeldige documentbatch.
InvalidLocale	string	Ongeldige landinstelling.
InvalidLogDate	string	Ongeldige logboekdatum.
InvalidLogEndTime	string	Ongeldige eindtijd van logboek.
InvalidLogId	string	Ongeldige logboek-id.
InvalidLogStartTime	string	Ongeldige begintijd van logboek.
InvalidModel	string	Ongeldig model.
InvalidModelUri	string	Ongeldige model-URI.
InvalidParameter	string	Ongeldige parameter.
InvalidParameterValue	string	Ongeldige parameterwaarde.
InvalidPayload	string	Ongeldige nettolading.
InvalidPermissions	string	Ongeldige machtigingen.
InvalidPrerequisite	string	Ongeldige vereiste.
InvalidProductId	string	Ongeldige product-id.
InvalidProject	string	Ongeldig project.
InvalidProjectKind	string	Ongeldige projectsoort.
InvalidRecordingsUri	string	Ongeldige URI voor opnamen.
InvalidRequestBodyFormat	string	Ongeldige indeling van aanvraagbody.
InvalidSasValidityDuration	string	Ongeldige geldigheidsduur sas.
InvalidSkipTokenForLogs	string	Ongeldig token voor overslaan voor logboeken.
InvalidSourceAzureResourceId	string	Ongeldige bron-id van Azure-resource.
InvalidSubscription	string	Ongeldig abonnement.
InvalidTest	string	Ongeldige test.
InvalidTimeToLive	string	Ongeldige time to live.
InvalidTopForLogs	string	Ongeldige bovenkant voor logboeken.
InvalidTranscription	string	Ongeldige transcriptie.
InvalidWebHookEventKind	string	Ongeldig soort webhook gebeurtenis.
MissingInputRecords	string	Ontbrekende invoerrecords.
ModelCopyOperationExists	string	De kopieerbewerking van het model bestaat.
ModelDeploymentNotCompleteState	string	De status modelimplementatie is niet voltooid.
ModelDeprecated	string	Het model is afgeschaft.
ModelExists	string	Het model bestaat.
ModelMismatch	string	Model komt niet overeen.
ModelNotDeployable	string	Het model kan niet worden geïmplementeerd.
ModelVersionIncorrect	string	Modelversie onjuist.
NoUtf8WithBom	string	Geen utf8 met bom.
OnlyOneOfUrlsOrContainerOrDataset	string	Slechts één van de URL's of container of gegevensset.
ProjectGenderMismatch	string	Het geslacht van het project komt niet overeen.
QuotaViolation	string	Quotumschending.
SingleDefaultEndpoint	string	Eén standaardeindpunt.
SkuLimitsExist	string	Er bestaan SKU-limieten.
SubscriptionNotFound	string	Kan het abonnement niet vinden.
UnexpectedError	string	Onverwachte fout.
UnsupportedClassBasedAdaptation	string	Niet-ondersteunde aanpassing op basis van klassen.
UnsupportedDelta	string	Niet-ondersteunde delta.
UnsupportedDynamicConfiguration	string	Niet-ondersteunde dynamische configuratie.
UnsupportedFilter	string	Niet-ondersteund filter.
UnsupportedLanguageCode	string	Niet-ondersteunde taalcode.
UnsupportedOrderBy	string	Niet-ondersteunde bestelling door.
UnsupportedPagination	string	Niet-ondersteunde paginering.
UnsupportedTimeRange	string	Niet-ondersteund tijdsbereik.

Error

Fout

Name	Type	Description
code	ErrorCode	ErrorCode Foutcodes op hoog niveau.
details	Error[]	Aanvullende ondersteunende informatie met betrekking tot de fout en/of het verwachte beleid.
innerError	InnerError	InnerError Nieuwe indeling voor interne fouten die voldoet aan de API-richtlijnen voor Cognitive Services die beschikbaar zijn op https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8ow. Dit bevat de vereiste eigenschappen Foutcode, bericht en optionele eigenschappen doel, details (sleutelwaardepaar), interne fout (dit kan worden genest).
message	string	Foutbericht op hoog niveau.
target	string	De bron van de fout. Dit is bijvoorbeeld 'documenten' of 'document-id' in het geval van een ongeldig document.

ErrorCode

ErrorCode

Name	Type	Description
Conflict	string	Vertegenwoordigt de conflictfoutcode.
Forbidden	string	Vertegenwoordigt de verboden foutcode.
InternalCommunicationFailed	string	De foutcode voor de interne communicatie mislukt.
InternalServerError	string	Vertegenwoordigt de foutcode van de interne serverfout.
InvalidArgument	string	Vertegenwoordigt de foutcode van het ongeldige argument.
InvalidRequest	string	Vertegenwoordigt de ongeldige aanvraagfoutcode.
NotAllowed	string	Vertegenwoordigt de niet-toegestane foutcode.
NotFound	string	Vertegenwoordigt de foutcode die niet is gevonden.
PipelineError	string	Vertegenwoordigt de foutcode van de pijplijnfout.
ServiceUnavailable	string	Vertegenwoordigt de foutcode die niet beschikbaar is voor de service.
TooManyRequests	string	Vertegenwoordigt de foutcode voor te veel aanvragen.
Unauthorized	string	Vertegenwoordigt de foutcode voor onbevoegden.
UnprocessableEntity	string	Vertegenwoordigt de foutcode van de niet-verwerkbare entiteit.
UnsupportedMediaType	string	Vertegenwoordigt de foutcode van het niet-ondersteunde mediatype.

InnerError

InnerError

Name	Type	Description
code	DetailedErrorCode	DetailedErrorCode Gedetailleerde foutcode- enum.
details	object	Aanvullende ondersteunende informatie met betrekking tot de fout en/of het verwachte beleid.
innerError	InnerError	InnerError Nieuwe indeling voor interne fouten die voldoet aan de API-richtlijnen voor Cognitive Services die beschikbaar zijn op https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8ow. Dit bevat de vereiste eigenschappen Foutcode, bericht en optionele eigenschappen doel, details (sleutelwaardepaar), interne fout (dit kan worden genest).
message	string	Foutbericht op hoog niveau.
target	string	De bron van de fout. Dit is bijvoorbeeld 'documenten' of 'document-id' in het geval van een ongeldig document.