Рекламни технологииАнализ и тестванеContent MarketingCRM и платформи за данниЕлектронна търговия и търговия на дребноИмейл маркетинг и автоматизацияВидео маркетинг и продажбиМобилен и таблетен маркетингРазрешаване на продажбиМаркетинг за търсенеСоциални медии и влиятелен маркетинг

Какво е API? И други акроними: REST, SOAP, XML, JSON, WSDL

Когато използвате браузър, вашият браузър прави заявки от сървъра на клиента и сървърът изпраща обратно данни, които вашият браузър събира и показва уеб страница с тях. Но какво ще стане, ако просто искате сървърът или уеб страницата ви да говорят с друг сървър? Това ще изисква да програмирате към API.

Какво означава API?

API е съкращение от Application Programming Interface (API). API е набор от процедури, протоколи и инструменти за изграждане на уеб-активирани и мобилни приложения. API указва как можете да удостоверявате (по избор), да изисквате и получавате данни от API сървъра.

Какво е API?

Когато се използва в контекста на уеб разработката, API обикновено е дефиниран набор от протокол за прехвърляне на хипертекст (HTTP) съобщения за заявки, заедно с дефиниция на структурата на съобщенията за отговор. Уеб API позволяват комбинирането на множество услуги в нови приложения, известни като mashups.

Уикипедия

Нека дадем прост пример. Ако използвате програма за съкращаване на връзки, за да разпространявате дълга URL по-лесно по-добре, може да използвате услуга като Bit.ly. Вие въвеждате дългия URL адрес, изпращате URL адреса и Bit.ly отговаря с краткия URL адрес.

Ами ако искате да използвате Bit.ly в обхвата на платформа, която използвате? Може би сте създали програма за създаване на QR кодове онлайн, но искате първо дългите URL адреси да бъдат съкратени. В този случай бихте могли да програмирате сайта си да изпрати заявката до Bit.ly API и след това да улови отговора, за да създаде вашия QR код.

Процесът е автоматизиран с API, където не се изисква човешка намеса. Това е възможността, която API предоставят на всяка организация. API подпомагат системите при синхронизиране на данни, обработка на заявки и автоматизиране на процеси, които обикновено се извършват ръчно.

Ако една платформа има стабилен API, това означава, че можете както да интегрирате, така и да автоматизирате – спестявайки ръчно време, подобрявайки възможностите в реално време на вашите платформи и гарантирайки подобрена точност – избягвайки проблеми с ръчното въвеждане на данни.

Видео за това как работят API

Ако сте разработчик на платформа, API също предлагат възможността да отделите потребителския си интерфейс от изчисленията и заявките към базата данни. Защо това е важно? Докато разработвате своя потребителски интерфейс, можете да използвате същите API, които публикувате за други трети страни. Можете да пренапишете вашия потребителски интерфейс, без да се притеснявате за прекъсване на интеграцията в задния край.

Как да намерите наличните API

Търсите ли API за конкретен продукт или услуга? Ето някои ресурси, които изброяват API, които можете да използвате лично и комерсиално:

Списък с API RapidAPI

Как да тествате API

API е просто HTTP заявка, подобно на браузър. Разликата е, че API често изисква някакъв метод за удостоверяване, за да направи заявката. Ако не е необходимо удостоверяване, можете дори да поискате, като поставите URL адреса на заявката в браузър. Ето пример за заявка до API за времето с отворен код.

Използвайки OSX, можете да използвате къдрица команда в терминален прозорец. При изпълнение на командата, cURL ще направи GET заявка към предоставения API URL адрес и отговорът, съдържащ данните за прогнозата за времето, ще бъде показан в терминала.

curl "https://api.open-meteo.com/v1/forecast?latitude=52.52&longitude=13.41&current_weather=true&hourly=temperature_2m,relativehumidity_2m,windspeed_10m"

В Windows можете да инсталирате curl и го добавете към PATH на системата, за да работи командата. Като алтернатива можете да използвате трета страна curl изпълними файлове за Windows, като напр cURL за Windows or curl за Windows от Winamp и изпълнете командата curl по подобен начин.

Ето някои допълнителни езици и как можете да направите заявка за API:

  • питон: - requests библиотека обикновено се използва за правене на HTTP заявки в Python. Ето един пример:
import requests

response = requests.get('https://example.com')
print(response.text)
  • JavaScript (Node.js): - axios библиотеката е широко използван HTTP клиент за Node.js. Ето един пример:
const axios = require('axios');

axios.get('https://example.com')
   .then(response => {
      console.log(response.data);
   })
   .catch(error => {
      console.error(error);
 });
  • JQuery: Използвайте $.ajax or $.get функции за правене на HTTP заявки. Ето пример за правене на GET заявка с помощта на $.ajax в jQuery:
$.ajax({
  url: 'https://example.com',
  method: 'GET',
  success: function(response) {
    console.log(response);
  },
  error: function(error) {
    console.error(error);
  }
});
  • Рубин: Стандартната библиотека на Ruby включва net/http модул за правене на HTTP заявки. Ето един пример:
