Tedarikçi API'si

Bir anahtar alın

Masanızın teklif verdiği adresle tedarikçi portalını açın. Gelen bağlantı oturumunuzu açar ve anahtarınız o sayfadadır. Anahtarlar bfps_ ile başlar ve asla sona ermez; aynı sayfadan birini döndürebilirsiniz.

Ona bir parola gibi davranın. Onu elinde tutan herkes sizin adınıza fiyat gönderebilir ve size atfedilen yanlış bir fiyat, sizin için bizden daha kötüdür.

Fiyat gönderin

POST https://bunkerfuelprices.com/api/v1/supplier/prices

curl -X POST https://bunkerfuelprices.com/api/v1/supplier/prices \
  -H "Authorization: Bearer bfps_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prices": [
      { "port": "SGSIN", "grade": "VLSFO", "amount": 784.50 },
      { "port": "SGSIN", "grade": "MGO",   "amount": 1146.00 },
      { "port": "AEFJR", "grade": "VLSFO", "amount": 795.00,
        "minMt": 200, "validHours": 24, "basis": "delivered" }
    ]
  }'

Alanlar

Yanıt

{
  "accepted": 3,
  "published": 2,
  "held": 1,
  "results": [
    { "port": "SGSIN", "grade": "VLSFO", "ok": true, "published": true,
      "submissionId": "..." },
    { "port": "SGSIN", "grade": "MGO",   "ok": true, "published": true,
      "submissionId": "..." },
    { "port": "AEFJR", "grade": "VLSFO", "ok": true, "published": false,
      "heldForReview": ["38% away from the $795 median across 6 other ports"] }
  ]
}

Diğer limanlardaki piyasadan uzak bir satır, yayınlanmak yerine bir kişi için beklemeye alınır. Bu, size dair bir şüphe değildir — yanlış yazılmış tek bir rakamın, bir alıcının üzerine işlem yapacağı bir rakam hâline gelmesini engelleyen şeydir ve bizim adımızdan çok sizin adınızı korur. Beklemeye alınan fiyatlar normalde aynı gün serbest bırakılır.

Satırlar bağımsızdır. Hatalı bir satır, toplu isteği reddetmez.

Elimizde tuttuklarımızı geri okuyun

curl https://bunkerfuelprices.com/api/v1/supplier/prices \
  -H "Authorization: Bearer bfps_YOUR_KEY"

Son yüz gönderiminizi durumlarıyla birlikte döndürür, böylece neyi kabul ettiğimize dair kendi kaydınızı tutmadan mutabakat sağlayabilirsiniz.

Genel fiyat tablosu

Açık, anahtar gerekmez ve fiyatınızı göndermeden önce piyasanın geri kalanına göre nerede durduğunu kontrol etmek için kullanışlıdır.

curl "https://bunkerfuelprices.com/api/v1/prices?grade=VLSFO&limit=50"

Hatalar ve sınırlar

İstek başına en fazla 200 fiyat. İstediğiniz sıklıkta gönderin — çoğu masa sabah bir kez, piyasa hareket ederse tekrar gönderir. Aynı liman ve grade'i yeniden göndermek, önceki fiyatı çoğaltmak yerine onun yerine geçer.