واجهة ONPChat البرمجية

curl https://api.onpchat.ir/v1/me \
  -H "Authorization: Bearer $ONP_TOKEN"

const r = await fetch("https://api.onpchat.ir/v1/me", {
  headers: { "Authorization": `Bearer ${process.env.ONP_TOKEN}` },
});
const { ok, result } = await r.json();

import os, requests

r = requests.get(
    "https://api.onpchat.ir/v1/me",
    headers={"Authorization": f"Bearer {os.environ['ONP_TOKEN']}"},
)
print(r.json())

$ch = curl_init("https://api.onpchat.ir/v1/me");
curl_setopt_array($ch, [
  CURLOPT_HTTPHEADER => ["Authorization: Bearer " . getenv("ONP_TOKEN")],
  CURLOPT_RETURNTRANSFER => true,
]);
$res = json_decode(curl_exec($ch), true);

https://onpchat.ir/api/space/api-token?entity_id=<id>

curl -X POST https://api.onpchat.ir/v1/channels/%231786551855736/messages \
  -H "Authorization: Bearer $ONP_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"text":"Hello from the API"}'

await fetch(
  "https://api.onpchat.ir/v1/channels/%231786551855736/messages",
  {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${process.env.ONP_TOKEN}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ text: "Hello from the API" }),
  },
);

import os, requests

requests.post(
    "https://api.onpchat.ir/v1/channels/%231786551855736/messages",
    headers={"Authorization": f"Bearer {os.environ['ONP_TOKEN']}"},
    json={"text": "Hello from the API"},
)

$url = "https://api.onpchat.ir/v1/channels/%231786551855736/messages";
$ch = curl_init($url);
curl_setopt_array($ch, [
  CURLOPT_POST => true,
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer " . getenv("ONP_TOKEN"),
    "Content-Type: application/json",
  ],
  CURLOPT_POSTFIELDS => json_encode(["text" => "Hello from the API"]),
  CURLOPT_RETURNTRANSFER => true,
]);
curl_exec($ch);

Authorization: Bearer onp_2e09e8f0bb35088c795e5f75dc...

{ "ok": true,  "result": { ... } }

{ "ok": false, "error": {
    "code": "invalid_token",
    "message": "..."
} }

GET /v1/channels/%231786551855736/messages
      ?limit=30&before_seq=42

{
  "ok": true,
  "result": {
    "messages": [
      {
        "id": "a1b2c3",
        "text": "...",
        "seq": 42,
        "timestamp": 1788301362311
      }
    ],
    "next_cursor": 41
  }
}

curl -X POST https://api.onpchat.ir/v1/groups/%401786579451315/messages \
  -H "Authorization: Bearer $ONP_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "card": {
      "url": "https://example.com/post",
      "title": "...",
      "description": "...",
      "image": "https://example.com/cover.jpg",
      "caption": "..."
    }
  }'

await fetch(url, {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${token}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    card: {
      url: "https://example.com/post",
      title: "...",
      description: "...",
      image: "https://example.com/cover.jpg",
      caption: "...",
    },
  }),
});

requests.post(
    url,
    headers={"Authorization": f"Bearer {token}"},
    json={
        "card": {
            "url": "https://example.com/post",
            "title": "...",
            "description": "...",
            "image": "https://example.com/cover.jpg",
            "caption": "...",
        }
    },
)

curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([
  "card" => [
    "url"         => "https://example.com/post",
    "title"       => "...",
    "description" => "...",
    "image"       => "https://example.com/cover.jpg",
    "caption"     => "...",
  ],
]));

Idempotency-Key: order-2026-09-02-001

HTTP/2 429
X-RateLimit-Limit: 20
X-RateLimit-Remaining: 0
Retry-After: 37