Εφαρμογές και API

Ένα νέο endpoint notes/context επιστρέφει τις απαντήσεις πάνω και κάτω από μια δημοσίευση, με τη σειρά του νήματος, εντός των ίδιων ορίων με το Mastodon. Τροφοδοτεί την προβολή νήματος των εφαρμογών Mastodon· οι δικές του προβολές νήματος του Catodon δεν το χρησιμοποιούν.

Κάθε παράδοση από ένα webhook με μυστικό φέρει πλέον μια κεφαλίδα X-Catodon-Signature, ένα HMAC-SHA256 μιας χρονοσφραγίδας και του σώματος με κλειδί αυτό το μυστικό, ώστε ο παραλήπτης να μπορεί να ελέγξει ότι προέρχεται από τον διακομιστή σας και ότι είναι πρόσφατη. Τα webhook που δημιουργούνται χωρίς μυστικό λαμβάνουν πλέον ένα τυχαίο, και η X-Misskey-Hook-Secret, που στέλνει το ίδιο το μυστικό, καταργείται σταδιακά και θα αφαιρεθεί στην 27.1.0.

Τα webhook λογαριασμού και συστήματος παραθέτουν πλέον τις 30 τελευταίες απόπειρες παράδοσής τους: πότε, ποιο συμβάν, την κατάσταση HTTP ή τον λόγο για τον οποίο δεν ήρθε απάντηση, και πόσο διήρκεσε. Ένα κουμπί Αποστολή ξανά στέλνει εκ νέου μια παράδοση που χάθηκε όσο ο παραλήπτης σας ήταν εκτός λειτουργίας, ακόμη και όταν το webhook είναι απενεργοποιημένο, διατηρώντας το eventId της ώστε ο παραλήπτης να την αναγνωρίζει. Το αρχείο είναι επίσης αναγνώσιμο μέσω των i/webhooks/deliveries και admin/system-webhook/deliveries.

Ένα webhook που αποτυγχάνει να παραδώσει 10 συμβάντα στη σειρά, με το πρώτο τουλάχιστον μία ώρα νωρίτερα, απενεργοποιείται πλέον αντί να στέλνει για πάντα σε μια νεκρή διεύθυνση, και ο κάτοχός του ειδοποιείται: ο λογαριασμός, ή κάθε συντονιστής και διαχειριστής για ένα webhook συστήματος. Μετρούν μόνο τα συμβάντα που εξάντλησαν όλες τις επαναλήψεις τους, οπότε μια σύντομη διακοπή δεν αλλάζει τίποτα, και το webhook μπορεί να ενεργοποιηθεί ξανά μόλις ο παραλήπτης του λειτουργήσει.

Δύο πράγματα τις εμπόδιζαν: το token που παρέδιδε το Catodon δεν είχε ένα πεδίο που η εφαρμογή απαιτούσε, και μια εφαρμογή που δεν ζητά συγκεκριμένη πρόσβαση μπορούσε μόνο να διαβάζει. Και τα δύο έχουν διορθωθεί, και μια τέτοια εφαρμογή σας αφήνει πλέον να επιλέξετε ανάμεσα σε μόνο ανάγνωση και ανάγνωση και εγγραφή κατά την εξουσιοδότηση.

Οι εφαρμογές Mastodon μπορούν να προγραμματίζουν δημοσιεύσεις μέσω του API του Mastodon.

Το Tusky, το Pachli, το Ice Cubes και άλλες εφαρμογές Mastodon μπορούν πλέον να εγγράφονται για push, ώστε να μαθαίνουν αμέσως κάθε νέα ειδοποίηση αντί να ελέγχουν κάθε 15 λεπτά ή να μη λαμβάνουν τίποτα όσο είναι κλειστές. Τηρούνται τα είδη ειδοποιήσεων που ζητά η εφαρμογή και η ρύθμισή της «από ποιον», και η ανάκληση της πρόσβασης μιας εφαρμογής αφαιρεί τη συνδρομή της. Βασίζεται στις υπάρχουσες ρυθμίσεις Web Push του διακομιστή.

Οι διακομιστές δημοσιεύουν Digital Asset Links, ώστε η εφαρμογή Android του Catodon να μπορεί να επαληθεύει τον τομέα τους.

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

Η διαδρομή μετάφρασης του Mastodon απαντά πλέον από τον μεταφραστή που ο διακομιστής χρησιμοποιεί ήδη για τις δικές του δημοσιεύσεις, και ο διακομιστής ανακοινώνει τη δυνατότητα και τις γλώσσες στις οποίες μεταφράζει, ώστε το Tusky να προσφέρει το κουμπί μετάφρασής του μόλις δει την ένδειξη.

Σε ένα endpoint που απαιτεί διαπιστευτήρια και δέχεται αρχείο, το διαπιστευτήριο πρέπει να προηγείται του αρχείου στο σώμα multipart. Παλαιότερα συλλεγόταν πρώτα ολόκληρο το σώμα, πράγμα που σήμαινε εγγραφή ολόκληρης της αποστολής στον δίσκο πριν γίνει γνωστό αν ο αποστολέας είχε δικαίωμα να την κάνει.

