Interfejs OpenAPI

OpenAPI to do opisywania interfejsów API typu REST. Zastosowanie specyfikacja OpenAPI 2.0, możesz tworzyć dokumenty OpenAPI dla Business Messages i Business interfejsów API do komunikacji, aby opisać ich strukturę.

Dzięki temu możesz:

• Utwórz biblioteki klienta w wybranym języku
• Utwórz atrapy serwera
• Korzystanie z narzędzi do zarządzania interfejsami API

Podstawowa struktura dokumentu OpenAPI

Dokument OpenAPI opisujący powierzchnię interfejsu API REST. Dokument określa nazwę i opis interfejsu API, poszczególne punkty końcowe (ścieżki) API, sposób uwierzytelniania rozmówców i nie tylko.

Kliknij poniżej, aby zobaczyć przykład tej podstawowej struktury.

JSON

    {
      "swagger": "2.0",
      "host": "businessmessages.googleapis.com",
      "info": {
        "title": "Business Messages API",
        "description": "",
        "version": "v1"
      },
      "paths": {
        "/v1/conversations/{conversationsId}/messages": {
          "post": {
            "description": "Sends a message from an agent to a user.",
            "parameters": [
              {
                "description": "Part of `parent`. Required. The conversation that contains the message. Resolves to \"conversations/{conversationId}\".",
                "type": "string",
                "in": "path",
                "required": true,
                "name": "conversationsId"
              },
              {
                "description": "Optional. A flag to send the specified fallback text instead of other message content.",
                "name": "forceFallback",
                "type": "boolean",
                "in": "query"
              },
              {
                "name": "message",
                "schema": {
                  "$ref": "#/definitions/BusinessMessagesMessage"
                },
                "in": "body",
                "description": "Required. The content of a message."
              }
            ],
            "tags": [
              "businessmessages"
            ],
            "operationId": "CreateMessage",
            "responses": {
              "default": {
                "schema": {
                  "$ref": "#/definitions/BusinessMessagesMessage"
                },
                "description": "Successful operation"
              }
            }
          }
        }
      }
    }
    

Więcej informacji o strukturze dokumentu OpenAPI znajdziesz tutaj: Strona Swagger.

Jak uzyskać dostęp do dokumentów OpenAPI

Aby uzyskać dostęp do dokumentów OpenAPI, musisz mieć klucz interfejsu API z Google Cloud Projekt platformy (GCP) z funkcjami Business Messages i komunikacji biznesowej Włączono interfejsy API.

W sekcjach poniżej dowiesz się,

• utworzyć projekt GCP
• utworzenie klucza API
• włączyć interfejsy Business Messages API i Business Communications API

Po wykonaniu tych czynności możesz uzyskać dostęp do dokumentów OpenAPI.

Tworzenie projektu GCP

Jeśli masz już projekt GCP, możesz go użyć do utworzenia klucza interfejsu API.

Aby utworzyć nowy projekt GCP:

1. Otwórz stronę Zarządzanie zasobami. w konsoli GCP.
2. Na liście Wybierz organizację u góry strony wybierz organizację, dla której chcesz utworzyć projekt. Jeśli korzystasz z bezpłatnego okresu próbnego, pomiń ten krok.
3. Kliknij Utwórz projekt.
4. W oknie New Project (Nowy projekt) wpisz nazwę projektu i wybierz konto rozliczeniowe. Nazwa projektu może zawierać tylko litery, cyfry, pojedyncze cudzysłowów, łączników, spacji lub wykrzykników i muszą mieć od 4 do 30 znaków.

5. W polu Lokalizacja wpisz nadrzędną organizację lub folder nowego projektu.

6. Kliknij Utwórz.

Tworzenie klucza interfejsu API

1. Przejdź do Strona Dane logowania w konsoli GCP.

2. Kliknij kolejno Utwórz dane logowania i Klucz interfejsu API.

   W oknie Utworzono klucz interfejsu API wyświetli się nowo utworzony klucz. Skopiuj klucz i przechowuj go w bezpiecznym miejscu. Aby dowiedzieć się więcej o kluczach interfejsu API, zapoznaj się z dokumentacji klucza interfejsu API.

Włączanie interfejsów Business Communications API i Business Messages API

Aby włączyć te interfejsy API w projekcie GCP, wykonaj te czynności:

1. Otwórz Interfejsy API Usługi w konsoli GCP.
2. Na liście Select project (Wybierz projekt) zaznacz w projekcie, w którym chcesz włączyć interfejsy API.
3. Kliknij Włącz interfejsy API i usługi.
4. W polu Wyszukaj interfejsy API i usługi wpisz Business Messages.
5. Wybierz Business Messages API.
6. Kliknij Włącz.
7. Kliknij Włącz interfejsy API i usługi.
8. W polu Wyszukaj interfejsy API i usługi wpisz Business Communications.
9. Wybierz Business Communications API.
10. Kliknij Włącz.

Twój klucz API ma teraz uprawnienia dostępu do dokumentów OpenAPI dla Interfejsy API Business Messages i Business Communications.

Dostęp do dokumentów OpenAPI

Aby uzyskać dostęp do dokumentu OpenAPI powiązanego z interfejsem Business Messages API, uruchom to polecenie:

curl "https://businessmessages.googleapis.com/$discovery/swagger2?version=v1&key=API_KEY"

Aby uzyskać dostęp do dokumentu OpenAPI dla interfejsu Business Communications API, uruchom to polecenie:

curl "https://businesscommunications.googleapis.com/$discovery/swagger2?version=v1&key=API_KEY"

Zastąp API_KEY swoim kluczem interfejsu API.