Una API REST de veritat per a la teva app, a un clic
Descriu els recursos, prem Crea i rep una URL HTTPS amb CRUD complet que la teva web, l'emulador o el mòbil poden cridar ara mateix. Gratuïta, sense compte i compatible amb json-server.
Comprovant el servei…
GET api.pes.elpagesweb.com/xv6tkq0f25ih/tasks?_expand=project
Editor
Esquema
textparagraphnamecompanyemailphoneurlimageaddresscitycountrylatlngint 0-20number 0-40booldatedatetimeenum A|Buuidcolorref recursjson
Carrega un fitxer de projecte exportat aquí, o qualsevol db.json: l'esquema es dedueix dels valors i es conserven les teves files.
En crear una API acceptes les condicions d'ús. Només dades inventades.
La teva API apareixerà aquí
Tria un exemple o descriu els recursos i prem Crea l'API. Rebràs una URL que la teva app pot cridar de seguida.
- Descriu recursos i camps
- Crea l'API
- Crida-la des de la consola o la teva app
Token d'edició i claus
Desa el token d'edició en un lloc segur: canvia l'esquema i esborra l'API, i qui el tingui pot editar-la. Només es guarda en aquest navegador.
Envia la clau d'escriptura a la capçalera X-Api-Key. Pot anar al codi de l'app; el token d'edició, no.
Rutes
Codi client, a punt per enganxar
Fa servir la URL de la teva API.
Obre'l a editor.swagger.io per navegar pel contracte.
Les mateixes dades funcionen sense connexió. Descarrega el db.json i serveix-lo amb json-server, amb la mateixa sintaxi de consulta que aquesta API:
npx json-server@0.17.4 --watch db.json --port 8080 --host 0.0.0.0Les meves API
Es guarden en aquest navegador amb els seus tokens d'edició. Exporta'n una per continuar treballant un altre dia o en un altre ordinador: en importar el fitxer es torna a crear amb les seves dades.
El que entén cada recurs
La sintaxi de consulta de json-server 0.17, més retards i errors a demanda per provar els estats de càrrega i d'error.
| Petició | Què fa |
|---|---|
GET /tasks?done=true | Igual a un valor. Repeteix el paràmetre per a una O. |
?priority_gte=2&priority_lte=3 | Rangs amb _gte i _lte, diferent amb _ne. |
?title_like=informe | Conté, sense distingir majúscules. |
?q=informe | Cerca a tots els camps de text. |
?_sort=priority,id&_order=desc,asc | Ordena per un o més camps. |
?_page=2&_limit=10 | Pàgines, amb les capçaleres X-Total-Count i Link. _start i _end retallen. |
GET /projects/1/tasks | Fills d'una fila (POST omple projectId). |
?_expand=project · ?_embed=tasks | Afegeix la fila pare, o les files filles. |
?_delay=1500 | Respon al cap d'1,5 s (fins a 3 s), per veure l'estat de càrrega. |
?_status=503 | Respon amb aquest error i no canvia res, per provar la gestió d'errors. |
GET /db | Totes les dades. |
Més estricta que json-server, a propòsit: els camps que no són a l'esquema es rebutgen amb el seu nom, els valors es comproven segons el tipus i els id són enters que assigna el servidor. Els errors d'escriptura de l'app surten de seguida i no setmanes després.
Límits, sense lletra petita
| Recursos per API | |
| Camps per recurs | |
| Files per recurs | |
| Mida d'una API | |
| Caràcters per valor de text | |
| API noves per xarxa i hora | |
| S'esborra després d'aquests dies sense canvis | |
| Vida màxima d'una API, en dies |
Quan molta gent la fa servir alhora
El servei funciona amb infraestructura gratuïta amb quotes diàries. Amb molta demanda, primer es pausa la creació d'API noves, perquè les que ja existeixen continuïn funcionant. Cada rebuig torna com a JSON amb un missatge clar i la capçalera Retry-After, i la pàgina et diu quan tornar-ho a provar. Si ni tan sols responen les API existents, s'ha esgotat la quota diària gratuïta: torna a la mitjanit UTC. Mentrestant descarrega el db.json i executa'l tu.
Passar al backend real
La teva app només coneix una URL base. Quan l'API real estigui a punt, canvia aquesta línia; si segueix les mateixes rutes, no cal canviar res més.
Preguntes
És gratuïta de veritat?
Sí. No hi ha compte ni pla de pagament. La publicitat d'aquesta pàgina ajuda a cobrir-la, i els límits d'aquí dalt la mantenen gratuïta per a tothom.
Quant dura la meva API?
S'esborra 30 dies després de l'últim canvi i, en tot cas, 180 dies després de crear-la. Exporta-la des de Les meves API per conservar l'esquema i les dades, i importa el fitxer per recuperar-la.
El meu equip pot editar la mateixa API?
Sí: Comparteix l'edició copia un enllaç que afegeix l'API, amb el seu token d'edició, al navegador que l'obre. Comparteix-lo només amb gent de confiança.
Hi puc posar dades reals?
No. Fes servir només dades inventades: res de dades de persones reals, contrasenyes ni dades de pagament. Les API obertes i de només lectura les pot llegir qualsevol persona que tingui la URL.
Funciona des de l'emulador d'Android o un mòbil?
Sí. Se serveix per HTTPS amb CORS obert, de manera que emuladors, mòbils i webs la poden cridar sense excepcions de text pla ni proxies.
En què es diferencia de json-server?
Està allotjada, així que tot l'equip i tots els dispositius comparteixen una sola API sense executar res. Parla la mateixa sintaxi de consulta, valida les escriptures amb el teu esquema i afegeix retards i errors simulats. Esborrar una fila no n'esborra les filles.
Denuncia una API
Si una API conté contingut il·legal, dades personals reals o qualsevol cosa que incompleixi les condicions d'ús, avisa'ns. Les denúncies es revisen sense demora indeguda. També pots escriure a appsdelpages@gmail.com.