Faze4r 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/rfc2616.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, Operações de trabalho e Operações de predefinição.

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.

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 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.

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.

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.

exemplo 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).

Tipo: sequência

x-amzn-RequestId

Um valor criado pelo Elastic Transcoder que identifica exclusivamente sua solicitação; por exemplo, K2QH8DNOU907N97FNA2GDLL8OBVV4KQNSO5AEMVJF66Q9ASUAAJG. 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: sequência

Content-Length

O comprimento do corpo da resposta, em bytes.

Tipo: sequência

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: sequência