API Reference
Developer API
Integrate with ZGCNS services using our RESTful API. Build custom applications, automate workflows, and create seamless integrations.
Base URL
https://api.zgcns.com
All API requests should be made to the base URL above. Authentication is required for most endpoints.
API Endpoints
POST
Communication/api/contactSubmit contact form inquiries
Example Request:
{
"name": "John Doe",
"email": "john@company.com",
"company": "Acme Corp",
"countryCode": "+1",
"phone": "5551234567",
"subject": "Project Inquiry",
"message": "Interested in AI implementation",
"serviceCategories": ["ai-consulting", "software-dev"],
"preferredContact": "email"
}POST
Communication/api/newsletterSubscribe to newsletter updates
Example Request:
{
"email": "user@company.com"
}POST
Careers/api/apply-jobSubmit job applications with resume
Example Request:
{
"name": "Jane Smith",
"email": "jane@email.com",
"phone": "5551234567",
"position": "Senior AI Engineer",
"experience": "5+ years",
"coverLetter": "Experienced AI engineer...",
"resumeFile": "base64_encoded_file"
}GET
System/api/healthSystem health check endpoint
Example Response:
{
"status": "healthy",
"timestamp": "2024-01-15T10:30:00Z",
"version": "1.0.0"
}SDK Examples
JavaScript
// Install the ZGCNS SDK
npm install @zgcns/sdk
// Initialize the client
import { ZGCNSClient } from '@zgcns/sdk'
const client = new ZGCNSClient({
apiKey: 'your-api-key',
baseURL: 'https://api.zgcns.com'
})
// Submit contact form
const response = await client.contact.submit({
name: 'John Doe',
email: 'john@company.com',
message: 'Project inquiry',
serviceCategories: ['ai-consulting']
})Python
# Install the ZGCNS SDK
pip install zgcns-sdk
# Initialize the client
from zgcns import ZGCNSClient
client = ZGCNSClient(
api_key='your-api-key',
base_url='https://api.zgcns.com'
)
# Submit contact form
response = client.contact.submit({
'name': 'John Doe',
'email': 'john@company.com',
'message': 'Project inquiry',
'service_categories': ['ai-consulting']
})cURL
# Submit contact form
curl -X POST https://api.zgcns.com/api/contact \
-H "Content-Type: application/json" \
-H "Authorization: Bearer your-api-key" \
-d '{
"name": "John Doe",
"email": "john@company.com",
"message": "Project inquiry",
"serviceCategories": ["ai-consulting"]
}'