AXaxilioai
phones

Get one file delivery

Changed on

Returns a single delivery by id and its current status. Poll this to wait on a specific push: the list endpoint pages the newest records and can drop a delivery that ages past the page on a busy phone.

get/phones/{phone_id}/deliveries/{delivery_id}

Request

Path parameters

phone_idstring required

phone the delivery belongs to

delivery_idstring uuid required

delivery to fetch

Response

OK

$schemastring uri

A URL to the JSON Schema for this object.

bytes_transferredinteger

Bytes the phone has downloaded so far. Absent until the phone reports progress.

created_atstring date-time required

When the push was dispatched.

errorstring

Failure detail for failed deliveries.

file_idstring

Library file that was pushed. Absent once that file has been deleted; the filename and size below are snapshots taken at push time and survive it.

filenamestring required

Delivered file's display name.

idstring required

Delivery identifier.

mime_typestring required

Delivered file's MIME type.

phone_idstring required

Phone the file was pushed to.

size_bytesinteger required

Delivered file's size in bytes.

status'dispatching' | 'dispatched' | 'delivered' | 'failed' required

dispatching while the push is being published, dispatched while the phone downloads, then delivered or failed once it reports back.

Example response

{
  "$schema": "/api/v1/FileDeliverySummary.json"
}

Changes

  • 49b1da5a7974Revision changes
    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

  • e2261ff54e62Revision changes
    • info

      the endpoint scheme security bearerAuth was removed from the API