Esiste un linguaggio standard per la definizione delle API HTTP?

Question

Esiste un linguaggio standard per la definizione delle API HTTP?

#1 da (8 voti)
#2 da (4 voti)

2

Ad esempio, Facebook e Google hanno un sacco di API, come ottenere dati e fare azioni per conto di un utente (file di backup su Google Drive).

Posso leggere tutta la loro documentazione ma di solito mi piace tenerla molto tecnica. La documentazione ha un sacco di testo non necessario: (

Esiste uno standard per l'interrogazione delle API di un sito (server)?

Mi piacerebbe fare qualcosa come link (o link ), ottieni un elenco di API e inizia a invocarle. C'è un tale standard? Chi è nel settore lo implementa? Grazie.

api rest http

posta AlikElzin-kilaka 18.04.2017 - 14:16

fonte

2 risposte

Leggi altre domande sui tag api rest http

È possibile creare un file di intestazione C da una libreria dinamica? Come dovrei tradurre un documento dei requisiti in user story?

score 8 · Answer 1

8

C'è Swagger . Non è uno standard ma ti permette di definire il simething molto simile per le tue API. Gli utenti possono richiedere /swagger.json e ottenere una definizione leggibile dalla macchina della tua API.

risposta data 18.04.2017 - 14:29

fonte

score 4 · Answer 2

Come ha sottolineato @marstato: c'è Swagger, che al momento è qualcosa di simile a uno standard defacto per descrivere le API "restful". Swagger ha così tanto successo, che ora c'è un OpenAPI Initiative che ha alcuni ben noti membri , che ci stanno lavorando.

Altri giocatori / soluzioni in questo campo sono RAML , Apiario , APIBlueprint .

Poi ci sono soluzioni come Django Restframework che hanno le loro idee.

Nel complesso, c'è un po 'di movimento nel mercato, anche se l'idea non è nuova.

Un buon posto dove andare è integrare il pacchetto npm UI Swagger nel tuo progetto. Viene fornito con un componente editor interattivo che è un buon punto di partenza. Questo video mostra come integrarlo nel tuo progetto. Zalando, la società di moda, ha una buona linea guida per le API REST. E se siete sul lato di Python, hanno un framework davvero eccezionale chiamato connessione .