skylab-studio 0.0.3

Skylab Studio python client

Skylab Studio Python Client

SkylabTech Studio Python client.

studio.skylabtech.ai

Requirements

• Python requests library

Installation

$ pip install skylab_studio

Usage

For all examples, assume:

import skylab_studio

api = skylab_studio.api(api_key='YOUR-API-KEY')

Error Handling

By default, the API calls return a response object no matter the type of response.

Endpoints

List all jobs

api.list_jobs()

Create job

payload = {
  'profile_id': 1
}

api.create_job(payload=payload)

For all payload options, consult the API documentation.

Get job

api.get_job(job_id)

Update job

payload = {
  'profile_id': 2
}

api.create_job(job_id, payload=payload)

For all payload options, consult the API documentation.

Queue job

payload = {
  "callback_url": "desired_callback_url"
}

api.queue_job(job_id, payload)

Delete job

api.delete_job(job_id)

Cancel job

api.cancel_job(job_id)

List all profiles

api.list_profiles()

Create profile

payload = {
  'name': 'My profile'
}

api.create_profile(payload=payload)

For all payload options, consult the API documentation.

Get profile

api.get_profile(profile_id)

Update profile

payload = {
  'name': 'My profile'
}

api.create_profile(profile_id, payload=payload)

For all payload options, consult the API documentation.

List all photos

api.list_photos()

Get photo upload url

Returns key for create photo

api.get_upload_url()

Create photo

api.create_photo(payload=payload)

For all payload options, consult the API documentation.

Get photo

api.get_photo(photo_id)

Upload photo

upload_photo(photo_path, model, model_id, use_cache_upload=False)

model can either be 'job' or 'profile'

model_id is the jobs/profiles respective id

api.upload_photo('/path/to/photo', 'job', job_id)

OR

api.upload_photo('/path/to/photo', 'profile', profile_id)

Delete photo

api.delete_photo(photo_id)

Validate hmac headers

Applicable if you utilize the job callback url. Use to validate the job payload integrity.

• secret_key (string): Obtain from Skylab

• job_json (string): Stringified json object obtained from callback PATCH request

• request_timestamp (string): Obtained from callback PATCH request header 'X-Skylab-Timestamp'

• signature (string): Signature generated by Skylab to compare. Obtained from callback PATCH request header 'X-Skylab-Signature'

Returns True or False based on whether or not the signatures match.

api.validate_hmac_headers(secret_key, job_json, request_timestamp, signature)

Expected Responses

Success

    >>> response.status_code
    200

    >>> response.json().get('success')
    True

    >>> response.json().get('status')
    u'OK'

    >>> response.json().get('profile_id')
    u'numeric-profile-id'

Error

• Malformed request

    >>> response.status_code
    422

• Bad API key

    >>> response.status_code
    403

Testing

To run the test suite:

pytest

To run the test suite with code coverage metrics:

pytest --cov-report --cov=skylab_studio

Troubleshooting

General Troubleshooting

• Enable debug mode
• Make sure you're using the latest Python client
• Capture the response data and check your logs — often this will have the exact error

Enable Debug Mode

Debug mode prints out the underlying request information as well as the data payload that gets sent to Studio. You will most likely find this information in your logs. To enable it, simply put debug=True as a parameter when instantiating the API object. Use the debug mode to compare the data payload getting sent to Studio' API docs.

import skylab_studio

api = skylab_studio.api(api_key='YOUR-API-KEY', debug=True)

Response Ranges

Studio' API typically sends responses back in these ranges:

• 2xx – Successful Request
• 4xx – Failed Request (Client error)
• 5xx – Failed Request (Server error)

If you're receiving an error in the 400 response range follow these steps:

• Double check the data and ID's getting passed to Studio
• Ensure your API key is correct
• Log and check the body of the response

Distribution

To package:

  python setup.py sdist bdist_wheel
  python -m twine upload dist/*