API anahtarları, MCP sunucusu ve REST API
Form doldurmak yerine işi, zaten kullandığınız bir yapay zekâ ajanına (Claude Code, Cursor gibi) yaptırabilirsiniz. Ajan iki yoldan bağlanır: tarayıcıda sizin onayınızla ya da sizin oluşturduğunuz bir API anahtarıyla. Hangisiyle bağlanırsa bağlansın şunları yapar:
Ajan sizin adınıza çalışır: sizin rolünüzle, anahtarı oluşturduğunuz şirkette. Web uygulamasında rolünüzün yapamadığı hiçbir şeyi yapamaz.
Giriş yapıp Ayarlar → API anahtarları sayfasını açın. Anahtara sonradan tanıyacağınız bir ad verin (örneğin Dizüstündeki Claude Code) ve iki seçim yapın:
Anahtar yalnızca bir kez gösterilir. productrue anahtarın kendisini değil, özetini (hash) saklar. Bu yüzden anahtarı hemen ajanınızın ayarlarına kopyalayın. Kaybederseniz iptal edip yenisini oluşturun.
Ajanınız tarayıcıdan giriş yapmayı destekliyorsa (Claude Code destekliyor) anahtara gerek yok. Bir sonraki adıma geçin.
productrue'nun MCP (Model Context Protocol) sunucusu şu adreste:
https://app.productrue.com/api/v1/mcp
Sunucu Streamable HTTP taşıma katmanını kullanır. Kimlik doğrulamanın iki yolu var.
MCP'nin OAuth girişini destekleyen istemcilere yalnızca adres yeter. Claude Code'da:
claude mcp add --transport http productrue https://app.productrue.com/api/v1/mcp
Ardından Claude Code içinde /mcp yazın, productrue'yu seçip kimlik doğrulamayı başlatın. Tarayıcınızda productrue açılır. Gerekirse giriş yapın, şirketi ve yetkiyi (yalnızca okuma ya da okuma ve yazma) seçip onaylayın. Bağlantı Ayarlar → API anahtarları sayfasındaki Bağlı uygulamalar bölümünde listelenir; oradan istediğiniz zaman kesebilirsiniz.
claude mcp add --transport http productrue https://app.productrue.com/api/v1/mcp \
--header "Authorization: Bearer API_ANAHTARINIZ"
{
"mcpServers": {
"productrue": {
"url": "https://app.productrue.com/api/v1/mcp",
"headers": { "Authorization": "Bearer API_ANAHTARINIZ" }
}
}
}
Anahtarı oluşturduğunuz anda API anahtarları sayfası bu iki parçayı anahtarınız yerleştirilmiş hâlde gösterir.
Claude.ai ve ChatGPT bağlayıcıları da aynı tarayıcı girişini kullanır. Bunları productrue ile henüz denemedik. Bağlanmayan olursa bize yazın.
Bağlandıktan sonra ajanınız aşağıdaki araçları görür: yalnızca rolünüzün izin verdiklerini ve paketinizde olanları. Yalnızca okuma yetkili bir anahtar, veriyi değiştirmeyen araçları görür. ✎ işareti veriyi değiştiren araçları gösterir.
get_account | Şirketiniz, rolünüz, izinleriniz ve etkin modüller. İlk çağrı için uygun. |
check_approval | Onay bekleyen bir işlemin onaylanıp onaylanmadığı ve sonucu. |
search_products | Metin, durum ya da şemaya göre ürün arar. |
get_product | Bir ürünü bütün nitelik değerleriyle getirir. |
create_product | Bir şemada tek ürün oluşturur. ✎ |
update_product | Ürünün SKU'sunu, durumunu ya da niteliklerinden bazılarını değiştirir. ✎ |
import_products | Tek çağrıda 1.000'e kadar ürün oluşturur ya da günceller; CSV/XLSX bağlantısından da okur. Var olan ürünleri SKU'ya göre eşler. ✎ |
get_import | Bir içe aktarmanın durumu ve satır satır hatalar. |
delete_products | 100'e kadar ürünü siler. ✎ |
list_variants | Bir ürünün varyantları ve onları ayıran nitelikler. |
create_variant | Bir ürüne tek varyant ekler. ✎ |
generate_variants | Varyant niteliklerinin her birleşimi için bir varyant oluşturur. ✎ |
update_variants | Bir ürünün birden çok varyantını tek seferde değiştirir. ✎ |
delete_variant | Tek bir varyantı siler. ✎ |
upload_media | Bağlantılardan medya kütüphanesine görsel ya da PDF ekler. ✎ |
add_product_image | Bir bağlantıdaki görseli indirip ürüne ekler. ✎ |
search_media | Medya dosyalarını ad, etiket ya da klasöre göre bulur. |
organise_media | Birden çok medya dosyasını etiketler, etiketini kaldırır, taşır ya da siler. ✎ |
list_media_folders | Medya klasörleri ve her birindeki dosya sayısı. |
manage_media_folder | Medya klasörü oluşturur, adını değiştirir, taşır ya da siler. ✎ |
match_images | Dosya adı ve SKU eşleşmesine göre hangi görselin hangi ürüne ait olduğunu önerir. ✎ |
confirm_image_matches | Önerilen görselleri ürünlerine ekler. ✎ |
list_product_schemas | Ürün şemaları (ürün tipleri). |
get_product_schema | Bir şema ve nitelikleri: kod, tip, zorunluluk, seçenekler. |
create_product_schema | Grupları ve nitelikleriyle bir şemayı tek çağrıda oluşturur. ✎ |
update_product_schema | Şemanın adını, durumunu, görünen ad ya da taban fiyat niteliğini değiştirir. ✎ |
add_attribute | Bir şemaya tek nitelik ekler. ✎ |
update_attribute | Tek bir niteliği değiştirir: etiket, zorunluluk, rol, sınırlar ya da seçenekler. ✎ |
delete_attribute | Bir niteliği değerleriyle birlikte siler. ✎ |
delete_product_schema | Hiçbir ürünün kullanmadığı bir şemayı siler. ✎ |
add_attribute_options | Seçimli bir niteliğe yeni seçenek ekler, örneğin bir yazar ya da marka. ✎ |
list_reference_lists | Seçimli niteliklerin seçeneklerini aldığı ortak değer listeleri. |
list_reference_items | Bir referans listesindeki değerler. |
manage_reference_list | Referans listesi oluşturur, günceller ya da siler. ✎ |
manage_reference_item | Liste değerlerini oluşturur, yeniden adlandırır, kapatır, siler ya da sıralar. ✎ |
list_warehouses | Depolar ve lokasyonları. |
get_stock | Ürüne, depoya ya da lokasyona göre stok birimleri. |
receive_stock | Bir lokasyona mal kabulü kaydeder. ✎ |
adjust_stock | Bir stok birimini gerekçesiyle artırır ya da azaltır. ✎ |
transfer_stock | Stoğu başka bir lokasyona ya da depoya taşır. ✎ |
get_product_stock | Bir üründen depo ve lokasyon bazında ne kadar stok olduğu. |
list_stock_movements | Stok defteri: mal kabulleri, düzeltmeler, transferler, satışlar. |
get_inventory_summary | Stok değeri, adet ve düşük stok sayısına genel bakış. |
manage_warehouse | Depo oluşturur, günceller, varsayılan yapar ya da siler. ✎ |
manage_location | Lokasyon (oda, raf, göz) oluşturur, günceller ya da siler. ✎ |
get_location_label | Bir lokasyonun etiket metni ya da QR kodu (indirme bağlantısıyla). |
search_suppliers | Tedarikçi arar ya da bir tedarikçiyi son teslimatlarıyla getirir. |
manage_supplier | Tedarikçi oluşturur, günceller ya da siler. ✎ |
list_stock_alerts | Düşük stok alarmları ve şu an tetiklenmiş olanlar. |
set_stock_alert | Bir ürünün en az stok ve yeniden sipariş miktarını belirler. ✎ |
manage_stock_alert | Düşük stok alarmını görüldü olarak işaretler ya da siler. ✎ |
lookup_barcode | Okutulan barkodun ne olduğu: ürün, stok birimi ya da lokasyon. ✎ |
generate_barcode | Yeni bir barkod ya da bir lokasyon için barkod üretir. ✎ |
search_orders | Siparişleri metin, durum, bayi ya da tarihe göre arar. |
get_order | Bir siparişi satırlarıyla getirir. |
update_order_status | Siparişi akışında ilerletir. ✎ |
update_order | Siparişin notlarını değiştirir. ✎ |
get_order_fulfilment | Bir siparişin gönderileri ve iadeleri. |
create_shipment | Siparişin satırlarının bir kısmını ya da tamamını takip numarasıyla gönderir. ✎ |
create_return | Siparişten geri gelen ürünleri kaydeder. ✎ |
get_order_document | Siparişin PDF hâli (indirme bağlantısıyla). |
get_order_summary | Bir dönemin sipariş toplamları ve işlem bekleyen sipariş sayısı. |
list_catalogues | Kataloglarınız. |
add_products_to_catalogue | Bir kataloğa 100'e kadar ürün ekler. ✎ |
get_catalogue | Bir kataloğu ürünleri, ayarları ve bayileriyle getirir. |
manage_catalogue | Katalog ve ayarlarını oluşturur, günceller ya da siler. ✎ |
manage_catalogue_products | Katalogdan ürün çıkarır ya da sıralarını değiştirir. ✎ |
share_catalogue | Bayilerle paylaşır, bağlantıyı yeniler ya da parola koyar. ✎ |
search_dealers | Bayi arar ya da bir bayiyi katalogları ve kullanıcılarıyla getirir. |
manage_dealer | Bayi oluşturur, günceller ya da siler. ✎ |
manage_dealer_user | Bayi çalışanı için giriş oluşturur, günceller ya da siler. ✎ |
dealer_prices | Bir bayinin bir katalogdaki özel fiyatlarını okur ya da belirler. ✎ |
list_price_lists | Fiyat listeleri ya da bir liste ve fiyatları. |
manage_price_list | Fiyat listesi oluşturur, günceller, etkinleştirir, arşivler ya da siler. ✎ |
set_prices | 100'e kadar ürünün fiyatını tek tek belirler. ✎ |
bulk_update_prices | Birçok fiyatı bir kurala göre değiştirir, örneğin %5 artış ve .99 yuvarlama. ✎ |
export_prices | Bir fiyat listesinin CSV hâli (indirme bağlantısıyla). |
resolve_prices | İndirimlerden sonra bir bayinin ödeyeceği son fiyat. ✎ |
list_channels | Satış kanalları ya da bir kanal ve içindeki ürünler. |
manage_channel | Satış kanalı oluşturur, günceller ya da siler. ✎ |
manage_channel_products | Kanala ürün ekler ya da kanaldan çıkarır. ✎ |
get_channel_listing | Bir ürünün bir kanalda nasıl görüneceği. |
set_channel_override | Yalnız o kanala özel başlık, açıklama, fiyat, görsel ya da nitelik değeri. ✎ |
run_channel_export | Bir kanal için ürün dışa aktarımını başlatır ya da iptal eder. ✎ |
get_channel_exports | Dışa aktarım işleri, ilerlemeleri ve biten dosya. |
list_export_templates | Dışa aktarım şablonları ya da bir şablon ve sütunları. |
manage_export_template | Dışa aktarım şablonu oluşturur, günceller ya da siler. ✎ |
get_marketplace_mapping | Bir şemanın alanlarının pazaryeri alanlarıyla eşleşmesi. |
save_marketplace_mapping | Pazaryeri eşlemesini kaydeder, denetler, etkinleştirir ya da geri alır. ✎ |
list_integrations | Bağlı mağaza ve pazaryerleri, her birinin neler yapabildiği. |
manage_integration | İlan, sipariş ya da stok eşitler; ürünü denetler; bağlantıyı kaldırır. ✎ |
search_integration_logs | Bağlantıların yaptığı işler, hatalar ve sayılar. |
search_leads | CRM adaylarını arar ya da bir adayı geçmişiyle getirir. |
manage_lead | Aday oluşturur, günceller, aşama değiştirir, dönüştürür ya da siler. ✎ |
log_lead_activity | Adaya not, arama, e-posta, toplantı ya da görev kaydeder. ✎ |
list_pipelines | Satış hunileri, aşamaları ve aday panosu. |
manage_pipeline | Huni oluşturur, günceller, aşamalarını sıralar ya da siler. ✎ |
list_lead_forms | Aday toplama formları ve gelen başvurular. |
manage_lead_form | Aday toplama formu oluşturur, günceller ya da siler. ✎ |
search_invoices | Satış faturaları, tek bir fatura ya da bir dönemin toplamları. |
manage_invoice | Fatura ya da siparişten fatura oluşturur; keser, ödendi işaretler, iptal eder. ✎ |
search_expenses | Kayıtlı giderler, tek bir gider ya da toplamlar. |
manage_expense | Gider kaydeder, günceller ya da siler. ✎ |
get_accounting_report | Bir dönemin geliri, gideri ve kâr-zararı. |
get_dashboard | Ana ekrandaki özet rakamlar. |
get_audit_report | Kim neyi değiştirdi: raporlar, kayıt geçmişi, dışa aktarım. |
list_notifications | Bildirimleriniz ve okunmamış sayısı. |
mark_notifications_read | Bir ya da tüm bildirimleri okundu olarak işaretler. ✎ |
list_team | Hesaptaki kişiler, rolleri ve kimlikleri. |
Stok, yalnızca ekleme yapılan bir defterdir. Hiçbir araç miktarı doğrudan düzenlemez. Mal kabulü ve düzeltmeler hareket olarak kaydedilir, bakiye bunlardan hesaplanır. Web uygulamasında da aynısı geçerli.
Script'ler ve n8n gibi otomasyon araçları aynı anahtarı MCP olmadan kullanabilir. Her araç aşağıdaki uç noktalardan birinin üzerinde ince bir katmandır, kurallar birebir aynıdır.
curl "https://app.productrue.com/api/v1/products/products?search=meşe" \
-H "Authorization: Bearer API_ANAHTARINIZ" \
-H "Accept: application/json"
| Hesap | |
|---|---|
get_account | GET /auth/meGET /billing/modules/active |
check_approval | |
| Ürünler ve varyantlar | |
search_products | GET /products/products |
get_product | GET /products/products/{product} |
create_product | POST /products/products |
update_product | PATCH /products/products/{product} |
import_products | POST /products/imports/analyzePOST /products/imports |
get_import | GET /products/imports/{import} |
delete_products | POST /products/products/bulk-delete |
list_variants | GET /products/products/{product}/variantsGET /products/products/{product}/variant-attributes |
create_variant | POST /products/products/{product}/variants |
generate_variants | POST /products/products/{product}/variants/generate |
update_variants | PUT /products/products/{product}/variants/bulk |
delete_variant | DELETE /products/products/{product}/variants/{variant} |
| Görseller ve medya | |
upload_media | POST /media/assetsPOST /media/assets/bulk/movePOST /media/assets/bulk/tag |
add_product_image | GET /products/products/{product}GET /products/schemas/{schema}POST /media/assetsPATCH /products/products/{product} |
search_media | GET /media/assetsGET /media/tags/{tagName}/assetsGET /media/folders/{folder} |
organise_media | POST /media/assets/bulk/tagDELETE /media/assets/bulk/tagPOST /media/assets/bulk/moveDELETE /media/assets/bulk |
list_media_folders | GET /media/folders |
manage_media_folder | POST /media/foldersPUT /media/folders/{folder}/renamePUT /media/folders/{folder}/moveDELETE /media/folders/{folder} |
match_images | POST /media/match |
confirm_image_matches | POST /media/match/confirm |
| Şemalar ve referans listeleri | |
list_product_schemas | GET /products/schemas |
get_product_schema | GET /products/schemas/{schema} |
create_product_schema | POST /products/schemasPOST /products/schemas/{schema}/attribute-groupsPOST /products/schemas/{schema}/attribute-groups/{attributeGroup}/attributesPUT /products/schemas/{schema}/display-namePUT /products/schemas/{schema}/base-price |
update_product_schema | PATCH /products/schemas/{schema}PUT /products/schemas/{schema}/display-namePUT /products/schemas/{schema}/base-price |
add_attribute | GET /products/schemas/{schema}POST /products/schemas/{schema}/attribute-groupsPOST /products/schemas/{schema}/attribute-groups/{attributeGroup}/attributes |
update_attribute | GET /products/schemas/{schema}PATCH /products/schemas/{schema}/attribute-groups/{attributeGroup}/attributes/{attribute} |
delete_attribute | GET /products/schemas/{schema}DELETE /products/schemas/{schema}/attribute-groups/{attributeGroup}/attributes/{attribute} |
delete_product_schema | DELETE /products/schemas/{schema} |
add_attribute_options | PATCH /products/schemas/{schema}/attribute-groups/{attributeGroup}/attributes/{attribute}POST /refdata/lists/{referenceList}/items/import |
list_reference_lists | GET /refdata/lists |
list_reference_items | GET /refdata/lists/{referenceList}/items |
manage_reference_list | POST /refdata/listsPATCH /refdata/lists/{referenceList}DELETE /refdata/lists/{referenceList} |
manage_reference_item | POST /refdata/lists/{referenceList}/itemsPATCH /refdata/lists/{referenceList}/items/{referenceItem}DELETE /refdata/lists/{referenceList}/items/{referenceItem}POST /refdata/lists/{referenceList}/items/reorder |
| Stok | |
list_warehouses | GET /inventory/warehouses |
get_stock | GET /inventory/stock |
receive_stock | POST /inventory/stock/receive |
adjust_stock | POST /inventory/stock/{stockUnit}/adjust |
transfer_stock | POST /inventory/stock/{stockUnit}/transfer |
get_product_stock | GET /inventory/products/{productId}/stock |
list_stock_movements | GET /inventory/movements |
get_inventory_summary | GET /inventory/reports/summary |
manage_warehouse | POST /inventory/warehousesPUT /inventory/warehouses/{warehouse}POST /inventory/warehouses/{warehouse}/set-defaultDELETE /inventory/warehouses/{warehouse} |
manage_location | POST /inventory/warehouses/{warehouse}/locationsPUT /inventory/locations/{location}DELETE /inventory/locations/{location} |
get_location_label | GET /inventory/locations/{location}/labelGET /inventory/locations/{location}/qr-code |
search_suppliers | GET /inventory/suppliersGET /inventory/suppliers/{supplier}GET /inventory/suppliers/{supplier}/movements |
manage_supplier | POST /inventory/suppliersPUT /inventory/suppliers/{supplier}DELETE /inventory/suppliers/{supplier} |
list_stock_alerts | GET /inventory/alertsGET /inventory/alerts/summary |
set_stock_alert | POST /inventory/products/{productId}/alert |
manage_stock_alert | POST /inventory/alerts/{stockAlert}/acknowledgeDELETE /inventory/alerts/{stockAlert} |
lookup_barcode | POST /inventory/barcode/scan |
generate_barcode | POST /inventory/barcode/generatePOST /inventory/locations/{location}/generate-barcode |
| Siparişler | |
search_orders | GET /orders/orders |
get_order | GET /orders/orders/{order} |
update_order_status | PUT /orders/orders/{order}/status |
update_order | PUT /orders/orders/{order} |
get_order_fulfilment | GET /orders/orders/{orderId}/shipmentsGET /orders/orders/{orderId}/returns |
create_shipment | POST /orders/orders/{orderId}/shipments |
create_return | POST /orders/orders/{orderId}/returns |
get_order_document | GET /orders/orders/{orderId}/document |
get_order_summary | GET /orders/reports/summaryGET /orders/orders/pending-count |
| Kataloglar | |
list_catalogues | GET /catalogues/catalogues |
add_products_to_catalogue | POST /catalogues/catalogues/{catalogue}/products |
get_catalogue | GET /catalogues/catalogues/{catalogue}GET /catalogues/catalogues/{catalogue}/dealers |
manage_catalogue | POST /catalogues/cataloguesPATCH /catalogues/catalogues/{catalogue}PATCH /catalogues/catalogues/{catalogue}/settingsDELETE /catalogues/catalogues/{catalogue} |
manage_catalogue_products | DELETE /catalogues/catalogues/{catalogue}/products/{productId}PUT /catalogues/catalogues/{catalogue}/products/reorder |
share_catalogue | POST /catalogues/catalogues/{catalogue}/dealersDELETE /catalogues/catalogues/{catalogue}/dealers/{dealerId}POST /catalogues/catalogues/{catalogue}/share/rotate-tokenPUT /catalogues/catalogues/{catalogue}/share/password |
| Bayiler | |
search_dealers | GET /dealers/dealersGET /dealers/dealers/{dealer}GET /dealers/dealers/{dealer}/users |
manage_dealer | POST /dealers/dealersPATCH /dealers/dealers/{dealer}DELETE /dealers/dealers/{dealer} |
manage_dealer_user | POST /dealers/dealers/{dealer}/usersPATCH /dealers/dealers/{dealer}/users/{dealerUser}DELETE /dealers/dealers/{dealer}/users/{dealerUser} |
dealer_prices | GET /dealers/dealers/{dealer}/catalogues/{catalogue}/pricesPUT /dealers/dealers/{dealer}/catalogues/{catalogue}/prices |
| Fiyatlar | |
list_price_lists | GET /pricing/price-listsGET /pricing/price-lists/{priceList}GET /pricing/price-lists/{priceList}/prices |
manage_price_list | POST /pricing/price-listsPUT /pricing/price-lists/{priceList}POST /pricing/price-lists/{priceList}/activatePOST /pricing/price-lists/{priceList}/archiveDELETE /pricing/price-lists/{priceList} |
set_prices | PUT /pricing/price-lists/{priceList}/prices/{productId}DELETE /pricing/price-lists/{priceList}/prices/{productId} |
bulk_update_prices | POST /pricing/price-lists/{priceList}/prices/bulk |
export_prices | GET /pricing/price-lists/{priceList}/prices/export.csv |
resolve_prices | POST /pricing/resolve-many |
| Kanallar ve pazaryerleri | |
list_channels | GET /channels/channelsGET /channels/channels/{channelId}GET /channels/channels/{channelId}/productsGET /channels/products/{productId}/channels |
manage_channel | POST /channels/channelsPATCH /channels/channels/{channelId}DELETE /channels/channels/{channelId} |
manage_channel_products | POST /channels/channels/{channelId}/productsDELETE /channels/channels/{channelId}/products/{productId} |
get_channel_listing | GET /channels/products/{productId}/channels/{channelId}/contextGET /channels/channels/{channelId}/products/{productId}/override |
set_channel_override | PUT /channels/channels/{channelId}/products/{productId}/overridePUT /channels/products/{productId}/channels/{channelId}/overridesPOST /channels/products/{productId}/channels/{channelId}/recompute |
run_channel_export | POST /channels/channels/{channelId}/exportsPOST /channels/channels/{channelId}/exports/{jobId}/cancel |
get_channel_exports | GET /channels/channels/{channelId}/exportsGET /channels/channels/{channelId}/exports/{jobId}GET /channels/channels/{channelId}/exports/{jobId}/download |
list_export_templates | GET /channels/export-templatesGET /channels/export-templates/{templateId} |
manage_export_template | POST /channels/export-templatesPUT /channels/export-templates/{templateId}DELETE /channels/export-templates/{templateId} |
get_marketplace_mapping | GET /channels/marketplacesGET /channels/schemas/{schemaId}/marketplace-mappingsGET /channels/schemas/{schemaId}/marketplace-mappings/{marketplace}GET /channels/schemas/{schemaId}/marketplace-mappings/{marketplace}/historyGET /channels/schemas/{schemaId}/semantic-roles |
save_marketplace_mapping | POST /channels/schemas/{schemaId}/marketplace-mappingsPOST /channels/schemas/{schemaId}/marketplace-mappings/validatePOST /channels/schemas/{schemaId}/marketplace-mappings/{schemaMapping}/activatePOST /channels/schemas/{schemaId}/marketplace-mappings/{marketplace}/rollbackPOST /channels/marketplaces/{marketplace}/refresh-attributes |
list_integrations | GET /integrations/availableGET /integrations/connectionsGET /integrations/connections/{integrationConnection}GET /integrations/connections/{integrationConnection}/capabilitiesGET /integrations/connections/{integrationConnection}/mappingsGET /integrations/connections/{integrationConnection}/field-mappings |
manage_integration | POST /integrations/connections/{integrationConnection}/health-checkPOST /integrations/connections/{integrationConnection}/sync/listingsPOST /integrations/connections/{integrationConnection}/sync/ordersPOST /integrations/connections/{integrationConnection}/sync/inventoryPUT /integrations/connections/{integrationConnection}/field-overridesPOST /integrations/connections/{integrationConnection}/previewPOST /integrations/connections/{integrationConnection}/validate-productDELETE /integrations/connections/{integrationConnection} |
search_integration_logs | GET /integrations/logsGET /integrations/logs/{id}GET /integrations/logs/stats |
| CRM | |
search_leads | GET /crm/leadsGET /crm/leads/{lead}GET /crm/leads/{lead}/activities |
manage_lead | POST /crm/leadsPATCH /crm/leads/{lead}POST /crm/leads/{lead}/move-stagePOST /crm/leads/{lead}/convertDELETE /crm/leads/{lead} |
log_lead_activity | POST /crm/leads/{lead}/activitiesDELETE /crm/leads/{lead}/activities/{activity} |
list_pipelines | GET /crm/pipelinesGET /crm/pipelines/{pipeline}GET /crm/pipelines/{pipeline}/kanban |
manage_pipeline | POST /crm/pipelinesPATCH /crm/pipelines/{pipeline}POST /crm/pipelines/{pipeline}/stages/reorderDELETE /crm/pipelines/{pipeline} |
list_lead_forms | GET /crm/formsGET /crm/forms/{crmForm}GET /crm/forms/{crmForm}/submissions |
manage_lead_form | POST /crm/formsPATCH /crm/forms/{crmForm}DELETE /crm/forms/{crmForm} |
| Muhasebe | |
search_invoices | GET /accounting/invoicesGET /accounting/invoices/{invoice}GET /accounting/invoices/by-order/{orderId}GET /accounting/invoices/stats |
manage_invoice | POST /accounting/invoicesPOST /accounting/invoices/from-orderPOST /accounting/invoices/{invoice}/issuePOST /accounting/invoices/{invoice}/mark-paidPOST /accounting/invoices/{invoice}/void |
search_expenses | GET /accounting/expensesGET /accounting/expenses/{expense}GET /accounting/expenses/stats |
manage_expense | POST /accounting/expensesPUT /accounting/expenses/{expense}DELETE /accounting/expenses/{expense} |
get_accounting_report | GET /accounting/dashboardGET /accounting/reports/revenueGET /accounting/reports/expensesGET /accounting/reports/profit-loss |
| Raporlar ve hareketler | |
get_dashboard | GET /dashboard/stats |
get_audit_report | GET /audit/reports/overviewGET /audit/reports/top-actionsGET /audit/reports/failed-actionsGET /audit/reports/timelineGET /audit/reports/by-eventGET /audit/reports/by-subjectGET /audit/reports/active-usersGET /audit/statsGET /audit/subject/{subjectType}/{subjectId}GET /audit/{id}GET /audit/export/json |
list_notifications | GET /platform/notificationsGET /platform/notifications/unread-count |
mark_notifications_read | POST /platform/notifications/{id}/readPOST /platform/notifications/mark-all-read |
list_team | GET /settings/team |
Yollar https://app.productrue.com/api/v1 adresine görelidir. İstekleri her zaman bu adrese gönderin. Diğer productrue adresleri anahtarları reddeder.
Bütün yanıtlar aynı zarfı kullanır. Başarılı yanıt {"ok": true, "data": ...} biçimindedir. Listelerde sayfalama bilgisi meta alanında gelir, sayfayı ?page= seçer. Hatalı yanıt {"ok": false, "error": {"code": "...", "message": "...", "details": {...}}} biçimindedir.
Desteklenen ve belgelenen API bu işlemlerden oluşur. Web uygulaması başka uç noktaları da çağırır ve anahtarınız onlara da ulaşır. Ancak o uç noktalar bizim ekranlarımız için yapıldı ve haber verilmeden değişebilir.
Ajanlar, zaman aşımına uğrayan bir çağrıyı tekrarlar. "50 adet mal kabulü" tekrarlandığında stoğa 100 adet girmemeli. Veri değiştiren her istekte bir Idempotency-Key başlığı gönderin: yapmak istediğiniz her değişiklik için yeni bir değer (UUID olabilir), aynı değişikliği tekrarlarken aynı değer.
curl -X POST "https://app.productrue.com/api/v1/inventory/stock/receive" \
-H "Authorization: Bearer API_ANAHTARINIZ" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: 6f1c2a9e-3b7d-4e0a-9c51-2d8f0b4a7e13" \
-d '{"product_id": "...", "location_id": "...", "quantity": 50}'
| Gönderdiğiniz | Aldığınız |
|---|---|
| Bir anahtarı ilk kez | İstek normal şekilde çalışır. |
| Aynı anahtarı aynı istekle yeniden | İlk yanıtın kendisi, Idempotent-Replayed: true başlığıyla. Hiçbir işlem iki kez yapılmaz. |
| Aynı anahtarı farklı bir istekle | 422 PLATFORM_IDEMPOTENCY_KEY_REUSED |
| Aynı anahtarı, ilk istek hâlâ sürerken | 409 PLATFORM_IDEMPOTENCY_IN_PROGRESS. Biraz bekleyip tekrar deneyin. |
Anahtarlar 24 saat hatırlanır. Yalnızca kesin sonuçlar saklanır: başarılı yanıtlar ve her seferinde aynı dönecek hatalar (400, 404, 422). Sunucu hatası ya da hız sınırı saklanmaz. Aynı anahtarla tekrar denerseniz istek yeniden çalışır. MCP üzerinden veri değiştiren her araç bir idempotency_key parametresi alır ve onu bu başlıkla iletir.
Aşağıdaki kodlar API anahtarları ve bağlı uygulamalar için aynıdır. Her hata değişmeyen bir code taşır. Ajanlar mesaja göre değil, koda göre davranmalı.
| HTTP | Kod | Anlamı |
|---|---|---|
| 401 | UNAUTHENTICATED | Anahtar eksik, yanlış, süresi dolmuş ya da iptal edilmiş. |
| 403 | PERMISSION_DENIED | Rolünüz bu işleme izin vermiyor. Rolünüzü şirket sahibi ya da yönetici değiştirebilir. |
| 403 | PLATFORM_API_KEY_READ_ONLY | Anahtar yalnızca okuma yetkili, istek ise veri değiştirecekti. |
| 403 | PLATFORM_API_KEY_MEMBERSHIP_REVOKED | Anahtarı oluşturan kişi artık şirketin üyesi değil. |
| 403 | PLATFORM_API_KEY_NOT_ALLOWED | Bu işlem yalnızca oturum açılmış bir tarayıcıdan yapılabilir. API anahtarlarını yönetmek ve oturumları kapatmak bunlardan. |
| 403 | PLATFORM_API_KEY_TENANT_PINNED | Anahtar tek bir şirkete bağlıdır, başka şirkete geçemez. |
| 403 | PLATFORM_AGENT_NOT_AUTHORISED | Bağlı uygulamanın onayı artık yok. Uygulamayı yeniden bağlayın. |
| 404 | NOT_FOUND | Bu şirkette böyle bir kayıt yok. |
| 422 | VALIDATION_FAILED | details alanı hatalı her alanı mesajlarıyla listeler. Düzeltip yeniden gönderin. |
| 429 | RATE_LIMITED | Çok fazla istek. Retry-After başlığındaki saniye kadar bekleyin. |
MCP üzerinden başarısız olan bir araç çağrısı aynı kodu, HTTP durumunu, mesajı ve hatalı alanları ajanın okuyabileceği metin olarak döndürür.
Anahtara parola gibi davranın. Kod depolarına ve paylaşılan belgelere koymayın, yetecekse yalnızca okumayı seçin, bir süre belirleyin.
Her anahtar ve her bağlı uygulama dakikada 120 istek yapabilir. Sınır anahtar ya da bağlantı başınadır, bu yüzden ajanınız tarayıcıdaki işinizi yavaşlatmaz. MCP üzerinden bir araç çağrısı, MCP isteği için bir kez ve aracın yaptığı her API çağrısı için birer kez sayılır. Çoğu araç tek çağrı yapar, get_account iki çağrı yapar.
Bunlardan birine ya da listede olmayan bir araca ihtiyacınız varsa bize yazın.
KOBİ'ler için modüler ürün ve kanal yönetimi.
128 City Road, London, EC1V 2NX