Format Standar OpenCollection YAML

Standar OpenCollection YAML

CAPost menyimpan seluruh workspace Anda menggunakan format YAML standar dan human-readable. File YAML ini dapat dengan mudah diversion-control menggunakan Git dan dijalankan di pipeline CI/CD.

Skema Standar OpenCollection

openCollection: "1.2"
metadata:
  name: "E-commerce REST API"
  author: "cecep-azhar"
  
environments:
  - name: "Staging"
    variables:
      - key: "BASE_URL"
        value: "https://staging-api.example.com"

items:
  - name: "Order Management"
    type: "folder"
    items:
      - name: "Create Order"
        request:
          method: "POST"
          url: "{{BASE_URL}}/v1/orders"
          headers:
            - name: "Authorization"
              value: "Bearer {{API_TOKEN}}"
            - name: "Content-Type"
              value: "application/json"
          body:
            type: "json"
            raw: |
              {
                "item_id": "{{product_sku}}",
                "quantity": 2
              }
          tests:
            - description: "Verifikasi keberhasilan pembuatan pesanan"
              expression: "postman.getResponseCode() === 201"
            - description: "Validasi bentuk payload pesanan"
              type: "json-schema"
              schema: |
                {
                  "type": "object",
                  "properties": {
                    "data": { "type": "string" }
                  }
                }

Pemakaian di Git / Versioning

• Pisahkan Rahasia: Taruh file YAML standar di Git, namun simpan rahasia API yang sebenarnya di brankas terenkripsi.
• Ekspansi Koleksi: Pecah koleksi besar menjadi beberapa file YAML sub-folder di repository Git.