Crop.photo Development
  1. Crop.photo API
Crop.photo Development
  • Crop.photo API
    • Introduction
    • Authentication
    • FAQs
    • Interactive API Testing
    • AI Lifestyle Crop
      POST
    • Auto Resize & Align
      POST
    • Body Aware Crop
      POST
    • Unrecognizable Crop
      POST
    • Remove Background
      POST
    • Create Banner Job
      POST
    • Banners Job Status
      POST
  • Schemas
    • Crop.photo Schema
      • Body Marker Margins
      • Preserve Edge Contact
      • Center Around Face
      • Unrecognizable Markers
      • Auto Resize and Align Minimum Margins
      • Minimum Margins Lifestyle
      • Output Size and Format
      • Background Settings
      • Image Response Type
      • Image URL
      • Body Aware Crop Markers
      • Ai model & Analysis hints
      • Unrecognizable Crop Margins
    • Schemas
      • CreateBannerRequest
      • InputFile
      • MaskFile
      • OutputDimensions
      • BannerConfiguration
      • OutputDimension
      • Output
  1. Crop.photo API

Banners Job Status

Developing
Localhost
http://localhost:8081/v1
Localhost
http://localhost:8081/v1
POST
/banners/with-mask/status
This API endpoint provides the functionality to query the status of multiple photo cropping jobs using tags specified at the time of job submission. Users can retrieve a consolidated status report for all jobs matching the provided tags, enabling efficient tracking of related jobs.

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Body Params application/json

Example
{
    "job_id": "string",
    "job_labels": [
        "car-model-lot-1"
    ],
    "start": 0,
    "limit": 20
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'http://localhost:8081/v1/banners/with-mask/status' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "job_id": "string",
    "job_labels": [
        "car-model-lot-1"
    ],
    "start": 0,
    "limit": 20
}'

Responses

🟢200Success
application/json
Body

Example
{
    "jobs": [
        {
            "job_id": "string",
            "status": "pending",
            "job_labels": [
                "string"
            ]
        }
    ],
    "results": [
        {
            "output_image_url": "string",
            "crop_coordinates": {
                "x": 0.1,
                "y": 0.2,
                "width": 0.4,
                "height": 0.4
            }
        }
    ],
    "error_message": "string"
}
🟠401Unauthorized
🟠400Invalid Input | Crop.photo
Modified at 2024-04-19 06:03:31
Previous
Create Banner Job
Next
Body Marker Margins
Built with