Developer Network

Documentação

Informações e instruções das APIs dos produtos Locaweb.

Acesso via API

1. Autenticação

Autenticação e os pedidos de ACLS podem ser autenticados ou não. O Object Storage assume que as solicitações não autenticadas, são enviadas por um usuário anônimo.

1
2
3
4
5
6
7
8
  HTTP/1.1
  PUT /buckets/bucket/object.mpeg
  Host: cname.domain.com
  Date: Mon, 2 Jan 2012 00:01:01 +0000
  Content-Encoding: mpeg
  Content-Length: 9999999

  Authorization: AWS {access-key}:{hash-of-header-and-secret}

No exemplo anterior, substitua {access-chave} com o valor para o seu acesso ID da chave seguido por dois pontos. Substitua {hash de-header-e-secret} com um hash da string de cabeçalho e o segredo correspondente ao acesso ID chave.

Para gerar o hash da string de cabeçalho e secreto, é necessário:

  • Obter o valor da cadeia de cabeçalho.
  • Normalizar a cadeia de cabeçalho de solicitação em forma canônica.
  • Gerar um HMAC usando um algoritmo de hash SHA-1.
2. Acessando via API

Existem dois modos para acessar um Bucket.

O primeiro método identifica o bucket como um diretório de nível superior na URL.

1
2
  GET /mybucket HTTP/1.1
    Host: cname.domain.com

O segundo método identifica o bucket através de um nome de host virtual. Por exemplo:

1
2
  GET / HTTP/1.1
    Host: mybucket.cname.domain.com

A tabela abaixo, possui os cabeçalhos de requisições:

Cabeçalho da requisição Descrição
CONTENT_LENGTH Length of the request body.
DATE Request time and date (in UTC).
HOST The name of the host server.
AUTHORIZATION Authorization token.

As possíveis respostas, estão listadas na tabela abaixo:

HTTP Status Código de Resposta
100 Continue
200 Success
201 Created
202 Accepted
204 NoContent
206 Partial content
304 NotModified
400 InvalidArgument
400 InvalidDigest
400 BadDigest
400 InvalidBucketName
400 InvalidObjectName
400 UnresolvableGrantByEmailAddress
400 InvalidPart
400 InvalidPartOrder
400 RequestTimeout
400 EntityTooLarge
403 AccessDenied
403 UserSuspended
403 RequestTimeTooSkewed
404 NoSuchKey
404 NoSuchBucket
404 NoSuchUpload
405 MethodNotAllowed
408 RequestTimeout
409 BucketAlreadyExists
409 BucketNotEmpty
411 MissingContentLength
412 PreconditionFailed
416 InvalidRange
422 UnprocessableEntity
500 InternalError