Kom i Gang med Connect2Print API

Forudsætninger

Før du starter skal du have:

• En aktiv Connect2Print konto
• Adgang til admin-panelet
• Grundlæggende kendskab til REST API'er
• Et udviklerværktøj som cURL, Postman eller dit foretrukne programmeringssprog

Trin 1: Opret din første API-nøgle

API-nøgler bruges til at autentificere dine anmodninger. Følg disse trin for at oprette en:

1. Log ind på dit Connect2Print admin-panel
2. Naviger til Indstillinger → API-nøgler
3. Klik på "Opret ny API-nøgle" knappen
4. Vælg Test Mode til udvikling
5. Vælg de nødvendige tilladelser (scopes):
   • orders:read - Se ordrer
   • customers:read - Se kunder
   • products:read - Se produkter
6. Klik "Gem" og kopiér din nye API-nøgle

Trin 2: Foretag din første anmodning

Lad os teste API'en ved at hente en liste over dine ordrer. Her er eksempler i forskellige sprog:

curl -X GET "https://app1.connect2print.com/api/v1/orders" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

// Using cURL in PHP
$apiKey = 'YOUR_API_KEY';
$ch = curl_init('https://app1.connect2print.com/api/v1/orders');

curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer {$apiKey}",
        'Content-Type: application/json',
    ],
]);

$response = curl_exec($ch);
$data = json_decode($response, true);

curl_close($ch);
print_r($data);

// Using fetch in Node.js
const apiKey = 'YOUR_API_KEY';

const response = await fetch('https://app1.connect2print.com/api/v1/orders', {
  method: 'GET',
  headers: {
    'Authorization': `Bearer ${apiKey}`,
    'Content-Type': 'application/json'
  }
});

const data = await response.json();
console.log(data);

# Using requests library
import requests

api_key = 'YOUR_API_KEY'
url = 'https://app1.connect2print.com/api/v1/orders'

headers = {
    'Authorization': f'Bearer {api_key}',
    'Content-Type': 'application/json'
}

response = requests.get(url, headers=headers)
data = response.json()

print(data)

Trin 3: Forstå svaret

Alle API-svar følger en konsistent struktur:

Succesfuldt svar

Et succesfuldt svar indeholder:

• success: true - Anmodningen lykkedes
• data - Den returnerede data (array eller objekt)
• meta - Metadata (pagination, totaler, etc.)

{
  "success": true,
  "data": [
    {
      "id": 123,
      "order_number": "ORD-2024-001",
      "status": "processing",
      "total": 499.00,
      "created_at": "2024-01-15T10:30:00Z"
    }
  ],
  "meta": {
    "current_page": 1,
    "per_page": 20,
    "total": 1,
    "total_pages": 1
  }
}

Fejlsvar

Hvis noget går galt, får du:

• success: false - Anmodningen fejlede
• error.code - Maskine-læsbar fejlkode
• error.message - Menneske-læsbar fejlbesked

{
  "success": false,
  "error": {
    "code": "unauthorized",
    "message": "Invalid API key"
  }
}

Trin 4: Håndter pagination

Liste-endpoints returnerer data i sider. Brug disse parametre til at navigere:

• page - Sidenummer (standard: 1)
• per_page - Elementer pr. side (standard: 20, maks: 100)

Eksempel med pagination

curl -X GET "https://app1.connect2print.com/api/v1/orders?page=2&per_page=50" \
  -H "Authorization: Bearer YOUR_API_KEY"

Pagination metadata

Svaret inkluderer pagination-information i meta objektet:

"meta": {
  "current_page": 2,
  "per_page": 50,
  "total": 347,
  "total_pages": 7
}

Næste Trin

Nu hvor du har foretaget din første API-anmodning, er du klar til at udforske mere: