Beta Environment — Features may be unstable or change without notice.
Skip to main content

SECiD API Documentation

Complete reference for integrating with the SECiD platform

API Version 1.0 REST API GraphQL Support

Overview

The SECiD API provides programmatic access to the platform's core features including user management, job postings, events, forums, and gamification systems. Our RESTful API is designed to be intuitive and follows industry standards.

Base URL

https://api.secid.org/v1

🚀 Production

https://api.secid.org/v1

🧪 Sandbox

https://api-sandbox.secid.org/v1

Authentication

The SECiD API uses JWT (JSON Web Tokens) for authentication. Include your token in the Authorization header of your requests.

curl -H "Authorization: Bearer YOUR_JWT_TOKEN" \
    https://api.secid.org/v1/users/me

Getting a Token

POST /auth/login

{
  "email": "user@example.com",
  "password": "your-password"
}

Returns a JWT token valid for 24 hours.

Rate Limiting

API requests are rate limited to ensure fair usage and platform stability.

PlanRequests/HourBurst Limit
Free1,000100/minute
Premium10,000500/minute
Enterprise100,0002,000/minute

Error Handling

The API uses conventional HTTP response codes to indicate success or failure of requests.

200 OK

Request succeeded

400 Bad Request

Invalid request parameters

401 Unauthorized

Authentication required

429 Too Many Requests

Rate limit exceeded

Interactive API Explorer

📚

Loading interactive API documentation...

Code Examples

JavaScript

const response = await fetch('https://api.secid.org/v1/jobs', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_JWT_TOKEN',
    'Content-Type': 'application/json'
  }
});

const jobs = await response.json();
console.log(jobs);

Python

import requests

headers = {
    'Authorization': 'Bearer YOUR_JWT_TOKEN',
    'Content-Type': 'application/json'
}

response = requests.get('https://api.secid.org/v1/jobs', headers=headers)
jobs = response.json()
print(jobs)

cURL

curl -X GET   -H "Authorization: Bearer YOUR_JWT_TOKEN"   -H "Content-Type: application/json"   https://api.secid.org/v1/jobs

Official SDKs

We provide official SDKs to make integration easier.

JS

JavaScript/TypeScript

npm install @secid/api-client View Documentation →
PY

Python

pip install secid-api View Documentation →
GO

Go

go get github.com/secid/go-sdk View Documentation →

Webhooks

Webhooks allow you to receive real-time notifications when events occur in your account.

Coming Soon

Webhook functionality is currently in development and will be available in the next release.

Report an issue

Show diagnostics

Environment

            

Console errors

            

Failed requests