SMSPort Docs

Public API docs

Przegląd publicznego GraphQL

SMSPort udostępnia GraphQL jako oficjalny interfejs kliencki. Używaj go do uwierzytelniania, wysyłania SMS-ów i odczytu statusów urządzeń oraz wiadomości.

Co jest publiczne?

Publiczna dokumentacja pokazuje tylko ścieżkę klienta: OAuth, GraphQL i przykłady integracji. Przyłączone urządzenia i prywatne REST API pozostają wewnętrzne.

Typowy przepływ

  1. Utwórz integrację OAuth w konsoli.
  2. Zamień klient ID / secret na access token.
  3. Odczytaj workspaces i skopiuj id wybranego workspace.
  4. Pobierz urządzenia przez node(id: $workspaceId) { ... on Workspace { devices } } i skopiuj id telefonu.
  5. Wyślij mutację message_create z input.deviceId, własnym numerem odbiorcy i treścią.
  6. Sprawdź errors i odczytaj status wiadomości z node(id: $workspaceId) { ... on Workspace { messages } }.

Do tego przepływu token integracji wymaga smsport/devices.read, smsport/messages.send i smsport/messages.read. Mutacja wysyła prawdziwe SMS-y i zużywa kredyty.

Przykład żądania

curl -X POST "https://api.smsport.app/graphql" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  --data '{
  "query": "query Workspaces($after: String) {\n  workspaces(first: 20, after: $after) {\n    nodes { id displayName status }\n    pageInfo { hasNextPage endCursor }\n  }\n}",
  "variables": {}
}'

Dalsze kroki