¿Cómo escribir una API REST?

Question

Estoy escribiendo una aplicación para iPhone como un proyecto de hobby y necesitará un servicio web para proporcionarle los datos. No es muy diferente de lo que hago en el trabajo, pero en el trabajo solo escribo vistas y controladores. Alguien más es responsable de escribir el modelo y generalmente los clientes proporcionan el servicio web.

He hecho algo de programación web antes, cuando todos usaban MySQL y PHP, por lo que mis habilidades están un poco desactualizadas, pero estoy seguro de que podría aprovechar las técnicas que ya conozco. Sin embargo, no quiero perder el tiempo usando herramientas obsoletas. He descubierto que el estado del arte sería escribir una API REST. Estaba pensando que debería haber algunos marcos bastante buenos que simplemente te ofrezcan una API REST con funcionalidad CRUD tan pronto como hayas definido un modelo.

Supongo que mi pregunta es: ¿Cuál sería la forma más rápida de poner en marcha una API REST? Realmente solo quiero centrarme en escribir la aplicación iPhone y no perder demasiado tiempo en esta API. Sería genial si pudiera obtener la administración web y el historial de revisión también. También debería agregar que se supone que la API no es pública, por lo que el soporte para la autenticación sería excelente.

Solo para ser claro. No me importaría un framework PHP. De hecho, podría ser mejor ya que sé que mi alojamiento actual lo admite.

Answer 1

Sólo para hacerle saber:

Terminé usando Ruby on Rails.

EDIT: Dado que esta respuesta ha sido downvoted por no proporcionar la razón detrás de la elección de Ruby on Rails y también hay instrucciones sobre cómo escribir una API REST con él, pensé que le daría mi motivación y unas sencillas instrucciones .

Empecé a leer un libro sobre Ruby on Rails y me di cuenta de que todo lo que tenía que hacer era utilizar andamios y obtuve una API JSON REST de forma gratuita.

He aquí una buena guía para empezar: http://guides.rubyonrails.org/getting_started.html

Cuando tienes tu Ruby on entorno de Rails en funcionamiento, la creación de su API REST no es más difícil que administrar:

$ rails generate scaffold Post name:string title:string content:text 

(Ejemplo del enlace de arriba). También encontré que Rails es muy fácil y gratuito de implementar en heroku, lo que significaba que no tenía que pagar por el alojamiento de mi API REST muy básica y de poco tráfico. Hay muchas otras razones por las cuales estoy muy contento de trabajar con Ruby on Rails, pero eso está más allá del contexto de esta pregunta.

Answer 2

Debe usar los idiomas con los que se sienta cómodo para el servicio web. Cualquier lenguaje que pueda formular respuestas REST a las solicitudes está bien.

Dicho esto, si desea obtener algo rápido, le sugiero usar Python en Google App Engine. Es gratis y puedes usar Java en lugar de Python si lo deseas. App Engine admite autenticación utilizando OpenID y/o cuentas de Google (no estoy seguro si son mutuamente excluyentes), por lo que debería facilitar el código.

En cuanto a hacer las solicitudes en el dispositivo iOS, sugiero usar ASIHTTPRequest.

Answer 3

¿Qué hay de Python?

Usaría Python, Django y Piston.

1. Me generar modelos de Django desde su existente DB usando inspectdb.
2. Agregue el Django admin a sus modelos.
3. Agregue Django Piston a su aplicación.
4. Beneficio.

Sin experiencia con Python o Django probablemente le lleve un día desarrollar esta solución y todos los códigos están probados en unidades y proved to work.

Answer 4

Consulte la siguiente clase de PHP que sigue a MVC. http://www.phpclasses.org/package/5080-PHP-Implement-REST-Web-services-servers.html

Espero que esto ayude.

Answer 5

Si ya conoce PHP, no hay nada de malo con un backend de PHP/MySQL.Puede enviar todas las respuestas en formato plist XML compatible con iPhone, y al instante convertir la respuesta en una estructura de datos NSDictionary/NSArray/NSNumber con este breve fragmento de código:

