Μπορείτε να χρησιμοποιήσετε την ανάγνωσή σας στο FeedBro σε άλλες εφαρμογές και εργαλεία με δύο τρόπους. Οι σύνδεσμοι RSS μετατρέπουν τα Αποθηκευμένα άρθρα σας, ή μια συλλογή, σε ροή που μπορεί να διαβάσει οποιαδήποτε εφαρμογή RSS ή εργαλείο αυτοματισμού, χωρίς καμία ρύθμιση. Το API για προγραμματιστές επιτρέπει στα δικά σας σενάρια και εφαρμογές να διαβάζουν τις ροές και τα άρθρα σας και, με το Coffee Club, να τα σημειώνουν επίσης ως αναγνωσμένα ή αποθηκευμένα.
Η ανάγνωσή σας ως σύνδεσμοι RSS
Μια ροή RSS είναι μια λίστα με τα νεότερα άρθρα που οι εφαρμογές μπορούν να ελέγχουν για ενημερώσεις. Το FeedBro σας δίνει ιδιωτικούς συνδέσμους RSS για τις δικές σας λίστες:
- Αποθηκευμένα: τα άρθρα που αποθηκεύσατε στο FeedBro. Κάθε πρόγραμμα έχει αυτόν τον σύνδεσμο.
- Ένας σύνδεσμος για κάθε συλλογή, με τα νεότερα άρθρα από όλες τις ροές της συλλογής. Αυτό περιλαμβάνεται στο Coffee Club.
Μπορείτε να τους χρησιμοποιήσετε για να στείλετε τα αποθηκευμένα άρθρα σας σε άλλη εφαρμογή ανάγνωσης, σε υπηρεσία «διάβασμα αργότερα», σε συνομιλία ομάδας ή σε εργαλείο αυτοματισμού που καταλαβαίνει RSS.
Πώς αντιγράφετε τους συνδέσμους RSS
- Συνδεθείτε στο feedbro.com και ανοίξτε τις Ρυθμίσεις (από το μενού κάτω από τη φωτογραφία του προφίλ σας).
- Κάντε κλικ στην καρτέλα Ροές.
- Βρείτε την κάρτα Η ανάγνωσή σας ως RSS.
- Δίπλα στα Αποθηκευμένα (και, στο Coffee Club, δίπλα στο όνομα κάθε συλλογής), κάντε κλικ στην Αντιγραφή. Το κουμπί αλλάζει για λίγο σε Αντιγράφηκε. Μπορείτε επίσης να κάνετε κλικ μέσα στο πλαίσιο για να επιλέξετε τον σύνδεσμο.
- Επικολλήστε τον σύνδεσμο στην άλλη εφαρμογή σας, εκεί που ζητά διεύθυνση ροής.
Στο δωρεάν πρόγραμμα, οι συλλογές σας εμφανίζονται με ένα λουκέτο και τη σημείωση «Οι σύνδεσμοι συλλογών περιλαμβάνονται στο Coffee Club.» Στο Coffee Club, αν δεν έχετε ακόμη συλλογές, η κάρτα γράφει «Δημιουργήστε μια συλλογή για να έχετε και γι’ αυτήν έναν σύνδεσμο RSS.»
Τι περιέχει κάθε στοιχείο
- Ο τίτλος του άρθρου και ένας σύνδεσμος προς το πρωτότυπο άρθρο στον ιστότοπο του εκδότη.
- Η σύντομη περίληψη που δημοσίευσε η ίδια η ροή (έως περίπου 600 χαρακτήρες), όταν υπάρχει.
- Η ημερομηνία δημοσίευσης.
Το πλήρες κείμενο του άρθρου που έφερε το FeedBro δεν περιλαμβάνεται. Η άλλη εφαρμογή σας ανοίγει την πρωτότυπη σελίδα όταν κάνετε κλικ σε ένα στοιχείο.
Όρια σε κάθε πρόγραμμα
Στο δωρεάν πρόγραμμα παίρνετε μόνο τον σύνδεσμο Αποθηκευμένα, με τα 20 πιο πρόσφατα αποθηκευμένα άρθρα σας. Ανανεώνεται το πολύ κάθε 15 λεπτά.
Στο Coffee Club παίρνετε τον σύνδεσμο Αποθηκευμένα και έναν σύνδεσμο για κάθε συλλογή, με 50 άρθρα ο καθένας. Ανανεώνονται το πολύ κάθε 5 λεπτά.
Αν φύγετε από το Coffee Club, οι σύνδεσμοι των συλλογών σας εξακολουθούν να ανοίγουν, αλλά μια εφαρμογή RSS δείχνει μόνο ένα στοιχείο που γράφει «Οι σύνδεσμοι συλλογών περιλαμβάνονται στο Coffee Club.»
Κρατήστε τους συνδέσμους ιδιωτικούς
Οι σύνδεσμοι περιέχουν έναν μυστικό κωδικό και λειτουργούν χωρίς σύνδεση, ώστε να τους διαβάζουν άλλες εφαρμογές. Αυτό σημαίνει επίσης ότι όποιος έχει έναν σύνδεσμο μπορεί να διαβάσει αυτή τη λίστα, γι’ αυτό κρατήστε τους για εσάς.
Αν ένας σύνδεσμος μοιράστηκε κατά λάθος:
- Ανοίξτε τις Ρυθμίσεις και μετά την καρτέλα Ροές.
- Στην Η ανάγνωσή σας ως RSS, κάντε κλικ στην Επαναφορά συνδέσμων.
- Βλέπετε «Οι παλιοί σας σύνδεσμοι RSS δεν λειτουργούν πια. Οι νέοι βρίσκονται παρακάτω.» Αντιγράψτε τους νέους συνδέσμους στις εφαρμογές που θέλετε να συνεχίσετε να χρησιμοποιείτε.
Η επαναφορά απενεργοποιεί όλους τους παλιούς συνδέσμους ταυτόχρονα: τον σύνδεσμο Αποθηκευμένα και όλους τους συνδέσμους των συλλογών.
Το API για προγραμματιστές
Ένα API είναι ένας τρόπος για να μιλούν τα προγράμματα απευθείας με το FeedBro. Με ένα προσωπικό κλειδί API (έναν μακρύ μυστικό κωδικό που λειτουργεί σαν κωδικός πρόσβασης για ένα πρόγραμμα), ένα σενάριο ή μια εφαρμογή μπορεί να διαβάσει τις ροές, τις συλλογές, τα άρθρα και τις αποθηκευμένες σελίδες σας ως JSON (μια απλή μορφή κειμένου που διαβάζουν τα προγράμματα). Χρησιμοποιεί τον δικό σας λογαριασμό, οπότε ό,τι αλλάζει εμφανίζεται στο FeedBro και αντίστροφα.
Όρια σε κάθε πρόγραμμα
Στο δωρεάν πρόγραμμα παίρνετε 1 κλειδί και 500 αιτήματα τον μήνα, έως 30 αιτήματα το λεπτό ανά κλειδί, μόνο για ανάγνωση.
Στο Coffee Club παίρνετε έως 5 κλειδιά και 100 αιτήματα την ημέρα, έως 60 αιτήματα το λεπτό ανά κλειδί. Τα κλειδιά μπορούν επίσης να σημειώνουν άρθρα ως αναγνωσμένα, αποθηκευμένα ή για αργότερα. Μπορούν να ξεκινούν εργασίες παρασκηνίου (όπως η ανάκτηση του πλήρους κειμένου ενός άρθρου ή η εξαγωγή του κύριου κειμένου από οποιαδήποτε ιστοσελίδα) και να στέλνουν αποτελέσματα σε ένα webhook (μια διεύθυνση στον δικό σας διακομιστή που καλεί το FeedBro όταν κάτι είναι έτοιμο).
Ο μηνιαίος μετρητής στο δωρεάν πρόγραμμα ξεκινά ξανά την 1η κάθε μήνα και ο ημερήσιος μετρητής στο Coffee Club τα μεσάνυχτα UTC. Τα περισσότερα αιτήματα μετράνε για 1. Οι εργασίες παρασκηνίου μετράνε για περισσότερα, επειδή κάνουν περισσότερη δουλειά: η ανάκτηση ενός άρθρου ή η εξαγωγή μιας σελίδας μετράει για 10, η παρακολούθηση μιας ροής για 5, η έναρξη μιας παρακολούθησης ιστοτόπου για 25. Αν μια εργασία αποτύχει, μετράει για 1 και τα υπόλοιπα επιστρέφονται.
Πώς δημιουργείτε ένα κλειδί API
- Ανοίξτε τις Ρυθμίσεις και κάντε κλικ στην καρτέλα API.
- Στην κάρτα Πρόσβαση API, πληκτρολογήστε ένα όνομα για το κλειδί στο πλαίσιο (για παράδειγμα «Το σενάριό μου»), ώστε να ξεχωρίζετε τα κλειδιά σας αργότερα.
- Κάντε κλικ στο Δημιουργία κλειδιού.
- Το κλειδί εμφανίζεται με το μήνυμα «Αντιγράψτε αυτό το κλειδί τώρα. Εμφανίζεται μόνο μία φορά.» Κάντε κλικ στην Αντιγραφή και φυλάξτε το κλειδί κάπου ασφαλές, όπως σε έναν διαχειριστή κωδικών.
Τα κλειδιά σας εμφανίζονται στην ίδια κάρτα με το όνομά τους και πότε χρησιμοποιήθηκαν τελευταία φορά («Δεν έχει χρησιμοποιηθεί ακόμη» μέχρι το πρώτο αίτημα). Για να σταματήσετε να λειτουργεί ένα κλειδί, κάντε κλικ στην Ανάκληση δίπλα του και επιβεβαιώστε. Αν χάσετε ένα κλειδί, ανακαλέστε το και φτιάξτε νέο.
Πώς βλέπετε πόσο έχετε χρησιμοποιήσει
Η κάρτα Χρήση στο πάνω μέρος της καρτέλας API δείχνει, για παράδειγμα, «12 από 500 αιτήματα αυτόν τον μήνα», πόσα απομένουν, την ημερομηνία που μηδενίζεται το άθροισμα και πόσα αιτήματα το λεπτό μπορεί να στέλνει κάθε κλειδί. Το γράφημα Τελευταίες 30 ημέρες δείχνει τα αιτήματά σας ανά ημέρα. Κάτω από τα κλειδιά, οι Πρόσφατες εργασίες παρασκηνίου απαριθμούν τις εργασίες που ξεκίνησαν τα κλειδιά σας, με την κατάστασή τους (Σε αναμονή, Σε εκτέλεση, Ολοκληρώθηκε ή Απέτυχε), πόσο διήρκεσαν και για πόσα μετρήθηκαν.
Η τεκμηρίωση του API και το playground
Η πλήρης τεκμηρίωση βρίσκεται στη σελίδα API του FeedBro. Φτάνετε σε αυτήν από τον σύνδεσμο τεκμηρίωση του API στις Ρυθμίσεις ή από το API για προγραμματιστές στο κάτω μέρος κάθε σελίδας. Καλύπτει κάθε αίτημα, με παραδείγματα απαντήσεων και κάθε μήνυμα σφάλματος.
Η σελίδα έχει ένα playground που λέγεται Δοκιμάστε το, όπου μπορείτε να δοκιμάσετε αιτήματα χωρίς να γράψετε κώδικα:
- Επικολλήστε το κλειδί σας στο πλαίσιο Κλειδί API. Κρύβεται καθώς πληκτρολογείτε· το κουμπί με το μάτι το δείχνει.
- Διαλέξτε ένα αίτημα από τη λίστα Κλήση, για παράδειγμα GET /summary/unread-count. Η γραμμή από κάτω λέει τι κάνει, αν χρειάζεται Coffee Club και για πόσα μετράει.
- Συμπληρώστε τα πεδία που εμφανίζονται. Τα πεδία με * είναι υποχρεωτικά.
- Κάντε κλικ στην Αποστολή. Η απάντηση εμφανίζεται από κάτω, με την κατάστασή της και πόσα αιτήματα σας απομένουν.
- Κάντε κλικ στην Αντιγραφή ως curl για να αντιγράψετε το ίδιο αίτημα ως εντολή που μπορείτε να εκτελέσετε σε ένα τερματικό.
Τα αιτήματα στο playground είναι πραγματικά: χρησιμοποιούν τον λογαριασμό σας και μετράνε στο πρόγραμμά σας. Το κλειδί σας δεν αποθηκεύεται πουθενά και μένει στο πλαίσιο μόνο μέχρι να φύγετε από τη σελίδα. Αν χρησιμοποιείτε το Postman (ένα δημοφιλές εργαλείο δοκιμής API), η σελίδα έχει και το Λήψη της συλλογής Postman.
Ένα πρώτο παράδειγμα με απλά λόγια
Κάθε αίτημα πηγαίνει σε διεύθυνση που ξεκινά με https://feedbro.com/api/v1 και κουβαλά το κλειδί σας σε μια κεφαλίδα που λέγεται Authorization, στη μορφή Bearer ακολουθούμενο από ένα κενό και το κλειδί σας. Για παράδειγμα, ένα πρόγραμμα που ζητά το GET /summary/unread-count παίρνει πίσω έναν αριθμό, πόσα αδιάβαστα άρθρα έχετε σε όλες τις ροές σας, μαζί με την ώρα που υπολογίστηκε. Ένα πρόγραμμα που ζητά το GET /articles με filter=unread παίρνει τα αδιάβαστα άρθρα σας, 25 τη φορά, με τα νεότερα πρώτα. Καθένα έρχεται με τον τίτλο, τον σύνδεσμο, την περίληψη, την εικόνα του και αν είναι αναγνωσμένο, αποθηκευμένο ή στο Διάβασμα αργότερα.
Η ανάγνωση ενός άρθρου μέσω κλειδιού δεν το σημειώνει ως αναγνωσμένο στο FeedBro. Το API επίσης δεν κάνει ποτέ το πρόγραμμά σας να περιμένει όσο φορτώνεται ένας ιστότοπος. Απαντά με ό,τι έχει ήδη το FeedBro και ό,τι χρειάζεται ανάκτηση εκτελείται ως εργασία παρασκηνίου.
Καλό είναι να γνωρίζετε
- Αντιμετωπίστε ένα κλειδί API σαν κωδικό πρόσβασης, επειδή όποιος το έχει μπορεί να διαβάσει τον λογαριασμό σας. Μην το επικολλάτε ποτέ σε δημόσια σελίδα και μην το μοιράζεστε σε στιγμιότυπο οθόνης.
- Αν μια εφαρμογή καταλαβαίνει μόνο RSS, δεν χρειάζεστε καθόλου κλειδί. Χρησιμοποιήστε τους συνδέσμους RSS.
- Οι σύνδεσμοι RSS και τα κλειδιά API είναι ξεχωριστά. Η επαναφορά των συνδέσμων RSS δεν επηρεάζει τα κλειδιά σας και η ανάκληση ενός κλειδιού δεν επηρεάζει τους συνδέσμους σας.
Αν κάτι δεν λειτουργεί
«Unauthenticated.»
Το κλειδί λείπει, έχει γραφτεί λάθος ή έχει ανακληθεί. Ελέγξτε την κεφαλίδα Authorization ή φτιάξτε νέο κλειδί.
«On the Free plan an API key can read only.» ή «Background jobs and webhooks are part of Coffee Club.»
Το αίτημα χρειάζεται Coffee Club.
«Too many requests this minute. Wait a moment and try again.»
Το πρόγραμμά σας στέλνει αιτήματα πολύ γρήγορα. Περιμένετε όσα δευτερόλεπτα γράφει η απάντηση και δοκιμάστε ξανά.
«Monthly limit reached» (δωρεάν) ή το ημερήσιο όριο (Coffee Club)
Τα αιτήματά σας έχουν εξαντληθεί μέχρι την ημερομηνία μηδενισμού που φαίνεται στην απάντηση και στην κάρτα Χρήση.
«Το δωρεάν πρόγραμμα περιλαμβάνει 1 κλειδί API. Το Coffee Club επιτρέπει έως 5.» ή «Μπορείτε να έχετε έως 5 κλειδιά. Ανακαλέστε πρώτα ένα.»
Ανακαλέστε ένα κλειδί που δεν χρησιμοποιείτε πια πριν φτιάξετε νέο.
Η εφαρμογή RSS μου σταμάτησε να ενημερώνεται
Αν κάνατε κλικ στην Επαναφορά συνδέσμων, οι παλιοί σύνδεσμοι δεν λειτουργούν πια. Αντιγράψτε τους νέους από τις Ρυθμίσεις, καρτέλα Ροές.
Ο σύνδεσμος RSS της συλλογής μου δείχνει ένα στοιχείο για το Coffee Club
Οι σύνδεσμοι συλλογών χρειάζονται Coffee Club. Ο σύνδεσμος Αποθηκευμένα λειτουργεί σε κάθε πρόγραμμα.
Το αποθηκευμένο άρθρο μου δεν είναι ακόμη στην εφαρμογή RSS
Οι σύνδεσμοι ανανεώνονται το πολύ κάθε 15 λεπτά στο δωρεάν πρόγραμμα και κάθε 5 λεπτά στο Coffee Club, και η εφαρμογή RSS ελέγχει με το δικό της πρόγραμμα. Περιμένετε λίγο και ελέγξτε ξανά.
