डेवलपर प्लेटफ़ॉर्म

बनाएँ
CouthActs पर।

AI सहायकों के लिए एजेंट API और MCP सर्वर, डिस्पैच और टेलीमैटिक्स सिस्टम के लिए प्रोवाइडर API, और हस्ताक्षरित कस्टडी रिकॉर्ड जाँचने के सार्वजनिक एंडपॉइंट। Bearer कुंजियों के साथ HTTPS पर सादा JSON।

API कुंजियाँ पाएँ हमसे बात करें

कुंजियाँ और सीमाएँ

अपनी कुंजी चुनें।

एजेंट कुंजियाँ

कोई प्लान शुल्क नहीं

ग्राहक खाते की ओर से काम करने वाले AI एजेंटों और सहायकों के लिए।

आपके चुने हुए स्कोप: कोट, जॉब, बुकिंग, वॉलेट और ट्रस्ट
प्रति-जॉब और मासिक ख़र्च सीमाएँ, साथ में एक अनुमोदन सीमा
प्रति कुंजी हर मिनट 120 अनुरोध तक
सेटिंग्स → AI एजेंट में बनाएँ, या OAuth से कोई सहायक जोड़ें

एजेंट कुंजी बनाएँ

प्रोवाइडर API

Basic प्लान

अपने डिस्पैच या टेलीमैटिक्स सिस्टम जोड़ने वाले प्रोवाइडरों के लिए।

Basic: हर महीने 500 कॉल, इसके बाद कॉल अस्वीकार होती हैं
खुले जॉब, आपकी बुकिंग, आपका वॉलेट और लोकेशन अपडेट
Professional (हर महीने 5,000 कॉल) और Enterprise: जल्द आ रहे हैं
सेटिंग्स → प्रोवाइडर API कुंजियाँ में कुंजियाँ बनाएँ

प्रोवाइडर कुंजियाँ प्रबंधित करें

ग्राहक API

समझौते के अनुसार

किसी ग्राहक के अपने जॉब, बिड और वॉलेट के लिए REST एंडपॉइंट।

Starter: हर महीने 1,000 कॉल, इसके बाद कॉल अस्वीकार होती हैं
Growth: हर महीने 5,000 कॉल, फिर प्रति कॉल US$0.20, अगले महीने आपके वॉलेट से लिया जाता है
Enterprise: तय की गई सीमाएँ
कुंजियाँ अभी सेल्फ़-सर्व नहीं हैं; ज़्यादातर ग्राहकों को इसके बजाय एजेंट कुंजी इस्तेमाल करनी चाहिए

हमसे संपर्क करें

प्रोवाइडर API के पेड प्लान (Professional और Enterprise) जल्द आ रहे हैं; अगर अभी ज़्यादा सीमा चाहिए तो हमसे संपर्क करें। आपका मौजूदा प्लान और उपयोग सेटिंग्स में दिखता है। API किसी सर्विस-लेवल प्रतिबद्धता के बिना दिए जाते हैं।

क्विक स्टार्ट

पहली कॉल तक तीन कदम।

कदम 01

अपनी कुंजी पाएँ

ग्राहक और AI एजेंट: सेटिंग्स → AI एजेंट। प्रोवाइडर: सेटिंग्स → प्रोवाइडर API कुंजियाँ। पूरी कुंजी केवल एक बार, बनाते समय दिखाई जाती है।

कदम 02

अपना पहला अनुरोध भेजें

अपनी कुंजी Authorization: Bearer में भेजें। प्रोवाइडर GET /api/provider/v1/jobs से शुरू कर सकते हैं।

कदम 03

एजेंट टूल देखें

एजेंट कुंजियाँ: /api/agent/openapi.json पर OpenAPI विवरण पढ़ें, या किसी MCP क्लाइंट को /api/mcp से जोड़ें।

उदाहरण अनुरोध

curl -X GET https://couthacts.com/api/provider/v1/jobs \
  -H "Authorization: Bearer ca_provider_your_key_here" \
  -H "Content-Type: application/json"

