|
|
Le due architetture primarie per APIs sono RESTO e SAPONE. Nel generare il vostro api, realmente avete tre opzioni: RESTO, SAPONE, o entrambi. Il RESTO APIs è conosciuto per essere facile e rapido da svilupparsi per, ma l'intera richiesta è introdotta la radura senza riguardo al tipo di crittografia usato. Il SAPONE APIs è più complesso, richiedendo più sforzo generare la risposta e maneggiare la richiesta, ma tiene conto flessibilità più grande aggiungendo il supporto del namespace. Fornire APIs di entrambi i tipi può suonare come un'opzione attraente, ma tenere presente che raddoppierà la vostri manutenzione, sostegno e tempo della documentazione la durata dell'api.
Entrambi i metodi di api già sono stati introdotti lungamente; questa sezione si concentra sulle differenze per tenere presente quando sviluppa un api.
Nel ricevere una richiesta di RESTO, le informazioni entreranno via OTTENGA. Come tali, tutte le informazioni dovranno URL-ESSERE messe durante la trasmissione; probabilmente desidererete decodificarli prima del soggetto esso alla trasformazione affatto più ulteriore (l'eccezione che è usernames e parole d'accesso, che sono generalmente così com'è proceduto). I tipi differenti di richiesta dovrebbero essere indirizzati ai punti finali differenti (URLs); se desiderate usare un singolo scritto per maneggiare tutte le richieste, potete il uno o il altro presente esso agli sviluppatori in quanto modo (tutte le richieste vanno ad un singolo punto finale), o configuri il vostro web server per tracciare molti punti finali ad un singolo scritto. Suggerirei generalmente il posteriore; è in linea con la specifica e permette che rendiate i cambiamenti successivamente senza interessare l'uso esterno degli sviluppatori delle interfacce.
Studii la possibilità di permettere che gli sviluppatori usino un'interfaccia di fotoricettore per fare le richieste contro l'api. Ciò può essere utile grande quando tenta diagnosticare un problema; gli sviluppatori potranno determinare rapidamente se il problema è la richiesta o il loro codice. Più attrezzi che potete fornire agli sviluppatori in termini di sistema diagnostico, più facile sarà di svilupparsi per il vostro luogo.
Quando la richiesta del SAPONE entra, dovrebbe in primo luogo essere controllato per accertarsi che sia conforme alla disposizione specificata dal vostro documento di WSDL. Se state utilizzando un attrezzo quale NuSOAP, questo è fatto per voi. Infatti, la maggior parte del uso di APIs del SAPONE una certa struttura che prende a cura di molto il lavoro di grugnito quando maneggia le richieste. Uso che di APIs del SAPONE un singolo punto finale per tutto chiede (come regola generale, alcune grandi funzioni disparate separate di APIs sui punti finali differenti) e di conseguenza probabilmente uno avrete un grande scritto a quel punto, o lotti delle chiamate del require() eseguite secondo la chiamata particolare.
Studii la possibilità di permettere che gli sviluppatori usino un'interfaccia di fotoricettore in cui possono incollare gli interi documenti di richiesta su una forma e che facciali funzionare contro il vostro assistente. Parlando dall'esperienza diretta, avendo qualcosa come questo disponibile è utile grande agli sviluppatori quando prova a diagnosticare un problema. Fornendo gli scritti o le funzioni sul vostro luogo per permettere che gli sviluppatori generino le richieste inoltre sarà manualmente di assistenza agli sviluppatori che non usando una struttura del SAPONE.
Online: 543 users browsing the articles directory
|
|