Το Catodon είχε πάντα το «Απόκρυψη από την Αρχική» σε μια λίστα, αλλά η έξοδός του προς το Mastodon το αγνοούσε: το πεδίο αναφερόταν ως άγνωστο και απορριπτόταν όταν ένας πελάτης επιχειρούσε να το ορίσει. Οι πελάτες τρίτων βλέπουν και αλλάζουν πλέον το ίδιο πράγμα με έναν λογαριασμό Catodon.

Αποθηκεύονταν και ομοσπονδιώνονταν πάντα προς τις δύο κατευθύνσεις· τίποτα δεν τις διάβαζε πίσω. Και τα δύο API τις αναφέρουν πλέον όπου ο λογαριασμός είναι το αντικείμενο του αιτήματος, και η διαδρομή ενημέρωσης του Mastodon τις γράφει στις εικόνες που κατονομάζονται στην ίδια κλήση. Ο πελάτης ιστού δεν τις εμφανίζει ούτε τις επεξεργάζεται ακόμη.

Μια εφαρμογή που προσφέρει δημιουργία λογαριασμού, όπως αυτή του ίδιου του Mastodon, μπορεί πλέον να το κάνει σε διακομιστή Catodon μέσω του POST /api/v1/accounts του Mastodon, τηρώντας κάθε κανόνα της φόρμας του διακομιστή: προσκλήσεις, έγκριση, επαλήθευση email, ελάχιστη ηλικία και δεσμευμένα ονόματα χρήστη. Κάθε άρνηση αναφέρεται στο αντίστοιχο πεδίο. Ένας διακομιστής με captcha αρνείται τις εγγραφές από εφαρμογές, και οι εγγραφές από εφαρμογές έχουν όριο ρυθμού ανά διεύθυνση IP και ανά εφαρμογή.

Μια εφαρμογή μπορεί να συνδεθεί χωρίς να έχει καταχωριστεί εκ των προτέρων: αναγνωρίζεται από μια διεύθυνση ιστού που την περιγράφει και αποδεικνύει την ταυτότητά της με PKCE, ενώ η σελίδα συγκατάθεσης δείχνει το όνομα και το εικονίδιό της. Οι εφαρμογές που χρησιμοποιούν το API πελάτη-προς-διακομιστή του ActivityPub μπορούν τότε να δημοσιεύουν, να ακολουθούν, να αντιδρούν, να διαβάζουν το χρονολόγιο Αρχική και άλλα, μέσω του outbox του λογαριασμού. Είναι ενεργό από προεπιλογή, και η επιλογή Πίνακας ελέγχου → Ομοσπονδία → Πολιτική απενεργοποιεί το API πελάτη του ActivityPub.

Το νέο endpoint notes/thread επιστρέφει τις απαντήσεις κάτω από μια δημοσίευση σε βάθος πολλών επιπέδων με ένα μόνο αίτημα, ως επίπεδη λίστα όπου κάθε απάντηση κατονομάζει τη γονική της, με έναν δείκτη συνέχειας όπου απομένουν κι άλλες απαντήσεις. Ταξινομεί κατά κορυφαίες, παλαιότερες ή νεότερες σε κάθε επίπεδο, δέχεται όρια στο μέγεθός του και αφήνει έξω τις απαντήσεις που δεν μπορείτε να δείτε μαζί με ό,τι βρίσκεται κάτω από αυτές.

Το νέο endpoint notes/followed-hashtags επιστρέφει, για κάθε hashtag που ακολουθείτε, την πιο πρόσφατη δημόσια δημοσίευσή του, με τις νεότερες πρώτες, με τα ίδια φίλτρα και την ίδια σελιδοποίηση όπως το notes/following. Οι δημοσιεύσεις από λογαριασμούς και διακομιστές σε σίγαση, αποκλεισμένους ή σε αναστολή, καθώς και οι δημοσιεύσεις που φέρουν ένα hashtag που έχετε αποκλείσει, αφήνονται έξω.

Τρία πεδία φόρουμ που ο διακομιστής έστελνε ήδη, αν ένα φόρουμ προορίζεται για ενήλικες και δύο περιορισμοί για το ποιος μπορεί να δημοσιεύει, δηλώνονται πλέον στην περιγραφή του API, και οι παραγόμενοι τύποι misskey-js ακολουθούν. Τίποτα από όσα στέλνει ο διακομιστής δεν αλλάζει.

Για τις εφαρμογές, το notes/bubble-timeline δέχεται πλέον τις ίδιες επιλογές με το notes/global-timeline: ταξινόμηση Δημοφιλή και Ενεργά, και διακόπτες για τις απαντήσεις και τις δημοσιεύσεις φόρουμ, καθένας με προεπιλογή ό,τι επέστρεφε το Bubble μέχρι τώρα. Το Bubble αφήνει επίσης πλέον έξω τις απαντήσεις σε δημοσιεύσεις μόνο για ακολούθους από συγγραφείς που δεν ακολουθείτε, όπως κάνει το παγκόσμιο χρονολόγιο.