API постачальника
Один endpoint. Надішліть масив цін, отримайте назад, що опубліковано, а що затримано. Немає SDK для встановлення й немає інтеграції, заради якої треба планувати дзвінок — якщо ваша система вже має сьогоднішні цифри, це один HTTP-запит.
Отримайте ключ
Відкрийте портал постачальника з адресою, з якої ваш деск дає котирування. Посилання, що надійде, виконує ваш вхід, а ваш ключ — на тій сторінці. Ключі починаються з bfps_ і ніколи не спливають; ви можете ротувати ключ з тієї ж сторінки.
Ставтеся до нього як до пароля. Будь-хто, хто його має, може публікувати ціни від вашого імені, а хибна ціна, приписана вам, гірша для вас, ніж для нас.
Публікація цін
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" }
]
}'Поля
| Поле | Тип | Примітки | |
|---|---|---|---|
| port | string | required | UN/LOCODE, п’ять літер — SGSIN, NLRTM, AEFJR. Не назва порту. Невідомий код відхиляється лише для того рядка; решта все одно публікується. |
| grade | enum | required | VLSFO · HSFO · MGO · ULSFO · LNG · B24 · B30 |
| amount | number | required | Ціна, у валюті та одиниці, зазначених нижче. |
| currency | USD | EUR | optional | За замовчуванням USD. EUR конвертується за поточним референсним курсом ECB на день. |
| unit | mt | litre | m3 | optional | За замовчуванням mt. Показники за літр конвертуються з використанням густини ґрейду. |
| basis | delivered | ex_wharf | fob | optional | За замовчуванням delivered. Це має значення: ціна ex-wharf, показана як delivered, занижує те, що платить покупець, а ми порівнюємо лише в межах одного базису. |
| minMt | number | optional | Мінімальна партія, до якої застосовується ціна. |
| validHours | 1–168 | optional | Як довго вона діє. За замовчуванням 24, після чого вона позначається як застаріла, а не показується як актуальна. |
| taxIncluded | boolean | optional | За замовчуванням false. Актуально переважно для яхтових причалів. |
Відповідь
{
"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"] }
]
}Рядок, що далеко відхиляється від ринку в інших портах, затримується для людини, а не публікується. Це не сумнів щодо вас — це те, що не дає одній хибно набраній цифрі стати числом, за яким діятиме покупець, і воно захищає ваше ім’я більше, ніж наше. Затримані ціни зазвичай вивільняються того ж дня.
Рядки незалежні. Поганий рядок не відхиляє весь пакет.
Зчитайте те, що ми зберігаємо
curl https://bunkerfuelprices.com/api/v1/supplier/prices \ -H "Authorization: Bearer bfps_YOUR_KEY"
Повертає ваші останні сто подань з їхнім статусом, щоб ви могли звіряти без ведення власного журналу того, що ми прийняли.
Публічна цінова дошка
Відкрита, ключ не потрібен, корисна для перевірки, де стоїть ваша ціна відносно решти ринку, перш ніж ви її опублікуєте.
curl "https://bunkerfuelprices.com/api/v1/prices?grade=VLSFO&limit=50"
Помилки та обмеження
| Статус | Значення |
|---|---|
| 200 | Оброблено. Перевірте results — 200 не означає, що кожен рядок опубліковано. |
| 400 | Тіло запиту не розпарсилося. Відповідь називає поле. |
| 401 | Відсутній, хибний або призупинений ключ. |
До 200 цін на запит. Публікуйте так часто, як хочете — більшість десків публікують раз уранці та ще раз, якщо ринок рухається. Повторна публікація того самого порту та ґрейду заміщує попередню ціну, а не дублює її.
Що ми з нею робимо
Ваша ціна з’являється на сторінці порту як індикативна, з посиланням на вашу компанію, із датою. Покупці, які дивляться на той порт, бачать ваше ім’я поруч із числом замість порожнього місця, і запити на котирування надходять до вас, а не повз вас.
Ми не постачальник палива, не трейдер і не брокер і не займаємо жодної торгової позиції за будь-яким вантажем, тож ми не маємо інтересу у вашій ціні, окрім того, щоб бути щодо неї правими. Повні деталі в Політиці щодо даних і ціноутворення. Відкликайте будь-коли з порталу або напишіть на data@bunkerfuelprices.com.