API Documentation

ChristianHN API for developers and cross-app integration

Service API (Cross-App Posting)

The Service API allows authorized applications (Manna, FaithMatch, Remail, etc.) to post releases and announcements to ChristianHN.

POST /api-chirho/service-chirho/submit-chirho

Submit a new post on behalf of a service

Headers

Authorization: Bearer <SERVICE_API_KEY>
Content-Type: application/json

Request Body

{
  "titleChirho": "Manna v2.0 Released",
  "urlChirho": "https://manna.kingdominvest.ing",
  "textChirho": "Optional description text",
  "categoryChirho": "release",
  "sourceServiceChirho": "manna",
  "metadataChirho": {
    "versionChirho": "2.0.0",
    "changelogChirho": "New features and fixes"
  }
}

Response

{
  "successChirho": true,
  "dataChirho": {
    "idChirho": "abc123...",
    "urlChirho": "https://news.kingdominvest.ing/item/abc123",
    "permalinkChirho": "/item/abc123"
  }
}
GET /api-chirho/service-chirho/verify-chirho

Verify service API key and check quota

Response

{
  "successChirho": true,
  "dataChirho": {
    "serviceNameChirho": "manna",
    "permissionsChirho": ["service:post"],
    "quotaRemainingChirho": 18,
    "dailyQuotaChirho": 20
  }
}

Categories

software

General software

show-chn

Project showcases

ask-chn

Community questions

release

Version releases

ministry

Ministry tech

jobs

Job listings

Error Codes

401 Invalid or missing API key
403 Insufficient permissions or quota exceeded
400 Invalid request body or parameters
500 Server error

Rate Limits

  • Service API: 10-50 posts per day (varies by service)
  • Quota resets at midnight UTC
  • Check /verify-chirho for current quota

Need an API Key?

Service API keys are issued to approved Chirho project apps. Contact support@kingdominvest.ing to request integration.

ChristianHN

"Whatever you do, work heartily, as for the Lord" — Colossians 3:23

JESUS CHRIST IS LORD