Aviso de fim do suporte: em 13 de novembro de 2025, o suporte para o Amazon Elastic Transcoder AWS será interrompido. Depois de 13 de novembro de 2025, você não poderá mais acessar o console do Elastic Transcoder ou os recursos do Elastic Transcoder.
Para obter mais informações sobre a transição para AWS Elemental MediaConvert, visite esta [postagem do blog](https://aws.amazon.com/blogs/media/how-to-migrate-workflows-from-amazon-elastic-transcoder-to-aws-elemental-mediaconvert/).
As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Fazer solicitações HTTP para o Elastic Transcoder
As solicitações REST do Elastic Transcoder são solicitações HTTPS, conforme definido na RFC 2616. (Para obter mais informações, acesse [http://www.ietf. org/rfc/rfc](http://www.ietf.org/rfc/rfc2616.txt)2616.txt.) Esta seção descreve a estrutura de uma solicitação REST do Elastic Transcoder. Para obter descrições detalhadas das ações que você pode executar, consulte [Operações de pipeline](operations-pipelines.md), [Operações de trabalho](operations-jobs.md) e [Operações de predefinição](operations-presets.md).
Uma ação REST normal consiste em enviar uma solicitação HTTPS ao Elastic Transcoder e aguardar a resposta. Como qualquer solicitação HTTP, uma solicitação REST ao Elastic Transcoder contém um método de solicitação, um URI, cabeçalhos de solicitação e às vezes uma string de consulta ou o corpo da solicitação. A resposta contém um código de status HTTP, cabeçalhos de resposta e, às vezes, corpo da resposta.
**Topics**
+ [Conteúdo de cabeçalho HTTP](#http-request-header)
+ [Corpo da solicitação HTTP](#http-request-body)
+ [Respostas HTTP](#http-response-header)
## Conteúdo de cabeçalho HTTP
O Elastic Transcoder exige as informações a seguir no cabeçalho de uma solicitação HTTP:
**Host (obrigatório)**
O endpoint do Elastic Transcoder que especifica onde seus recursos são criados. O valor deve ser um endpoint regional designado. Recomendamos que você use o mesmo endpoint para os buckets do Amazon S3 e para os pipelines e trabalhos do Elastic Transcoder. Se usar endpoints diferentes, poderá haver cobrança adicional para dados transferidos entre a região que contém os buckets do Amazon S3 e a região na qual o Elastic Transcoder faz a codificação. Além disso, o tempo necessário para a transferência de dados atrasará o acesso ao arquivo transcodificado.
Para obter uma lista dos endpoints do Elastic Transcoder compatíveis, acesse a seção [Regiões e endpoints](https://docs.aws.amazon.com/general/latest/gr/rande.html#elastictranscoder_region) na *Referência geral da Amazon Web Services*.
Para obter mais informações sobre taxas entre regiões, consulte Definição de preço de transferência de dados em [Definição de preço do Amazon S3](https://aws.amazon.com/s3/pricing/).
**x-amz-date ou Data (Obrigatório)**
A data usada para criar a assinatura contida no cabeçalho `Authorization`. Especifique a data no formato padrão ISO 8601, no horário UTC, como mostrado no exemplo a seguir: `X-Amz-Date: 20130613T203622Z`.
Você deve incluir `x-amz-date` ou `Date`. (Algumas bibliotecas de cliente HTTP não permitem a definição do cabeçalho `Date`). Quando existe um cabeçalho `x-amz-date`, o sistema ignora qualquer cabeçalho `Date` ao autenticar a solicitação.
O time stamp deve estar no intervalo de 15 minutos da hora do sistema da AWS; quando a solicitação for recebida. Se não estiver, a solicitação falhará, com o código de erro `RequestExpired`, para impedir que outra pessoa reproduza suas solicitações.
**Autorização (obrigatório)**
As informações necessárias para solicitar a autenticação. Para mais informações sobre a criação desse cabeçalho, consulte [Solicitações de assinatura](signing-requests.md).
**Content-Type (condicional)**
Especifica o JSON e a versão, por exemplo `Content-Type: application/x-amz-json-1.0`.
Condição: necessário para solicitações POST.
**Content-Length (condicional)**
Comprimento da mensagem (sem cabeçalhos) de acordo com a RFC 2616.
Condição: obrigatório se o corpo da solicitação em si contiver informações (a maioria dos toolkits adiciona esse cabeçalho automaticamente).
Veja a seguir um exemplo de cabeçalho para uma solicitação HTTP para criar um pipeline.
```
POST /2012-09-25/pipelines HTTP/1.1
host: elastictranscoder.us-east-1.amazonaws.com:443
x-amz-date: 20120116T174952Z
Authorization: AWS4-HMAC-SHA256 Credential=AccessKeyID/20120116/us-east-1/elastictranscoder/aws4_request,SignedHeaders=host;x-amz-date;x-amz-target,Signature=145b1567ab3c50d929412f28f52c45dbf1e63ec5c66023d232a539a4afd11fd9
content-type: application/x-amz-json-1.0
content-length: 231
connection: Keep-Alive
```
## Corpo da solicitação HTTP
Muitas ações de API do Elastic Transcoder exigem que você inclua dados formatados por JSON no corpo da solicitação. O JSON está em conformidade com o esquema do Elastic Transcoder.
**nota**
Os valores de JSON no corpo da solicitação são strings.
**Example Solicitação**
O exemplo a seguir usa uma solicitação de instrução JSON simples para criar um trabalho que transcodifica um arquivo chamado `sample.mp4` e o salva como `sams-birthday.mp4`.
```
POST /2012-09-25/jobs HTTP/1.1
Content-Type: application/json; charset=UTF-8
Accept: */*
Host: elastictranscoder.us-east-1.amazonaws.com:443
Content-Length: 300
{
"Input":{
"Key":"sample.mp4",
"FrameRate":"auto",
"Resolution":"auto",
"AspectRatio":"auto",
"Interlaced":"auto",
"Container":"mp4"
},
"OutputKeyPrefix":"family-videos/",
"Outputs":[
{
"Key":"sams-birthday.mp4",
"ThumbnailPattern":"thumbnails/sams-birthday-{count}",
"Rotate":"0",
"PresetId":"1351620000000-100080"
}
],
"PipelineId":"1111111111111-abcde1"
}
```
## Respostas HTTP
Todas as ações de API do Elastic Transcoder incluem dados formatados por JSON na resposta. O JSON está em conformidade com o esquema do Elastic Transcoder.
**nota**
Os valores de JSON na resposta são strings.
A seguir são apresentados alguns cabeçalhos importantes na resposta HTTP e a explicação sobre como você deve lidar com eles em seu aplicativo, se aplicável:
**HTTP/1.1**
Esse cabeçalho é acompanhado de um código de status. O código de status `200` indica uma operação bem-sucedida. Para obter informações sobre códigos de erro, consulte [Códigos de erro de API (erros de cliente e servidor)](error-handling.md#api-error-codes).
Tipo: string
**x-man- RequestId**
Um valor criado pelo Elastic Transcoder que identifica exclusivamente sua solicitação, por exemplo, K2 07N97 Q9ASUAAJG. QH8 DNOU9 FNA2 GDLL8 OBVV4 KQNSO5 AEMVJF66 Se você tiver um problema com o Elastic Transcoder, a AWS poderá usar esse valor para resolver o problema. É recomendável registrar esses valores.
Tipo: string
**Content-Length**
O comprimento do corpo da resposta, em bytes.
Tipo: string
**Data**
A data e hora em que o Elastic Transcoder respondeu, por exemplo, `Sun, 25 Mar 2012 12:00:00 GMT`. O formato da data deve ser um dos formatos de data completos especificados por RFC 2616, seção 3.3.
Tipo: string