# Response
{
  "success": true,
  "data": [
    {
      "id": "clx...",
      "mode": "FREIGHT_TRUCKING",
      "title": "Freight: Dallas, TX → Houston, TX",
      "status": "OPEN",
      "originAddress": "Dallas, TX",
      "destinationAddress": "Houston, TX",
      "pickupDate": "2026-11-05T08:00:00.000Z",
      "budgetUsd": "2500",
      "insuranceTier": "NONE",
      "_count": { "bids": 3 }
    }
  ],
  "meta": { "page": 1, "limit": 20, "total": 1, "pages": 1, "requestId": "…", "timestamp": "…" }
}

एंडपॉइंट

पूरा संदर्भ।

API, एजेंट और MCP के जवाबों में हर राशि USD में होती है (Usd पर खत्म होने वाले फ़ील्ड): CouthActs केवल USD में भुगतान लेता और देता है। स्थानीय मुद्रा में बराबर राशि दिखाने के लिए हर स्क्रीन पर एक बार GET /api/currency/display कॉल करें और गुणा करें: स्थानीय ≈ amountUsd × rate। पहले USD राशि दिखाएं और स्थानीय राशि को अनुमान के रूप में।

एजेंट API और MCP

GET/api/agent/v1/tools
आपकी एजेंट कुंजी जो कार्रवाइयाँ कर सकती है उनकी सूची, इनपुट स्कीमा के साथ।
एजेंट कुंजी
POST/api/agent/v1/tools/{name}
आपकी कुंजी के स्कोप, ख़र्च सीमाओं और अनुमोदन नियमों के भीतर कोई कार्रवाई (जैसे get_quote या post_job) चलाएँ।
एजेंट कुंजी
GET/api/agent/openapi.json
एजेंट टूल का OpenAPI 3.1 विवरण।
कोई नहीं
POST/api/mcp
वही कार्रवाइयाँ Model Context Protocol पर, Claude, ChatGPT और अन्य MCP-सक्षम सहायकों के लिए।
एजेंट कुंजी / OAuth

प्रोवाइडर API

GET/api/provider/v1/jobs
आपके पंजीकृत ट्रांसपोर्ट मोड में खुले जॉब (मोड से फ़िल्टर; पेज के अनुसार)।
प्रोवाइडर API कुंजी
GET/api/provider/v1/bookings
स्थिति, ट्रैकिंग कोड और भुगतान होल्ड की स्थिति के साथ आपकी बुकिंग।
प्रोवाइडर API कुंजी
POST/api/provider/v1/tracking
सक्रिय बुकिंग की लोकेशन रिपोर्ट करें; यह ग्राहक को दिखती है और कस्टडी रिकॉर्ड में दर्ज होती है।
प्रोवाइडर API कुंजी
GET/api/provider/v1/wallet
आपका वॉलेट बैलेंस और हाल के लेनदेन।
प्रोवाइडर API कुंजी

ग्राहक API

GET · POST/api/v1/jobs
अपने जॉब देखें, या जॉब पोस्ट करें (शुल्क लेता है और आपके वॉलेट से बजट होल्ड करता है)।
ग्राहक API कुंजी
GET · PATCH/api/v1/jobs/{id}
कोई एक जॉब देखें, उसका बजट या विवरण बदलें, या उसे रद्द करें।
ग्राहक API कुंजी
GET · POST/api/v1/bids
अपने जॉब पर आई बिड देखें, या कोई बिड स्वीकार या अस्वीकार करें।
ग्राहक API कुंजी
GET/api/v1/wallet
आपका वॉलेट बैलेंस।
ग्राहक API कुंजी

सार्वजनिक (बिना कुंजी)

