GetWatermark - : Central de Documentação do Alibaba Cloud

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos que você chame esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	GetWatermark	A operação que você deseja executar. Defina o valor como GetWatermark.
WatermarkId	String	Sim	9bcc8bfadb843f*09a2671d0df97	O ID da marca d'água.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
RequestId	String	25818875-5F78-4A*****F6-D7393642CA58	O ID da solicitação.
WatermarkInfo	Struct		As informações sobre a marca d'água.
AppId	String	app-****	O ID do aplicativo.
CreationTime	String	2018-11-06T08:03:17Z	O momento em que a marca d'água foi adicionada. O horário segue o padrão ISO 8601 no formato aaaa-MM-ddTHH:mm:ssZ. O horário é exibido em UTC.
FileUrl	String	https://outin-32***f4b3e7.oss-cn-shanghai.aliyuncs.com/image/cover/F85529C8B715E6F8A72EC6B-6-2.png?Expires=1541600583&OSSAccessKeyId=&Signature=gmf1eYMoDVg%2BHQCb4UGozBW**	A URL do Object Storage Service (OSS) ou a URL da Content Delivery Network (CDN) do arquivo de marca d'água. Marcas d'água de texto não possuem URL de arquivo.
IsDefault	String	NotDefault	Indica se a marca d'água é a padrão. Valores válidos: Default: A marca d'água é a padrão. NotDefault: A marca d'água não é a padrão.
Name	String	Image watermark test	O nome da marca d'água.
Type	String	Text	O tipo da marca d'água. Valores válidos: Image Text
WatermarkConfig	String	{"ReferPos": "BottomRight","Height": "55","Width": "55","Dx": "8","Dy": "8" }	As configurações, como posição e efeito da marca d'água de texto ou de imagem. O valor é uma string formatada em JSON. Para obter mais informações sobre a estrutura de dados, consulte a seção "WatermarkConfig" do tópico Parâmetros de processamento de mídia.
WatermarkId	String	505e2e287ea*****ecfddd386d384	O ID da marca d'água.

Exemplos

Exemplos de solicitações

https://vod.{ApiRegion}.aliyuncs.com/?Action=GetWatermark
&WatermarkId=9bcc8bfadb843f*****09a2671d0df97
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

<GetWatermarkResponse>
  <RequestId>25818875-5F78-4A*****F6-D7393642CA58</RequestId>
  <WatermarkInfo>
        <IsDefault>NotDefault</IsDefault>
        <FileUrl>https://outin-32*****f4b3e7.oss-cn-shanghai.aliyuncs.com/image/cover/F85529C8B715E6F8A72EC6B-6-2.png?Expires=1541600583&amp;OSSAccessKeyId=****&amp;Signature=gmf1eYMoDVg%2BHQCb4UGozBW****</FileUrl>
        <Type>Text</Type>
        <AppId>app-****</AppId>
        <WatermarkId>505e2e287ea*****ecfddd386d384</WatermarkId>
        <CreationTime>2018-11-06T08:03:17Z</CreationTime>
        <WatermarkConfig>{"ReferPos": "BottomRight","Height": "55","Width": "55","Dx": "8","Dy": "8" }</WatermarkConfig>
        <Name>Image watermark test</Name>
  </WatermarkInfo>
</GetWatermarkResponse>

Formato JSON

{
    "RequestId": "25818875-5F78-4A*****F6-D7393642CA58",
    "WatermarkInfo": {
        "IsDefault": "NotDefault",
        "FileUrl": "https://outin-32*****f4b3e7.oss-cn-shanghai.aliyuncs.com/image/cover/F85529C8B715E6F8A72EC6B-6-2.png?Expires=1541600583&OSSAccessKeyId=****&Signature=gmf1eYMoDVg%2BHQCb4UGozBW****",
        "Type": "Text",
        "AppId": "app-****",
        "WatermarkId": "505e2e287ea*****ecfddd386d384",
        "CreationTime": "2018-11-06T08:03:17Z",
        "WatermarkConfig": "{\"ReferPos\": \"BottomRight\",\"Height\": \"55\",\"Width\": \"55\",\"Dx\": \"8\",\"Dy\": \"8\" }",
        "Name": "Image watermark test"
    }
}

Códigos de erro

Para obter uma lista de códigos de erro, visite o API Error Center.

Erros comuns

A tabela a seguir descreve os erros comuns que esta operação pode retornar.

Código de erro	Mensagem de erro	Código de status HTTP	Descrição
NoSuchResource	The specified resource %s does not exist.	404	Mensagem de erro retornada porque o recurso relacionado ao usuário não existe. %s indica as informações específicas do recurso.

Exemplos de SDK

Recomendamos o uso dos SDKs de servidor para chamar esta operação. Visualize o código de exemplo em diferentes linguagens para chamar esta operação clicando nos links a seguir: