API & MCP — ajanı her yerden görevlendirin

OnePress bilinçli olarak küçük bir yüzey sunar: görev gönderin, sonucu sorgulayın, konuşmayı sürdürün. Scriptler, diğer ajanlar ve Claude Code gibi MCP hostları için yeterli.

API anahtarı alın

Uygulamada: Settings → Account → API keys → Create. Anahtar bir kez gösterilir (opk_ ile başlar) — kodun içinde değil, ortamınızda saklayın. Aynı sayfadan istediğiniz anahtarı iptal edin; en fazla 10 aktif anahtar.

Her istek, tıpkı sohbette olduğu gibi kendi kredilerinizden faturalanır — ve her anahtar dakikada 60 istekle sınırlıdır.

REST API

Üç çağrı tüm sözleşmeyi kapsar:

Görev oluşturun

curl -X POST https://www.getonepress.com/api/v1/conversations \
  -H "Authorization: Bearer $ONEPRESS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"message": "Research the AI coding-agent market and draft a one-page brief"}'
# → 202 {"conversationId": "conv_…", "injected": false}

Sonucu sorgulayın

curl https://www.getonepress.com/api/v1/conversations/conv_… \
  -H "Authorization: Bearer $ONEPRESS_API_KEY"
# → {"status": "running"|"done", "answer": "…", "preview_path": "…"}

status "done" olduğunda, answer ajanın özetini taşır ve preview_path çalışma alanınızdaki teslimatı gösterir — önizlemek, paylaşmak veya dışa aktarmak için uygulamada açın.

Konuşmayı sürdürün

curl -X POST https://www.getonepress.com/api/v1/conversations/conv_… \
  -H "Authorization: Bearer $ONEPRESS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"message": "make the brief punchier"}'

Takip mesajları tam bağlamı korur. Bir çalıştırma hâlâ aktifse, mesaj bir sonraki tura enjekte edilir ("injected": true) — aynı konuşmayı sorgulamaya devam edin.

Zapier, Make veya n8n'den tetikleyin

HTTP isteği gönderebilen herhangi bir araç ajanı görevlendirebilir — aynı üç çağrı webhook olarak çalışır. Zapier'de Webhooks → POST, Make'te bir HTTP → Make a request modülü kullanın:

URL	https://www.getonepress.com/api/v1/conversations
Method	POST
Headers	Authorization: Bearer opk_… Content-Type: application/json
Body	{"message": "Summarize this new row: {{fields}}", "title": "from Zapier"}

Tetikleyici uygulamadaki alanları message içine eşleyin — yeni bir Airtable satırı, bir Stripe ödemesi, bir form gönderimi — ve çalıştırma hemen başlar. Sonucu aynı Zap içinde geri almanız gerekiyorsa, ikinci bir adımda dönen conversationId'yi sorgulayın.

MCP sunucusu

REST yerine araçları mı tercih edersiniz? MCP özellikli herhangi bir hostu uç noktaya yönlendirin, üç araç elde eder — onepress_create_task, onepress_task_status, onepress_list_tasks:

{
  "mcpServers": {
    "onepress": {
      "url": "https://www.getonepress.com/api/mcp",
      "headers": { "Authorization": "Bearer opk_..." }
    }
  }
}

Artık diğer ajanlar sizinkini görevlendirebilir — "use onepress to make that deck" Claude Code, Cursor veya herhangi bir MCP hostundan çalışır.

İşlemeye değer hatalar

Durum	Anlamı
401	Eksik veya iptal edilmiş anahtar
402	Kredi bitti — Settings'ten yükleme yapın
409	Konuşma meşgul — mesaj kuyruğa alındı, sorgulamaya devam edin
429	Hız limiti (60 istek/dk) veya çok fazla aktif çalıştırma — geri çekilin

API'nin bilerek yapmadığı şeyler

Çalışma alanı dosya indirme yok, streaming yok, grup konuşmaları yok — henüz. Sözleşme "görev gönderin, sonucu alın"dır ve yalnızca büyür, asla bozulmaz. İhtiyacınızı support [at] getonepress.com adresine bildirin; gerçek kullanım bir sonraki yüzeyi şekillendirir.

Bir anahtar, otuz saniye

Settings → Account → API keys → Create. Sonra yukarıdaki curl'ü çalıştırın ve ilk görevinizi izleyin.

Uygulamayı açın