NSString *response = [request responseString]; 
NSData* plistData = [response dataUsingEncoding:NSUTF8StringEncoding]; 
NSPropertyListFormat format; 
NSString *errorStr; 
NSDictionary* plist = [NSPropertyListSerialization propertyListFromData:plistData 
                 mutabilityOption:NSPropertyListImmutable 
                   format:&format 
                 errorDescription:&errorStr]; 

también utilizo el paquete ASIHTTP para la formación de direcciones URL , el envío de requets asíncronos, y recibir las respuestas, le recomiendo que:

http://allseeing-i.com/ASIHTTPRequest/

Answer 6

he programado una API REST en ZEND Framework utilizando el Zend_Rest_Controller, en el iPhone que utiliza ASIHTTPRequest. Mi experiencia con ambos fue buena. Al principio tuve algunos problemas para configurar ZEND y conectarlo a mySQL, pero una vez que descubrí cómo hacerlo, pude escribir la API muy rápidamente. Puedo compartir más información con usted si tiene más preguntas.

EDITAR: Parece que no hay documentación oficial en Zend_Rest_Controller. This link describe cómo usarlo para crear su API. Simplemente tiene que deshabilitar la representación en el init() de su subclase e implementar los métodos para cada llamada REST.

Answer 7

EDIT:

Los enlaces inferiores que al parecer fueron buenas durante 3 años ya no están trabajando, así que fui y encontré un par de nuevos tutoriales que creo que van a quedarse por un tiempo. Estos se encuentran en el sitio de Ray Wenderlich, un sitio tutorial de desarrollo ios muy respetado. El primer artículo en realidad hace referencia a los siguientes enlaces rotos pero es completo en sí mismo:

How To Write A Simple PHP/MySQL Web Service for an iOS App

y el segundo tiene un pequeño giro a la misma. Usó parse.com en el backend y AFNetworking. Ambos son bastante excelentes.

How To Synchronize Core Data with a Web Service – Part 1

---

he fijado los enlaces rotos a continuación mediante la búsqueda de los artículos en el camino de regreso de la máquina. A la gente parece gustarle los enlaces, así que los guardaré. Los enlaces de arriba deberían proporcionar más comida para pensar.

---

Estoy haciendo exactamente lo mismo con mi aplicación de iPhone. He encontrado este artículo en la construcción de una API REST en PHP:

https://web.archive.org/web/20130910164802/http://www.gen-x-design.com/archives/create-a-rest-api-with-php/

y también hay un artículo de seguimiento aquí:

https://web.archive.org/web/20130323001500/http://www.gen-x-design.com/archives/making-restful-requests-in-php/

con un enlace al código fuente en la parte inferior de la artículo.

Answer 8

Otra opción es restSQL, un marco de persistencia ultraligero. Ver http://restsql.org. Es compatible con MySQL y PostgreSQL y se ejecuta en un contenedor Java EE estándar, p. Apache Tomcat.

restSQL es una capa de acceso a datos muy poco convencional. restSQL no es una vista orientada a objetos de la base de datos. Presenta "vistas" planas o jerárquicas de tablas de bases de datos relacionales. Estas vistas son consultables y actualizables a través de una simple API de HTTP o Java basada en REST.La interfaz HTTP se basa en los principios de REST, que utilizan las funciones incorporadas de HTTP, en lugar de abstraerse de ellos.

Desea una "API REST con funcionalidad CRUD" y eso es exactamente el punto óptimo de restSQL. Podrías hacer esto sin código. Simplemente defina sus recursos SQL a través de archivos XML y comience a hacer llamadas HTTP contra ellos con la capacidad CRUD completa.

Answer 9

Si desea utilizar PHP le recomiendo usar el marco CodeIgniter con el servidor REST de Phil esturión:

http://net.tutsplus.com/tutorials/php/working-with-restful-services-in-codeigniter-2

https://github.com/philsturgeon/codeigniter-restserver

Answer 10

que siguieron un tutorial muy sencillo para la creación de APIs REST con PHP:

Corey Maynard - Creating a RESTful API with PHP

The concepto principal incluye:

• una clase abstracta que se encarga del análisis de la URI y devolver la respuesta, y
• una clase concreta que se compone de sólo los puntos finales de la API.