Protocolo RESTful

Deixamos aqui dois exemplos básicos de uso da API. A primeira requisição cria o Auth-Token usando o usuário e senha. A segunda usa o Auth-Token para listar os containers existentes. Documentação completa da API RESTful.

Autenticação

Request por curl

curl -i -H "X-Auth-User: usuario" -H "X-Auth-Key: senha" https://storage.under.com.br/auth/v1.0

Request http

GET /auth/v1.0 HTTP/1.1
Host: storage.under.com.br
Accept: */*
X-Auth-User: usuario
X-Auth-Key: senha

Response http

HTTP/1.1 200 OK
X-Storage-Url: https://storage.under.com.br/v1/AUTH_usuario
X-Auth-Token: AUTH_tkc60a54b3b6e243cdbc2b4902e987f962
Content-Type: text/html; charset=UTF-8
Set-Cookie: X-Auth-Token=AUTH_tkc60a54b3b6e243cdbc2b4902e987f962; Path=/
X-Storage-Token: AUTH_tkc60a54b3b6e243cdbc2b4902e987f962
Content-Length: 0

Os dois parâmetros importantes são:

X-Storage-Url
Deve ser usado a partir de agora na URL das próximas requisições. Note que a URL é diferente da URL da autenticação.
X-Storage-Token
É o token de autenticação que deve ser usado nos próximos requests. A autenticação é válido por 86400 segundos.

Listar Containers

Request por curl

curl -X GET -i -H "X-Auth-Token: AUTH_tkc60a54b3b6e243cdbc2b4902e987f962" https://storage.under.com.br/v1/AUTH_usuario

Request http

GET /v1/AUTH_usuario HTTP/1.1
Host: storage.under.com.br
Accept: */*
X-Auth-Token: AUTH_tkc60a54b3b6e243cdbc2b4902e987f962

Response http

HTTP/1.1 200 OK
Content-Length: 48
X-Account-Object-Count: 3
X-Timestamp: 1387466183.13338
X-Account-Meta-Temp-Url-Key: 93c05351-3cd3-4bcc-a8cf-bbb2ecc68427
X-Account-Bytes-Used: 3625673
X-Account-Container-Count: 3
Content-Type: text/plain; charset=utf-8
Accept-Ranges: bytes
Date: Tue, 07 Jan 2014 17:05:09 GMT

imagens
videos
musicas
Publicado em 26 de Ago. de 2015 às 19:00
Base de Conhecimento
Contrate pelo Chat