Προγραμματιστές

API προμηθευτών

Ένα endpoint. Καταχωρίστε έναν πίνακα τιμών, λάβετε πίσω τι δημοσιεύτηκε και τι κρατήθηκε. Δεν υπάρχει SDK προς εγκατάσταση ούτε ενσωμάτωση για την οποία να χρειάζεται να προγραμματίσετε κλήση — αν το σύστημά σας έχει ήδη τους σημερινούς αριθμούς, αυτό είναι ένα HTTP request.

Αποκτήστε ένα κλειδί

Ανοίξτε την πύλη προμηθευτών με τη διεύθυνση από την οποία δίνει προσφορές το γραφείο σας. Ο σύνδεσμος που φτάνει σας συνδέει, και το κλειδί σας βρίσκεται σε εκείνη τη σελίδα. Τα κλειδιά ξεκινούν με 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 μετατρέπεται με τη ζωντανή τιμή αναφοράς της ΕΚΤ της ημέρας.
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 τιμές ανά request. Καταχωρίστε όσο συχνά θέλετε — τα περισσότερα γραφεία καταχωρούν μία φορά το πρωί και ξανά αν η αγορά κινηθεί. Η εκ νέου καταχώριση του ίδιου λιμανιού και τύπου αντικαθιστά την προηγούμενη τιμή αντί να τη διπλασιάζει.

Τι κάνουμε με αυτήν

Η τιμή σας εμφανίζεται στη σελίδα του λιμανιού ως ενδεικτική, με αναφορά στην εταιρεία σας, με την ημερομηνία. Οι αγοραστές που κοιτάζουν εκείνο το λιμάνι βλέπουν το όνομά σας δίπλα σε έναν αριθμό αντί για κενό, και τα αιτήματα για προσφορά φτάνουν σε εσάς αντί να σας προσπερνούν.

Δεν είμαστε προμηθευτής καυσίμων, έμπορος ή μεσίτης και δεν κρατάμε καμία εμπορική θέση σε κανένα φορτίο, επομένως δεν έχουμε κανένα ενδιαφέρον για την τιμή σας πέρα από το να είμαστε σωστοί ως προς αυτήν. Πλήρεις λεπτομέρειες στην Πολιτική Δεδομένων & Τιμολόγησης. Αποσύρετε ανά πάσα στιγμή από την πύλη, ή γράψτε στο data@bunkerfuelprices.com.