Jobs API

GET /api/jobs

Retrieve a list of all job opportunities in Dzaleka Refugee Camp.

Query Parameters

This endpoint does not require any query parameters.

Response Format

string

required

Status of the API response (“success” or “error”)

number

required

Total number of jobs returned

object

required

Container for the jobs data

array

required

Array of job objects

string

Unique identifier for the job

string

Collection name (“jobs”)

string

Job title

string

Hiring organization name

string

Job location (e.g., “Remote”, “Dzaleka”, “Remote / Dzaleka”)

string

Job type (e.g., “full-time”, “part-time”, “contract”, “internship”)

string

Job category (e.g., “business”, “technology”, “education”)

string

Date posted (YYYY-MM-DD)

string

Application deadline (YYYY-MM-DD)

string

Job status (“open”, “closed”, “filled”)

boolean

Whether the job is featured

string

Job description summary

array

Array of required skills

object

Contact information

string

Application email

string

Organization website

string

Contact phone number

Error Responses

string

“error”

string

Error message description

string

Detailed error information

Status Codes:

200 - Success
429 - Rate limit exceeded (60 requests per minute)
500 - Internal server error

Rate Limiting

All API endpoints are rate-limited to 60 requests per minute per IP address. Rate limit headers are included in responses:

X-RateLimit-Limit: Maximum requests per window
X-RateLimit-Remaining: Remaining requests in current window
X-RateLimit-Reset: Timestamp when the rate limit resets
Retry-After: Seconds to wait before retrying (only on 429 responses)

Example Request

curl -X GET "https://services.dzaleka.com/api/jobs" \
  -H "Content-Type: application/json"

Example Response

{
  "status": "success",
  "count": 1,
  "data": {
    "jobs": [
      {
        "id": "Content-Curator-and-Editor",
        "collection": "jobs",
        "title": "Content Curator & Editor",
        "organization": "Dzaleka Digital Heritage",
        "location": "Remote / Dzaleka",
        "type": "part-time",
        "category": "business",
        "posted": "2025-03-12",
        "deadline": "2025-05-12",
        "status": "open",
        "featured": true,
        "description": "Join Dzaleka Digital Heritage as a Content Curator & Editor to help shape and refine the digital narratives that showcase the stories of Dzaleka's community. Bring your creativity to the forefront by managing and curating multimedia content for our platform.",
        "skills": [
          "Content creation",
          "Editing & proofreading",
          "Digital storytelling",
          "Multimedia curation",
          "Content management systems (CMS)",
          "Photography & video editing",
          "Collaborative Teamwork"
        ],
        "contact": {
          "email": "dzalekaconnect@gmail.com",
          "website": "https://services.dzaleka.com",
          "phone": ""
        }
      }
    ]
  }
}

POST /api/jobs

Retrieve jobs data with optional metadata and statistics.

Request Body

object

Optional configuration for the response

boolean

Include export metadata in response

boolean

Include statistics in response

Response Format

Same as GET endpoint, with optional additional fields:

object

Export metadata (only if includeMetadata: true)

string

ISO 8601 timestamp of export

string

Collection name

object

Statistics (only if includeStats: true)

number

Total number of items

string

Collection name

Example Request

curl -X POST "https://services.dzaleka.com/api/jobs" \
  -H "Content-Type: application/json" \
  -d '{
    "options": {
      "includeMetadata": true,
      "includeStats": true
    }
  }'

Example Response

{
  "status": "success",
  "count": 15,
  "data": {
    "jobs": [
      {
        "id": "Content-Curator-and-Editor",
        "title": "Content Curator & Editor",
        "organization": "Dzaleka Digital Heritage",
        "type": "part-time",
        "status": "open"
      }
    ]
  },
  "metadata": {
    "exportDate": "2025-03-09T12:00:00.000Z",
    "collection": "jobs"
  },
  "stats": {
    "totalItems": 15,
    "collection": "jobs"
  }
}

Implementation

The Jobs API is implemented using the createGetHandler and createPostHandler utility functions from src/utils/api-utils.ts:118. Source code: src/pages/api/jobs.ts:5

Getting Started

Endpoints

Data Models

GET /api/jobs

Query Parameters

Response Format

Error Responses

Rate Limiting

Example Request

Example Response

POST /api/jobs

Request Body

Response Format

Example Request

Example Response

Implementation

​GET /api/jobs

​Query Parameters

​Response Format

​Error Responses

​Rate Limiting

​Example Request

​Example Response

​POST /api/jobs

​Request Body

​Response Format

​Example Request

​Example Response

​Implementation

GET /api/jobs

Query Parameters

Response Format

Error Responses

Rate Limiting

Example Request

Example Response

POST /api/jobs

Request Body

Response Format

Example Request

Example Response

Implementation