Quick Start Guide
Get started with DPaaS in less than 5 minutes.
Prerequisites
- cURL, Python, or your favorite HTTP client
- An internet connection
Step 1: Create an Organization
Every DPaaS setup starts with an Organization - this is your top-level container.
- cURL
- Python
curl -X POST https://api.solucao42.com.br/organizations \
-H "Content-Type: application/json" \
-d '{
"name": "My Company",
"slug": "mycomp"
}'
from dpaas import Client
client = Client(base_url="https://api.solucao42.com.br")
org = client.organizations.create(
name="My Company",
slug="mycomp"
)
print(org)
Success!
You've created your organization with slug mycomp
Step 2: Authenticate
Now login to get your access token:
- cURL
- Python
curl -X POST https://api.solucao42.com.br/authentication/login \
-H "Content-Type: application/json" \
-d '{
"email": "[email protected]",
"password": "yourpassword",
"organization_slug": "mycomp"
}'
from dpaas import Client
client = Client(
base_url="https://api.solucao42.com.br",
email="[email protected]",
password="yourpassword",
organization_slug="mycomp"
)
# Client is now authenticated!
Response:
{
"access_token": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...",
"refresh_token": "abc123def456...",
"token_type": "Bearer",
"expires_in": 900
}
note
💡 Save the access_token - you'll need it for all API calls!
Step 3: Make Your First API Call
Now use your token to list accounts:
- cURL
- Python
curl https://api.solucao42.com.br/accounts \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"
# Client is already authenticated from Step 2!
accounts = client.accounts.list()
print(accounts)
Response:
{
"total": 1,
"page": 1,
"results": [
{
"id": "acc-123",
"name": "Default Account",
"is_default": true,
"created_at": "2025-09-30T10:00:00Z"
}
]
}
🎉 Congratulations!
You've successfully:
- ✅ Created an organization
- ✅ Authenticated and got a JWT token
- ✅ Made your first API call
Next Steps
Now that you're up and running:
-
Learn the basics
- Project Structure - Understand organizations, accounts, and users
- Authentication - Deep dive into authentication
-
Try advanced features
- Service Accounts - For API automation
- Authorization & Policies - Control access with policies
-
Integrate with your app
- Python SDK - Use our official SDK
- API Reference - Complete API documentation
Need help?
Check the troubleshooting guide or report issues on GitHub.