Faʻafefea ona faʻaaoga CURL e Lafo API Talosaga

I lenei tusitusiga, o le a tatou talanoaina faʻafefea ona faʻaaoga curl e faʻafesoʻotaʻi ma RESTful API. curl o se faʻatonuga-laina aoga e mafai ona faʻaaogaina e lafo ai talosaga i se API.

O talosaga API e faia i vaega eseese e fa:

  • Le iʻuga. Ole URL lea matou te lafoina ai talosaga.
  • Le metotia HTTP. Le gaioiga tatou te manaʻo e fai. O auala taatele e GET POST PUT DELETE ma PATCH
  • O ulutala. O ulutala matou te manaʻo e lafo faʻatasi ma la matou talosaga, eg Faʻauluuluga ulutala
  • O le tino. O faʻamatalaga matou te mananaʻo e lafo i le api.


curl Syntax

O le faʻaupuga mo le curl o le faʻatonuga o le:


curl [options] [URL...]

O filifiliga o le a matou talanoaina i lenei tulaga o:

  • -X poʻo --request - HTTP auala e faʻaaogaina ai
  • -i poʻo --include - Aofia ai ma ulutala tali
  • -d poʻo --data - O faʻamatalaga e lafo atu i le API
  • -H poʻo --header - E i ai ni ulutala faʻaopoopo e lafo atu


HTTP GET

O le metotia GET e faʻaaogaina i aumaia se punaoa mai se sapalai. I le curl, o le metotia GET o le auala le masani ai, o lea e le manaʻomia ai ona matou faʻamaotiina.


Faʻataʻitaʻiga:

curl https://jsonplaceholder.typicode.com/posts

GET Ma Fesili Parameter

E mafai foʻi ona matou lafoina faʻafesili faʻapitoa ma le curl MAUA le talosaga.

Faʻataʻitaʻiga:

curl https://jsonplaceholder.typicode.com/posts?userId=5

HTTP POST

O le POST metotia ua faʻaaogaina e faia se punaoa luga o le sapalai.


Lafo mai le curl POST talosaga matou te faʻaaogaina le filifiliga -X POST.

POST Pepa Faʻamaumauga

Faʻataʻitaʻiga:

curl -X POST -d 'userId=5&title=Post Title&body=Post content.' https://jsonplaceholder.typicode.com/posts

A fai e le faaletonu, curl faʻaaogaina Content-Type: application/x-www-form-urlencoded pei o le Content-Type ulutala, o lea tatou te le manaʻomia faʻamalamalamaina pe a lafoina pepa faʻamaumauga.

POST JSON

Ia lafoina se JSON e ala i curl e tatau ona matou faʻamaoti le Content-Type pei application/json.


Faʻataʻitaʻiga:

curl -X POST -H 'Content-Type: application/json'
-d '{'userId': 5, 'title': 'Post Title', 'body': 'Post content.'}'
https://jsonplaceholder.typicode.com/posts


HTTP PUT

O le PUT metotia e masani ona faafouga pe sui se punaoa luga o le sapalai. Na te suia uma faʻamatalaga o le faʻapitoa faʻamatalaga ma le sapalai talosaga talosaga.

Faʻaaliga:Mo se talosaga PUT, e tatau ona matou saunia uma faʻamatalaga i le talosaga tino.

Lafo mai le curl PUT talosaga matou te faʻaaogaina le filifiliga -X PUT.

Faʻataʻitaʻiga:


curl -X PUT -H 'Content-Type: application/json'
-d '{'userId': 5, 'title': 'New Post Title', 'body': 'New post content.'}'
https://jsonplaceholder.typicode.com/posts/5

Ole talosaga i luga ole PUT ole a suia le matou pou sa faia muamua i le 'New post title' ma le 'New post body'.



HTTP PATCH

O le PATCH metotia e faʻaaogaina e faia ai faʻafouga faʻavaitaimi i le punaoa i luga o le sapalai.

Faʻaaliga:Mo se talosaga PATCH, matou te le tau avatua uma faʻamatalaga. Naʻo le faʻamaumauga matou te mananaʻo e faʻafou.

Lafo mai le curl PATCH talosaga matou te faʻaaogaina le filifiliga -X PATCH.

Faʻataʻitaʻiga:


curl -X PATCH -H 'Content-Type: application/json'
-d '{'userId': 5, 'body': 'Updated post content.'}'
https://jsonplaceholder.typicode.com/posts/5

Matau pe faʻafefea ona matou lafoina le tino ma le 'Faʻafouina meli mataupu' ao matou faia se vaega faʻafouga.



HTTP TUPE

O le metotia TAPESE ua faʻaaogaina e aveʻese ai le faʻamatalaga faʻapitoa mai le 'auʻauna.

Lafo mai le curl FAʻAPEFIE talosaga matou te faʻaaogaina le filifiliga -X DELETE.

curl -X DELETE https://jsonplaceholder.typicode.com/posts/5 Faʻaaliga:E leai se tino i le auala e TAPESE ai.

Faamaoniga

O nisi taimi o le API manatu faʻatapulaʻa faʻatapulaʻaina le ulufale ma o le a naʻo le faʻatonuina o faʻamatalaga i tagata faʻamaonia ma faʻatagaina. Mo nei talosaga, e tatau ona matou saunia se avanoa faʻailoga i le ulutala o le talosaga.

Lafo mai le curl header, matou te faʻaaogaina: -H filifiliga.

O le talosaga o loʻo mulimuli mai e lafoina le POST talosaga ma le tagata e ana le faʻailoga i le ulutala:

curl -X POST https://some-web-url/api/v1/users -H 'Accept: application/json' -H 'Content-Type: application/json' -H 'Authorization: Bearer {ACCESS_TOKEN}' -H 'cache-control: no-cache' -d '{ 'username' : 'myusername', 'email' : 'myusername@gmail.com', 'password' : 'Passw0rd123!' }'

Faaiuga

I lenei tulaga na matou aʻoaʻo ai pe faʻafefea ona lafoina talosaga HTTP (GET, POST, PUT, PATCH ma TUPE) i se API faʻaaogaina o curl tulafono.