He aha te API? Me etahi atu Acronyms: REST, SOAP, XML, JSON, WSDL
Ina whakamahi koe i te kaitirotiro, ka tono tono to kaitirotiro mai i te kaimau a te kiritaki, ka whakahokia mai e te tūmau nga raraunga ka whakahiatohia e to kaitirotiro me te whakaatu i tetahi wharangi paetukutuku. Engari me pehea ki te hiahia noa koe kia korero to kaimau, wharangi paetukutuku ranei ki tetahi atu tūmau? Ma tenei ka hiahia koe ki te hotaka ki tetahi API.
He aha te turanga API?
He whakakahoretanga te API Atanga Papatono Taupānga (API). Ko te API he huinga o nga mahinga, tikanga, me nga taputapu mo te hanga i nga tono-tukutuku me nga tono-a-waea. Ko te API e whakaatu ana me pehea e taea ai e koe te whakamotuhēhē (he kōwhiringa), tono me te whiwhi raraunga mai i te tūmau API.
He aha te API?
Ina whakamahia i roto i te horopaki o te whanaketanga paetukutuku, ko te API te tikanga he huinga tautuhi o te Kawa Whakawhiti Kuputuhi Kuputuhi (HTTP) tono karere, me te whakamaramatanga o te hanganga o nga karere whakautu. Ka whakaaetia e nga API Tukutuku te whakakotahitanga o nga ratonga maha ki nga tono hou e kiia nei ko te mashup.
Wikipedia
Me homai he tauira ngawari. Mena ka whakamahi koe i te hono poto ki te tohatoha i te roa URL pai ake, ka whakamahi pea koe i tetahi ratonga penei Bit.ly. Ka patohia e koe te URL roa ki roto, tukuna te URL, ka whakautu a Bit.ly me te URL poto.
He aha mena kei te pirangi koe ki te whakamahi i te Bit.ly i roto i te whānuitanga o te papaaho e whakamahia ana e koe? Akene kua hanga e koe he kaihanga waehere QR i runga ipurangi engari kei te pirangi koe kia poroa nga URL roa i te tuatahi. I tenei keehi, ka taea e koe te whakarite i to pae ki te tuku tono ki te Bit.ly API ka hopu i te whakautu hei hanga i to waehere QR.
Ko te tukanga he mea aunoa me te API kaore e hiahiatia he wawaotanga tangata. Koinei te waahi ka tukuna e nga API ki ia whakahaere. Ka awhina nga API ki nga punaha ki te tukutahi i nga raraunga, ki te tukatuka tono, me te whakahaere aunoa i nga tikanga ka mahia ma te ringa.
Mēnā he API pakari te tūāpapa, ko te tikanga ka taea e koe te whakakotahi me te whakaaunoa - te penapena i te waa-a-ringa, te whakapai ake i nga kaha-waahi o o papaahi, me te whakarite kia pai ake te tika - te karo i nga take me te urunga raraunga a-ringa.
He Ataata Me pehea te Mahi o nga API
Mena he kaiwhakawhanake papaaapapa koe, ka tukuna ano e nga API te whai waahi ki te wehe i to atanga kaiwhakamahi mai i a koe i to tatauranga me nga paatai papaunga raraunga. He aha te mea nui? I a koe e whakawhanake ana i to atanga kaiwhakamahi, ka taea e koe te whakamahi i nga API e whakaputahia ana e koe mo etahi atu tuatoru. Ka taea e koe te tuhi ano i to atanga kaiwhakamahi me te kore e maaharahara ki te pakaru i te whakakotahitanga o muri.
Me pehea te kimi API e waatea ana
Kei te rapu koe mo tetahi API mo tetahi hua, ratonga ranei? Anei etahi rauemi e whakarārangi ana i nga API ka taea e koe te whakamahi mo koe ake me te arumoni:
Me pehea te Whakamatau i nga API
Ko te API he tono HTTP noa, he rite tonu ki te kaitirotiro. Ko te rereketanga ko te API he maha nga wa e hiahia ana tetahi tikanga motuhēhēnga ki te tono. Mena kaore e hiahiatia he motuhēhēnga, ka taea e koe te tono ma te whakapiri i te URL tono ki te tirotiro. Anei tetahi tauira o te tono ki a API huarere tuwhera-puna.
Ma te OSX, ka taea e koe te whakamahi i te cURL whakahau i roto i te matapihi kāpeka. I te mahi i te whakahau, cURL
ka tukuna he tono GET ki te URL API kua whakaratohia, ka whakaatuhia te whakautu kei roto nga raraunga matapae huarere ki te Terminal.
curl "https://api.open-meteo.com/v1/forecast?latitude=52.52&longitude=13.41¤t_weather=true&hourly=temperature_2m,relativehumidity_2m,windspeed_10m"
I Windows, ka taea e koe te whakauru curl
ka taapiri atu ki te PATH o te punaha kia mahi ai te whakahau. I tua atu, ka taea e koe te whakamahi i te hunga tuatoru curl
nga whakahaere mo Windows, penei i cURL mo Windows or curl mo Windows na Winamp me te whakahaere i te whakahau curl pera ano.
Anei etahi atu reo me pehea e taea ai e koe te tono API:
- python: te
requests
Kei te whakamahia te whare pukapuka mo te hanga tono HTTP ki Python. Anei he tauira:
import requests
response = requests.get('https://example.com')
print(response.text)
- JavaScript (Node.js): te
axios
Ko te whare pukapuka he kiritaki HTTP e whakamahia nuitia ana mo Node.js. Anei he tauira:
const axios = require('axios');
axios.get('https://example.com')
.then(response => {
console.log(response.data);
})
.catch(error => {
console.error(error);
});
- JQuery: Whakamahia te
$.ajax
or$.get
mahi ki te hanga tono HTTP. Anei he tauira mo te tono tono GET ma te whakamahi$.ajax
i roto i te jQuery:
$.ajax({
url: 'https://example.com',
method: 'GET',
success: function(response) {
console.log(response);
},
error: function(error) {
console.error(error);
}
});
- Rupi: Kei roto i te whare pukapuka paerewa a Ruby te
net/http
kōwae mō te hanga tono HTTP. Anei he tauira:
require 'net/http'
require 'uri'
uri = URI.parse('https://example.com')
response = Net::HTTP.get_response(uri)
puts response.body
- Java: Ka whakaratohia e Java etahi whare pukapuka me nga anga mo te hanga tono HTTP, penei
HttpURLConnection
(i te whare pukapuka paerewa), Apache HttpClient, OkHttp ranei. Anei he tauira whakamahiHttpURLConnection
:
import java.io.BufferedReader;
import java.io.IOException;
import java.io.InputStreamReader;
import java.net.HttpURLConnection;
import java.net.URL;
public class Main {
public static void main(String[] args) throws IOException {
URL url = new URL("https://example.com");
HttpURLConnection connection = (HttpURLConnection) url.openConnection();
connection.setRequestMethod("GET");
BufferedReader reader = new BufferedReader(new InputStreamReader(connection.getInputStream()));
String line;
StringBuilder response = new StringBuilder();
while ((line = reader.readLine()) != null) {
response.append(line);
}
reader.close();
System.out.println(response.toString());
}
}
- C# ranei ASP.NET: Whakamahia te
HttpClient
akomanga ki te hanga tono HTTP. Anei tetahi tauira mo te hanga tono GET ma te whakamahiHttpClient
i C#:
using System;
using System.Net.Http;
using System.Threading.Tasks;
class Program
{
static async Task Main()
{
using (HttpClient client = new HttpClient())
{
HttpResponseMessage response = await client.GetAsync("https://example.com");
response.EnsureSuccessStatusCode(); // Ensure a successful response
string responseBody = await response.Content.ReadAsStringAsync();
Console.WriteLine(responseBody);
}
}
}
Kia mahara ki te taapiri i nga mea e tika ana using
tauākī me te hapai tika i nga okotahi i te wa e mahi tahi ana HttpClient
i roto i to tono ASP.NET, C# ranei.
- WordPress: Kei te WordPress API ana ake mahi
wp_remote_get
orwp_remote_post
:
$response = wp_remote_get('https://example.com');
if (is_wp_error($response)) {
$error_message = $response->get_error_message();
echo "Request failed: $error_message";
} else {
$body = wp_remote_retrieve_body($response);
$data = json_decode($body);
// Process the retrieved data
var_dump($data);
}
Ko enei tauira e whakaatu ana me pehea te mahi i tetahi tono GET taketake, engari ko enei whare pukapuka e tautoko ana i nga tikanga HTTP rereke (GET, POST, me etahi atu) me te whakarato i nga whiringa mo te whakatakoto pane, te tuku utu tono, me te whakahaere i nga whakautu i roto i nga tikanga matatau ake.
Kia mahara ki te whakauru i nga whakawhirinakitanga me nga whare pukapuka e hiahiatia ana mo to reo papatono i mua i te whakahaere i nga tauira waehere.
He tono Chrome pai a Talend mo te taunekeneke me nga API me te kite i a raatau whakautu mena ka hiahia koe ki te whakamatau i nga API me te kore e tuhi i tetahi rarangi waehere.
Tāpirihia te Kaiwhakamātau API a Talend ki Chrome
He aha te tohu mo te Acronym SDK?
Ko te SDK he ingoa haangarau mo Kete kaiwhakawhanake rorohiko.
Ina whakaputahia e te kamupene tana API, kei te nuinga o nga wa kei te taha o nga tuhinga e whakaatu ana me pehea te whakamotuhēhēnga o te API, me pehea te patai, me nga whakautu tika. Hei awhina i nga kaiwhakawhanake kia tiimata, ka whakaputahia e nga kamupene he Kete Kaiwhakawhanake Pūmanawa (
SDK) kia ngawari te whakauru i tetahi karaehe, nga mahi e tika ana ranei ki nga kaupapa ka tuhia e te kaiwhakawhanake.He aha te tohu mo te Acronym XML?
Ko te XML he ingoa haangarau mo Reo TohuMaha eXtensible. XML he reo tohu e whakamahia ana hei whakawaehere raraunga i roto i te whakatakotoranga ka taea e te tangata te panui me te miihini.
Anei tetahi tauira mo te whakaatu i te XML:
<?xml putanga ="1.0"?> <hua id ="1"> Hua A Ko te hua tuatahi 5.00 ia
He aha te tohu mo te Acronym JSON?
JSON he ingoa haangarau mo Whakaatu Ahanoa Ahanoa. JSON he whakatakotoranga mo te hanganga raraunga ka tukuna atu ma te API. He rereke a JSON ki te XML. Ko nga REST API te nuinga o te whakautu ki a JSON – he whakatakotoranga paerewa tuwhera e whakamahi ana i nga tuhinga ka taea e te tangata te panui ki te tuku i nga taonga raraunga kei roto nga takirua huanga-uara.
Anei tetahi tauira o nga raraunga i runga ake nei ma te whakamahi i te JSON:
{ "id": 1, "Taitara": "Hua A", "whakaahuatanga": "Te hua tuatahi", "utu": { "moni": "5.00", "ia": "ia" } }
He aha te tohu o te REST Acronym?
te okiokinga he acronym mo te Whakawhitinga Whakawhiti Whenua te ahua hoahoanga mo nga punaha papaahuri tohatoha.
Aue… manawa hohonu! Ka taea e koe te panui i te katoa tuhinga roa i konei, i huaina ko nga Waahanga Hoahoanga me te Hoahoanga o te Hoahoahoahoahoahoahoaho Rahoahoahoahoahoahoahoahoaho i tukuna kia pai ai te whakatau i nga whakaritenga mo te tohu DOCTOR OF PHILOSOPHY i nga korero me te Pūtaiao Rorohiko na Roy Thomas Fielding.
Nga mihi, Dr. Fielding!
He aha te tohu mo te AAPONUI SOAP?
SOAP he acronym mo Kawa Uru Ahanoa Maamaa
Ehara ahau i te hötaka, engari ki taku whakaaro, ko nga kaiwhakawhanake e aroha ana ki a SOAP ka mahi pera na te mea ka taea e ratou te hanga waehere i roto i te atanga hotaka paerewa e panui ana i te Te Reo Whakamarama Ratonga Tukutuku (wsdl) kōnae. Kaore e hiahia ana ratou ki te poroporoaki i te whakautu, kua oti kee te whakamahi i te WSDL. Ko te SOAP e hiahia ana he envelopu hotaka, e whakaatu ana i te hanganga karere me pehea te tukatuka, he huinga ture whakawaehere mo te whakaatu i nga tauira o nga momo raraunga kua tautuhia e te tono, me tetahi tikanga hei tohu i nga waea me nga whakautu.