Skip to main content

Environments and Authentication

Environments

Palenca has 2 independent and unique environments for each organization.

Sandbox: Use during the development stage. You can create unlimited users and accounts in this environment at no cost. To use this environment you must use the base host https://sandbox.palenca.com/v1

Production: Use when operating in production. Each user and account created will be validated on the respective platform on which the connection is created. To use this environment you must use the base host https://api.palenca.com/v1

Users, accounts and logins created in an environment are independent.

Protocols and Headers

The Palenca API uses POST requests to communicate and HTTP response codes to indicate status and errors. All responses are delivered in standard JSON format. The API is served over HTTPS TLS [v1.3+] to ensure data privacy; HTTP and HTTPS are not supported with TLS versions lower than 1.3. Customers must use an updated set of root certificates as the only way to verify TLS; Certificate pinning should never be used.

All requests must include a Content-Type:application/json header and, where necessary, the payload must follow the JSON standard.

Authentication

Almost all API routes require a private key. The private key is sent in the request headers as x-api-key.

Status and Incidents

The real-time API status is found at status.palenca.com