Enviar fotos — passo 1: obter URLs

POST

/partner/v1/property/photos/init

Devolve uma URL de envio por foto. Envie cada arquivo direto para a URL recebida, com PUT, e depois chame photos/complete. O arquivo não passa pela API da Homfy.

Até 20 fotos por chamada, 25 MB cada, somente imagens. A resposta é posicional: uploads[n] corresponde a files[n].

Arquivo grande volta com multipart: true e uma URL por parte; nesse caso envie cada parte, guarde a ETag de cada uma e mande todas em parts no complete.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Body Params application/jsonRequired

Example

{
    "partner_code": "AP-1024",
    "files": [
        {
            "filename": "fachada.jpg",
            "size": 2415000,
            "mimeType": "image/jpeg"
        }
    ]
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/partner/v1/property/photos/init' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "partner_code": "AP-1024",
    "files": [
        {
            "filename": "fachada.jpg",
            "size": 2415000,
            "mimeType": "image/jpeg"
        }
    ]
}'

Responses

🟢201

application/json

Uma URL de envio por arquivo.

Bodyapplication/json

Example

{
    "uploads": [
        {
            "uploadId": "string",
            "s3Key": "string",
            "multipart": true,
            "presignedUrl": "string",
            "presignedUrls": [
                {
                    "partNumber": 0,
                    "url": "string"
                }
            ],
            "s3UploadId": "string"
        }
    ]
}

🟠400

🟠401

🟠403

🟠404

🟠429

🔴500

Modified at 2026-08-20 16:06:11

Consultar detalhes do imóvel

Enviar fotos — passo 2: concluir