공급업체 API

키 발급받기

열어주세요 공급업체 포털을 귀사 데스크가 견적을 내는 주소로. 도착하는 링크가 로그인을 처리하며, 귀사의 키는 그 페이지에 있습니다. 키는 다음으로 시작합니다 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" }
    ]
  }'

필드

응답

{
  "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"

귀사의 최근 100건의 제출 내역을 상태와 함께 반환하므로, 저희가 무엇을 수락했는지 귀사가 자체 로그를 유지하지 않고도 대조할 수 있습니다.

공개 가격 보드

공개되어 있고 키가 필요 없으며, 게시하기 전에 귀사의 가격이 나머지 시장 대비 어디에 위치하는지 확인하는 데 유용합니다.

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

오류 및 제한

요청당 최대 200개의 가격. 원하는 만큼 자주 게시하세요 — 대부분의 데스크는 아침에 한 번 게시하고 시장이 움직이면 다시 게시합니다. 동일한 항구와 등급을 다시 게시하면 중복되지 않고 이전 가격을 대체합니다.