GET/api/track/{code}
ट्रैकिंग कोड से बुकिंग की स्थिति, रूट और ट्रैकिंग घटनाएँ। कोई वित्तीय डेटा नहीं।
कोई नहीं
GET/api/custody/public/{trackingCode}
किसी बुकिंग का कस्टडी रिकॉर्ड अपरिवर्तित होने का सार्वजनिक प्रमाण (घटना प्रकार, समय, हैश और हस्ताक्षर)।
कोई नहीं
GET/api/credentials/provider/{id}
किसी प्रोवाइडर का हस्ताक्षरित क्रेडेंशियल (सत्यापन स्थिति और ट्रैक रिकॉर्ड)।
कोई नहीं
GET/.well-known/couthacts-keys.json
हस्ताक्षर जाँचने के लिए CouthActs की सार्वजनिक Ed25519 कुंजियाँ।
कोई नहीं
POST/api/trust/verify
कस्टडी प्रमाणपत्र या प्रोवाइडर क्रेडेंशियल जाँचें।
कोई नहीं
GET/api/currency/display
उपयोगकर्ता की दिखाई जाने वाली मुद्रा और USD के मुकाबले उसकी दर (लाइव दर न होने पर rate null होता है: केवल USD दिखाएं)।
कोई नहीं
GET/api/currency/supported
पिकर के लिए दिखाई जाने वाली मुद्राएं: कोड, नाम, चिह्न और दशमलव स्थान।
कोई नहीं

प्रोवाइडर ट्रैकिंग

अपने सिस्टम से लोकेशन रिपोर्ट करें।

कन्फ़र्म या चालू बुकिंग के लिए लोकेशन भेजें। यह ग्राहक को रियल टाइम में दिखती है और हस्ताक्षरित कस्टडी रिकॉर्ड में चेकपॉइंट के रूप में दर्ज होती है। आप लेयर नाम से बता सकते हैं कि रीडिंग कहाँ से आई। CouthActs यह टैग दर्ज करता है, पर ख़ुद AIS, फ़्लाइट, ELD, सेंसर या सैटेलाइट फ़ीड से नहीं जुड़ता और उन्हें नहीं जाँचता: डेटा वही है जो आप रिपोर्ट करते हैं।

स्वीकृत लेयर टैग

MOBILE_GPS

मोबाइल GPS

फ़ोन या वाहन के GPS की पोज़िशन (डिफ़ॉल्ट)।

AIS_MARITIME

AIS (समुद्री)

आपके AIS स्रोत से जहाज़ की पोज़िशन।

FLIGHT_TRACKING

फ़्लाइट ट्रैकिंग

आपके फ़्लाइट-ट्रैकिंग स्रोत से विमान की पोज़िशन।

ELD_INTEGRATION

ELD

आपके इलेक्ट्रॉनिक लॉगिंग डिवाइस से ट्रक की पोज़िशन।

QR_PIN_CONFIRMATION

PIN हैंडओवर

हैंडओवर के समय की पोज़िशन। डिलीवरी PIN ख़ुद ऐप में डाला जाता है।

IOT_DEVICE

IoT डिवाइस

आपके ट्रैकर से पोज़िशन। सेंसर रीडिंग सहेजी नहीं जातीं।

SATELLITE

सैटेलाइट

आपके सैटेलाइट ट्रैकर से पोज़िशन।

DOCUMENT_POD_AI

डिलीवरी का प्रमाण

केवल पोज़िशन टैग। CouthActs दस्तावेज़ों का विश्लेषण नहीं करता।

BIOMETRIC

बायोमेट्रिक

केवल पोज़िशन टैग। CouthActs हैंडओवर पर कोई बायोमेट्रिक जाँच नहीं करता।

लोकेशन रिपोर्ट करें

POST /api/provider/v1/tracking
Authorization: Bearer ca_provider_your_key_here
Content-Type: application/json

{
  "bookingId": "clx...",
  "lat": 32.7767,
  "lng": -96.7970,
  "layer": "MOBILE_GPS",
  "status": "IN_TRANSIT",
  "note": "Departed Dallas warehouse"
}

ऑथ और सुरक्षा

एक्सेस कैसे नियंत्रित होता है।

Bearer कुंजियाँ

हर अनुरोध में Authorization: Bearer ज़रूरी है। कुंजियाँ सेटिंग्स में बनती हैं, एक बार दिखती हैं और कभी भी रद्द की जा सकती हैं।

केवल HTTPS

कुंजियाँ केवल HTTPS पर भेजें। इन्हें कभी सार्वजनिक कोड या क्लाइंट-साइड ऐप में न डालें।

