PT EN

Fotografias de prova

URL base: $BUSINESS_API

O objecto

idstring · opcional
tenant_idstring · opcional
client_keystring · opcional
referencestring · opcional

Value to store on the reading or field order, of the form evidence://{id}.

content_typestring · opcional

um de image/jpeg, image/png

size_bytesinteger (int64) · opcional
uploaded_bystring · opcional
created_atstring (date-time) · opcional
O objecto
{
  "id": "idx_2xBW8Tr0oR5YsrNoIdzQO7t4Gjn",
  "tenant_id": "ten_2ugFXIC316WXzGu1HGal90AxTA6",
  "client_key": "client key",
  "reference": "REF-2026-000142",
  "content_type": "image/jpeg",
  "size_bytes": 1,
  "uploaded_by": "uploaded by",
  "created_at": "2026-11-19T09:30:00Z"
}

Carregar uma fotografia de prova

Registos

POST /evidence-photos

Upload an evidence photo (JPEG or PNG, up to 8 MiB)

Stores a photo taken with a reading or a field order and returns the reference to send as photo_evidence, evidence_photo or in evidence_ids. The content is verified by its bytes; the storage location is generated by the server. Retrying with the same client_key and the same photo returns the original record and stores nothing new. Requires the business:evidence-photos:create scope.

Devolve

200 The photo already stored under this client key

Mostrar atributos
idstring · opcional
tenant_idstring · opcional
client_keystring · opcional
referencestring · opcional

Value to store on the reading or field order, of the form evidence://{id}.

content_typestring · opcional

um de image/jpeg, image/png

size_bytesinteger (int64) · opcional
uploaded_bystring · opcional
created_atstring (date-time) · opcional

Erros 400 · 401 · 403 · 409 · 413 · 415

Permissões business:evidence-photos:create · Funções: admin, field_reader, field_supervisor, operations, owner

curl -X POST "$BUSINESS_API/evidence-photos" \
  -H "Authorization: Bearer sk_test_..."
Resposta 200
{
  "id": "idx_2xBW8Tr0oR5YsrNoIdzQO7t4Gjn",
  "tenant_id": "ten_2ugFXIC316WXzGu1HGal90AxTA6",
  "client_key": "client key",
  "reference": "REF-2026-000142",
  "content_type": "image/jpeg",
  "size_bytes": 1,
  "uploaded_by": "uploaded by",
  "created_at": "2026-11-19T09:30:00Z"
}

Obter uma fotografia de prova

Registos

GET /evidence-photos/{id}/file

Returns the photo to staff of the owning tenant. Requires the business:evidence-photos:read scope. A photo owned by another tenant answers 404.

Parâmetros

idstring · caminho · obrigatório

Identifier from the photo's reference

Devolve

200 The photo bytes

Erros 401 · 403 · 404

Permissões business:evidence-photos:read · Funções: admin, customer_service, field_supervisor, operations, owner

curl -X GET "$BUSINESS_API/evidence-photos/{id}/file" \
  -H "Authorization: Bearer sk_test_..."
Resposta 200

The photo bytes