Developers

Developer Platform

REST API, webhook, kimlik doğrulama ve SDK örnekleriyle güvenli entegrasyon geliştirin.

Demo Talep Et Integrations WhatsApp

Capabilities

Geliştirici yapı taşları

REST API

HTTPS üzerinden JSON REST uç noktalarıyla tenant güvenli entegrasyon.

Webhook

Sipariş ve ödeme olaylarını imzalı HTTPS endpoint’lerinize iletin.

OAuth

Delegated erişim senaryoları için OAuth tabanlı yetkilendirme modeli.

Authentication

API anahtarı ve sunucu tarafı kimlik doğrulama pratikleri.

API Keys

Ortam bazlı anahtar üretimi, rotasyon ve yetki sınırları.

Rate Limits

Plan ve güvenlik politikasına göre istek sınırları.

SDK

Popüler dillerde örnek istemci kalıpları ve entegrasyon iskeleti.

Postman Collection

Keşif ve test için Postman koleksiyonu talebi / dokümantasyon akışı.

API Explorer

Uç nokta keşfi ve örnek istek/yanıt incelemesi.

Error Codes

Standart hata kodları, retry ve idempotency rehberi.

Release Notes

API ve platform sürüm notları.

SDK

Dil örnekleri

Örnek istek kalıpları — anahtarları yalnızca sunucu tarafında kullanın.

Node.js

const res = await fetch('https://api.gpsposplus.com/v1/orders', {
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
});
const data = await res.json();

PHP

$ch = curl_init('https://api.gpsposplus.com/v1/orders');
curl_setopt_array($ch, [
  CURLOPT_HTTPHEADER => [
    'Authorization: Bearer YOUR_API_KEY',
    'Content-Type: application/json',
  ],
  CURLOPT_RETURNTRANSFER => true,
]);
$response = curl_exec($ch);

.NET

using var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "Bearer YOUR_API_KEY");
var json = await client.GetStringAsync("https://api.gpsposplus.com/v1/orders");

Python

import requests

r = requests.get(
    "https://api.gpsposplus.com/v1/orders",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    timeout=30,
)
data = r.json()

Java

HttpRequest request = HttpRequest.newBuilder()
  .uri(URI.create("https://api.gpsposplus.com/v1/orders"))
  .header("Authorization", "Bearer YOUR_API_KEY")
  .GET()
  .build();
HttpResponse<String> response = client.send(request, BodyHandlers.ofString());

Webhook

İmza doğrulamalı alıcı örneği

Node.js Webhook

app.post('/webhooks/gpspos', express.raw({ type: '*/*' }), (req, res) => {
  const signature = req.get('x-gpspos-signature');
  if (!verifySignature(req.body, signature, process.env.WEBHOOK_SECRET)) {
    return res.status(401).send('invalid signature');
  }
  const event = JSON.parse(req.body.toString('utf8'));
  // handle event.type
  res.status(200).send('ok');
});

Daha fazla güvenlik bağlamı için Trust Center ve Webhook yardımı sayfalarına bakın.

Developer FAQ

Sık sorulan sorular

API anahtarı nerede tutulmalı?

API anahtarlarını tarayıcı veya mobil istemciye gömmeyin. Sunucu tarafında ortam değişkeni olarak saklayın ve düzenli rotasyon uygulayın.

Webhook imzası nasıl doğrulanır?

Gelen isteğin ham gövdesi üzerinden imza hesaplanır. JSON parse edip yeniden stringify etmek imzayı bozabilir.

Rate limit aşılırsa ne olur?

Limit aşımlarında HTTP 429 benzeri yanıtlar döner. Exponential backoff ve idempotent yazma önerilir.

Sandbox nasıl alınır?

Developer erişimi ve sandbox talebi için demo formu veya destek kanalından enterprise developer görüşmesi planlanır.

API erişimi talep edin

Sandbox, Postman koleksiyonu ve production anahtar süreçleri için developer görüşmesi planlayın.

Demo Talep Et Release Notes WhatsApp