Desarrolladores

Obtener una URL de subida firmada

POST
/uploads

Una URL prefirmada para subir un archivo al destino: envía los bytes con PUT a signedUrl, con Content-Type igual a mimeType y Content-Length igual a sizeBytes, en pocos minutos. Después usa publicUrl, que es permanente, como entrada de una generación o como avatar. Un archivo que ya está en una URL https pública no necesita subirse: usa esa URL directamente.

Autorización

headerAutorizaciónBearer <token>

Una API Key creada en la configuración de la cuenta, enviada como Authorization: Bearer <key>. Incluye los Scopes seleccionados al crearla.

Cuerpo de la solicitud

application/json
  1. body
fileName*string
Longitud1 <= length
mimeType*string
Longitud1 <= length
sizeBytes*integer
Rango0 <= value <= 9007199254740991
target*||

Cuerpo de la respuesta

Correcto.

application/json
  1. response
key*string
signedUrl*string
Formatouri
publicUrl*string
Formatouri
Solicitud de ejemplo
curl -X POST 'https://ximagesplitter.com/api/v1/uploads' \
  -H 'Content-Type: application/json' \
  -d '{
  "fileName": "string",
  "mimeType": "string",
  "sizeBytes": 0,
  "target": {
    "kind": "profile-image"
  }
}'
Respuesta de ejemplo
{
  "key": "string",
  "signedUrl": "http://example.com",
  "publicUrl": "http://example.com"
}