require 'net/http'
require 'uri'

uri = URI.parse('https://example.com')
response = Net::HTTP.get_response(uri)
puts response.body
  • Java: Java предоставя различни библиотеки и рамки за правене на HTTP заявки, като напр HttpURLConnection (в стандартната библиотека), Apache HttpClient или OkHttp. Ето един пример за използване HttpURLConnection:
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# или ASP.NET: Използвайте HttpClient клас за правене на HTTP заявки. Ето пример за това как да направите GET заявка с помощта на HttpClient в 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);
        }
    }
}

Не забравяйте да добавите необходимото using изявления и обработват изключенията по подходящ начин, когато работят с HttpClient във вашето ASP.NET или C# приложение.

  • WordPress: API на WordPress има свои собствени функции wp_remote_get or wp_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);
}

Тези примери демонстрират как да изпълните основна GET заявка, но тези библиотеки обикновено поддържат различни HTTP методи (GET, POST и т.н.) и предоставят опции за задаване на заглавки, изпращане на полезни товари на заявка и обработка на отговорите по по-усъвършенстван начин.

Не забравяйте да инсталирате всички необходими зависимости или библиотеки за вашия език за програмиране, преди да изпълните примерите за код.

Talend има страхотно приложение за Chrome за взаимодействие с API и виждане на техните отговори, ако искате да тествате API, без да пишете ред код.

Добавете Talend's API Tester към Chrome

Какво означава съкращението SDK?

SDK е съкращение от Комплект за разработчици на софтуер.

Когато дадена компания публикува своя API, обикновено има придружаваща документация, показваща как API удостоверява, как може да се прави заявка и подходящите отговори. За да помогнат на разработчиците да започнат напред, компаниите често публикуват комплект за разработчици на софтуер (

SDK) за лесно включване на клас или необходимите функции в проекти, които разработчикът пише.

Какво означава съкращението XML?

XML е съкращение от Разширяем език за маркиране. XML е език за маркиране, използван за кодиране на данни във формат, който е четим както от хора, така и от машини.

Ето пример за това как се появява XML:

<?xml версия ="1.0"?>
<продукт J ="1">
Продукт A
Първият продукт

5.00
всеки

Какво означава съкращението JSON?

JSON е съкращение от Описанието на обекта на JavaScriptJSON е формат за структуриране на данни, които се изпращат напред-назад чрез API. JSON е алтернатива на XML. REST API по-често отговарят с JSON – отворен стандартен формат, който използва четим от човека текст за предаване на обекти с данни, състоящи се от двойки атрибут-стойност.

Ето пример за данните по-горе, използвайки JSON:

{
"документ за самоличност": 1,
"заглавие": "Продукт А",
"описание": "Първият продукт",
"цена": {
"количество": "5.00",
"на": "всеки"
}
}

Какво означава съкращението REST?

ПОЧИВКА е акроним за Представителен държавен трансфер архитектурен стил за разпределени хипермедийни системи.

Ууу… дълбоко вдишване! Можете да прочетете цялото дисертация тук, наречени Архитектурни стилове и Дизайн на мрежово базирани софтуерни архитектури, представени с частично удовлетворяване на изискванията за степен ДОКТОР НА ФИЛОСОФИЯТА в Информацията и компютърните науки от Рой Томас Филдинг.

Благодаря, д-р Филдинг!

Какво означава съкращението SOAP?

SOAP е съкращение за Прост протокол за достъп до обекти

Не съм програмист, но според мен разработчиците, които обичат SOAP, го правят, защото могат лесно да разработят код в стандартен програмен интерфейс, който чете Език за дефиниране на уеб услуги (wsdl) файл. Те не трябва да анализират отговора, той вече е направен с помощта на WSDL. SOAP изисква програмна обвивка, която определя структурата на съобщението и как да се обработва, набор от правила за кодиране за изразяване на екземпляри на дефинирани от приложението типове данни и конвенция за представяне на извиквания на процедури и отговори.

Douglas Karr

Douglas Karr е CMO на OpenINSIGHTS и основателят на Martech Zone. Дъглас е помогнал на десетки успешни стартъпи на MarTech, съдействал е за надлежна проверка на над $5 милиарда в придобивания и инвестиции на Martech и продължава да помага на компаниите при прилагането и автоматизирането на техните стратегии за продажби и маркетинг. Дъглас е международно признат експерт и лектор по дигитална трансформация и MarTech. Дъглас също е публикуван автор на ръководство за манекени и книга за бизнес лидерство.

Свързани статии

Бутон "Нагоре" горе
Близо

Открит е рекламен блок

Martech Zone е в състояние да ви предостави това съдържание безплатно, тъй като осигуряваме приходи от нашия сайт чрез приходи от реклами, партньорски връзки и спонсорство. Ще сме благодарни, ако премахнете блокера си за реклами, докато разглеждате нашия сайт.