सीमाएँ

एजेंट कुंजियाँ: हर मिनट 120 अनुरोध। प्रोवाइडर और ग्राहक API कुंजियाँ: उनके प्लान की मासिक कॉल, जो X-RateLimit-Limit और X-RateLimit-Remaining हेडर में बताई जाती हैं।

गतिविधि लॉग

हर एजेंट कार्रवाई उसके टूल, स्थिति, राशि, इनपुट और परिणाम के साथ लॉग होती है और सेटिंग्स में दिखती है। प्रोवाइडर कुंजियाँ अपने अनुरोधों की संख्या और आख़िरी इस्तेमाल दिखाती हैं।

ख़र्च सीमाएँ और अनुमोदन

एजेंट कुंजियाँ अपनी प्रति-जॉब या मासिक सीमा पार नहीं कर सकतीं, और अनुमोदन सीमा से ऊपर की कार्रवाइयाँ मालिक के अनुमोदन का इंतज़ार करती हैं (अनुरोध 72 घंटे बाद समाप्त हो जाते हैं)।

हस्ताक्षरित रिकॉर्ड, हस्ताक्षरित अनुरोध नहीं

कस्टडी रिकॉर्ड और प्रोवाइडर क्रेडेंशियल CouthActs की Ed25519 कुंजी से हस्ताक्षरित होते हैं, ताकि कोई भी उन्हें जाँच सके। API अनुरोध और प्रतिक्रियाएँ हस्ताक्षरित नहीं होतीं, और CouthActs आउटबाउंड वेबहुक नहीं भेजता।

प्रतिक्रिया फ़ॉर्मैट

एक-सा। अनुमानित।

प्रोवाइडर और ग्राहक API की प्रतिक्रियाएँ नीचे दिए फ़ॉर्मैट में होती हैं। एजेंट API की प्रतिक्रियाओं में इसके बजाय status, actionId और result फ़ील्ड होते हैं; OpenAPI विवरण देखें।

सफल (2xx)

{
  "success": true,
  "data": { ... },
  "meta": {
    "requestId": "req_...",
    "timestamp": "2026-04-01T..."
  }
}

त्रुटि (4xx/5xx)

{
  "success": false,
  "error": {
    "code": "INVALID_INPUT",
    "message": "bookingId, lat, lng required"
  },
  "meta": {
    "requestId": "req_...",
    "timestamp": "2026-04-01T..."
  }
}

बिल्डर्स का स्वागत है

क्या आप इंटीग्रेट करने को तैयार हैं?

सेटिंग्स में कुंजी बनाएँ और मिनटों में अपनी पहली कॉल करें। ज़्यादा सीमाओं या Enterprise प्लान के लिए हमसे संपर्क करें।

API कुंजियाँ पाएँ हमसे बात करें

बनाएँCouthActs पर।

अपनी कुंजी चुनें।

एजेंट कुंजियाँ

प्रोवाइडर API

ग्राहक API

पहली कॉल तक तीन कदम।

अपनी कुंजी पाएँ

अपना पहला अनुरोध भेजें

एजेंट टूल देखें

पूरा संदर्भ।

एजेंट API और MCP

प्रोवाइडर API

ग्राहक API

सार्वजनिक (बिना कुंजी)

अपने सिस्टम से लोकेशन रिपोर्ट करें।

स्वीकृत लेयर टैग

मोबाइल GPS

AIS (समुद्री)

फ़्लाइट ट्रैकिंग

ELD

PIN हैंडओवर

IoT डिवाइस

सैटेलाइट

डिलीवरी का प्रमाण

बायोमेट्रिक

एक्सेस कैसे नियंत्रित होता है।

Bearer कुंजियाँ

केवल HTTPS

सीमाएँ

गतिविधि लॉग

ख़र्च सीमाएँ और अनुमोदन

हस्ताक्षरित रिकॉर्ड, हस्ताक्षरित अनुरोध नहीं

एक-सा। अनुमानित।

क्या आप इंटीग्रेट करने को तैयार हैं?

बनाएँ
CouthActs पर।