The Cecil SDK is a Python 3 library that allows you to use our data platform. The SDK integrates with our internal API using standard HTTP methods, authentication, and response codes. Our data resources use RFC 3339 timestamps and universally unique identifiers (UUID v4).

Installation

Install the Cecil SDK in your project virtual environment.

pip install cecil

Authentication

Configure the SDK authentication by setting the CECIL_API_KEY environment variable. Make sure to store your API key in an encrypted vault or secrets manager. Never store API keys in code or plain/text files.

export CECIL_API_KEY="my-api-key"

set CECIL_API_KEY=my-api-key

Usage

All SDK functions require authentication unless otherwise specified.

import cecil

client = cecil.Client()

client.*funcion_name*()

Usage limits

New organisations start in our usage-based trial with the following limits. To remove usage limits, please get in touch.

• 1,000 hectares across all data requests
• 100 data requests
• 100 transformations
• 36,000 analytics compute seconds

Sign up

Use the Cecil SDK to sign up for an account. You will receive an email with instructions to generate your user API key. The link sent via email expires in 7 days. By signing up, you agree to our pricing and terms.

<aside> <img src="/icons/command-line_gray.svg" alt="/icons/command-line_gray.svg" width="40px" /> sign_up() doesn’t require authentication

</aside>