Sto creando un servizio web WCF con il servizio di autenticazione WcF e il primo set di funzioni necessario è la gestione di una casella di posta in arrivo per un client. Il client sarà determinato dall'autenticazione.Sto progettando correttamente questa interfaccia REST di WCF?
Questo è il mio tentativo di un design RESTful delle API:
https://api.mydomain.com/v1/inbox/messages (GET)
restituisce una pagina dei risultati nel casella di posta con un filtro di ricerca opzionale applicato
- Conte - numero di record per pagina
- Pagina - pagina iniziale
- Sort - campo (opzionale) per ordinare il
- Ricerca - (opzionale) testo da cercare
https://api.mydomain.com/v1/inbox/mark (POST)
Marks uno o più messaggi letti o non letti
- Azione - MarkRead o MarkUnread
- MessageIDs - elenco di ID messaggio per contrassegnare
https://api.mydomain.com/v1/inbox/archive (POST)
Archives uno o più messaggi
- MessageIDs - lista dei messaggi per archiviare gli ID
Sto facendo questo diritto? In caso contrario, quale sarebbe un modo migliore per progettare questa interfaccia?
Suoni come letti e non letti possono far parte del tuo secondo URL? 'https: // api.mydomain.com/v1/inbox/mark/read' e' https: // api.mydomain.com/v1/inbox/mark/unread' –
Dovrebbero essere due funzioni separate o una funziona con un parametro (che è più normale nell'API RESTful)? – Jason
se fai ciò che ho suggerito, allora sarebbero due punti finali, giusto? come in due URL. Ma il sistema può gestirli con lo stesso metodo. –